summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-06-23 23:43:36 +0000
committerKarl Berry <karl@freefriends.org>2013-06-23 23:43:36 +0000
commit3f214aab9775b3253253bc72fa7a58a0278206d4 (patch)
tree95424a0f9a874d042df4d3762e2a677ea15b010b /Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
parent0ade4baaa2b1857abfa6b1385ca4a72b9c68a08b (diff)
tcolorbox (23jun13)
git-svn-id: svn://tug.org/texlive/trunk@30869 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex574
1 files changed, 559 insertions, 15 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
index 0bfdac01ef9..2be4be9a13b 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
@@ -596,7 +596,7 @@ This example uses a public domain picture from\\
\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries}
\begin{tcolorbox}[enhanced,title=My title,
- watermark tikz={\draw[line width=2mm] (interior) circle (1cm)
+ watermark tikz={\draw[line width=2mm] circle (1cm)
node{\fontfamily{ptm}\fontseries{b}\fontsize{20mm}{20mm}\selectfont ?};}]
\lipsum[1]
\tcblower
@@ -650,15 +650,15 @@ This example uses a public domain picture from\\
\enlargethispage{5mm}
\begin{docTcbKey}{watermark zoom}{=\meta{fraction}}{no default, initially |0.75|}
Sets the zoom value for a watermark. The zoom respects the aspect ratio.
- The value $1.0$ means to fill the whole box.
+ The value $1.0$ means to fill the whole box until the watermark touches the frame.
\begin{dispExample}
\tcbset{enhanced,colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,
watermark text=Watermark,nobeforeafter,width=(\linewidth-2mm)/2}
-\begin{tcolorbox}[title=Zoom 1.00,watermark zoom=1.00]
+\begin{tcolorbox}[title=Zoom 1.0,watermark zoom=1.0]
\lipsum[2]
\end{tcolorbox}\hfill%
-\begin{tcolorbox}[title=Zoom 0.50,watermark zoom=0.50]
+\begin{tcolorbox}[title=Zoom 0.5,watermark zoom=0.5]
\lipsum[2]
\end{tcolorbox}%
\end{dispExample}
@@ -666,13 +666,40 @@ This example uses a public domain picture from\\
\clearpage
+\begin{docTcbKey}{watermark overzoom}{=\meta{fraction}}{no default, initially unset}
+ Sets the overzoom value for a watermark. The overzoom respects the aspect ratio.
+ The value $1.0$ means to fill the whole box until the watermark touches
+ all four sides of the frame.
+\begin{dispExample}
+\tcbset{enhanced,colback=white,colframe=blue!50!black,fonttitle=\bfseries,
+ watermark opacity=0.5,
+ watermark graphics=lichtspiel.jpg,nobeforeafter,width=(\linewidth-2mm)/2}
+
+\begin{tcolorbox}[title=Zoom 1.0,watermark zoom=1.0]
+\lipsum[1]
+\end{tcolorbox}\hfill%
+\begin{tcolorbox}[title=Overzoom 1.0,watermark overzoom=1.0]
+\lipsum[1]
+\end{tcolorbox}%
+\end{dispExample}
+\end{docTcbKey}
+
+\begin{marker}
+If a \refKey{/tcb/watermark overzoom} value of |1.0| is used in connection
+with invisible top and bottom rules which still have a thickness greater than |0pt|,
+the space of these invisible rules may not be covered by the watermark.
+For example, this situation may occur during the breaking of \refKey{/tcb/enhanced} boxes.
+To avoid this optical glitch, just set \refKey{/tcb/pad at break} to any desired value.
+\end{marker}
+
+\clearpage
\begin{docTcbKey}{watermark stretch}{=\meta{fraction}}{no default, initially unset}
Sets the stretch value for a watermark. The stretch value is applied to width
and height in relation to the box dimensions. It does not respect the aspect ratio.
The value $1.0$ means to fill the whole box.
\begin{dispExample}
-\tcbset{enhanced,colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,
- watermark graphics=Basilica_5.png,watermark opacity=0.15,
+\tcbset{enhanced,colback=white,colframe=blue!50!black,fonttitle=\bfseries,
+ watermark graphics=lichtspiel.jpg,watermark opacity=0.5,
nobeforeafter,width=(\linewidth-2mm)/2}
\begin{tcolorbox}[title=Stretch 1.00,watermark stretch=1.00]
@@ -696,6 +723,476 @@ This example uses a public domain picture from\\
\end{dispExample}
\end{docTcbKey}
+\clearpage
+
+\begin{docTcbKey}{clip watermark}{\colOpt{=\meta{boolean value}}}{default |true|, initially |true|}
+ Sets the watermark to be clipped to the interior area.
+\begin{dispExample}
+\tcbset{enhanced,colback=white,colframe=blue!50!white,fonttitle=\bfseries,
+ watermark opacity=0.5,watermark stretch=1.00,arc=3mm,
+ watermark graphics=lichtspiel.jpg}
+
+\begin{tcolorbox}[title=Clip (default),clip watermark]
+\lipsum[1]
+\end{tcolorbox}
+
+\begin{tcolorbox}[title=No clip,clip watermark=false]
+\lipsum[1]
+\end{tcolorbox}%
+\end{dispExample}
+\end{docTcbKey}
+
+
+
+\clearpage
+\subsection{Clip Environments}\label{subsec:clipping}
+The following clip environments are applicable for all skins which
+use engines of type |path|, |pathfirst|, |pathmiddle|, or |pathlast|.
+Especially, the skin \refSkin{enhanced} supports \emph{all} of them
+and \refSkin{standard} \emph{none}. The typical area of application
+is inside overlay code, see Section \ref{subsec:overlays} from
+page \pageref{subsec:overlays}.
+
+
+\begin{docEnvironment}{tcbclipframe}{}
+Defines a |Tikz| scope which clips to the frame area path.
+\begin{dispExample}
+\makeatletter
+\newtcolorbox{picturebox}[2][]{%
+ enhanced,frame hidden,interior hidden,fonttitle=\bfseries,
+ overlay={\begin{tcbclipframe}\node at (frame)
+ {\includegraphics[width=\tcb@width,height=\tcb@height]{#2}};\end{tcbclipframe}%
+ \begin{tcbclipinterior}\fill[white,opacity=0.75]
+ (frame.south west) rectangle (frame.north east);\end{tcbclipinterior}},#1}
+\makeatother
+
+\begin{picturebox}[title=My Picture Box]{lichtspiel.jpg}
+\lipsum[1]
+\end{picturebox}
+\end{dispExample}
+\end{docEnvironment}
+
+\clearpage
+\begin{docEnvironment}{tcbclipinterior}{}
+Defines a |Tikz| scope which clips to the interior area path.
+\begin{dispExample}
+\begin{tcolorbox}[enhanced,title=My Title,
+ overlay={\begin{tcbclipinterior}
+ \draw[red,line width=1cm] (interior.north west)--(interior.south east);
+ \draw[red,line width=1cm] (interior.south west)--(interior.north east);
+ \end{tcbclipinterior}}]
+\lipsum[1]
+\end{tcolorbox}
+\end{dispExample}
+\end{docEnvironment}
+
+\begin{docEnvironment}{tcbcliptitle}{}
+Defines a |Tikz| scope which clips to the title area path.
+\begin{dispExample}
+\begin{tcolorbox}[enhanced,title=My Title,colframe=blue,colback=yellow!10!white,
+ overlay={\begin{tcbcliptitle}\node at (title)
+ {\includegraphics[width=\linewidth]{lichtspiel.jpg}};\end{tcbcliptitle}}]
+\lipsum[1]
+\end{tcolorbox}
+\end{dispExample}
+\end{docEnvironment}
+
+\clearpage
+\begin{docTcbKey}{clip title}{\colOpt{=\meta{boolean value}}}{default |true|, initially |false|}
+ Sets the title to be clipped to the title area.
+\begin{dispExample}
+\tcbset{enhanced,width=5cm,colframe=red!50!white,coltitle=black}
+
+\begin{tcolorbox}[title=\mbox{This is a title which is unbreakable and far too long}]
+This is a tcolorbox.
+\end{tcolorbox}
+
+\begin{tcolorbox}[title=\mbox{This is a title which is unbreakable and far too long},
+ clip title]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{clip upper}{\colOpt{=\meta{boolean value}}}{default |true|, initially |false|}
+ Sets the upper part to be clipped to the interior area.
+\begin{dispExample}
+\newcommand{\mygraphics}[2][]{%
+ \tcbox[enhanced,boxsep=0pt,top=0pt,bottom=0pt,left=0pt,
+ right=0pt,boxrule=0.4pt,drop fuzzy shadow,clip upper,
+ colback=black!75!white,toptitle=2pt,bottomtitle=2pt,nobeforeafter,
+ center title,fonttitle=\small\sffamily,title=\detokenize{#2}]
+ {\includegraphics[width=\the\dimexpr(\linewidth-4mm)/2\relax]{#2}}}
+
+\mygraphics{lichtspiel.jpg}\hfill
+\mygraphics{Basilica_5.png}
+\end{dispExample}
+\end{docTcbKey}
+
+\clearpage
+The example for \refKey{/tcb/clip upper} sizes the box according to
+the dimensions of the picture. To do it the other way around, the watermark
+options provide an easy solution.
+\begin{dispExample}
+\newcommand{\mygraphics}[2][]{%
+ \tcbox[enhanced,capture=minipage,boxsep=0pt,top=0pt,bottom=0pt,left=0pt,
+ right=0pt,boxrule=0.4pt,drop fuzzy shadow,nobeforeafter,
+ colback=black!75!white,toptitle=2pt,bottomtitle=2pt,
+ center title,fonttitle=\small\sffamily,title=\detokenize{#2},
+ width=(\linewidth-4mm)/2,height=6cm,colbacktitle={black},
+ watermark zoom=1.0,watermark graphics={#2}]{}}
+
+\mygraphics{lichtspiel.jpg}\hfill
+\mygraphics{Basilica_5.png}
+\end{dispExample}
+
+
+\begin{docTcbKey}{clip lower}{\colOpt{=\meta{boolean value}}}{default |true|, initially |false|}
+ Sets the lower part to be clipped to the interior area.
+\begin{dispExample}
+\tcbset{enhanced,width=5cm,colframe=red!50!black,text and listing}
+
+\begin{tcblisting}{}
+Donau\-dampf\-schiff\-fahrts\-ka\-pi\-t\"ans\-m\"ut\-zen\-fran\-sen
+\end{tcblisting}
+
+\begin{tcblisting}{clip lower}
+Donau\-dampf\-schiff\-fahrts\-ka\-pi\-t\"ans\-m\"ut\-zen\-fran\-sen
+\end{tcblisting}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\clearpage
+\subsection{Border Line Option Keys}\label{subsec:borderline}
+The following border line options are applicable for most skins which
+use |tikzpicture| as \refKey{/tcb/graphical environment}.
+Therefore, the skin \refSkin{standard} does not support these border lines,
+but most other skins, e.\,g.\ \refSkin{enhanced}.
+
+The border lines are independent from the normal |tcolorbox| rules.
+They may be used with or without the \refKey{/tcb/segmentation engine}.
+
+The border lines are stackable, i.\,e.\ several different border lines can be
+used on the same |tcolorbox|. They are drawn \emph{after} the box frame and box
+interior and \emph{before} overlays or watermarks.
+
+\begin{marker}
+Technically, the normal |tcolorbox| rules result from a TikZ \emph{filling}
+process. The border lines are created by a TikZ \emph{drawing} process.
+This can be used to apply different effects.
+\end{marker}
+
+
+\begin{docTcbKey}{borderline}{=\marg{width}\marg{offset}\marg{options}}{no default, initially unset}
+ Adds a new border line to the stack of border lines.
+ This border line is drawn with the given \meta{width} and gets a
+ \meta{offset} computed from the frame outline. A positive \meta{offset} value
+ moves the borderline inside the |tcolorbox| and a negative \meta{offset} value
+ moves it outside without changing the bounding box.\\
+ The border line is drawn along a TikZ path with the given TikZ \meta{options}.
+ Note that the TikZ |line width| option should not be used here.\\
+ The border lines adapt to the rounded corners of the |tcolorbox|. An inside border
+ line will switch to sharp corners if necessary, an outside border line will
+ always be rounded if not set to |sharp corners|.
+\begin{dispExample}
+\begin{tcolorbox}[enhanced,title=Rounded corners,fonttitle=\bfseries,boxsep=5pt,
+ arc=8pt,
+ borderline={0.5pt}{0pt}{red},
+ borderline={0.5pt}{5pt}{blue,dotted},
+ borderline={0.5pt}{-5pt}{green,dashed} ]
+This is a tcolorbox.
+\end{tcolorbox}
+\bigskip
+\begin{tcolorbox}[enhanced,title=Sharp corners,fonttitle=\bfseries,boxsep=5pt,
+ arc=0pt,outer arc=0pt,
+ borderline={0.5pt}{0pt}{red},
+ borderline={0.5pt}{5pt}{blue,dotted},
+ borderline={0.5pt}{-5pt}{green,dashed,sharp corners} ]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample}
+
+\begin{dispExample}
+% \usepackage{lipsum}
+\begin{tcolorbox}[enhanced,arc=3mm,boxrule=1.5mm,boxsep=1.5mm,
+ colback=yellow!20!white,
+ colframe=blue,
+ borderline={1mm}{1mm}{white},
+ borderline={1mm}{2mm}{red} ]
+ \lipsum[1]
+\end{tcolorbox}
+\end{dispExample}
+
+
+\begin{dispExample}
+% \usepackage{lipsum}
+\begin{tcolorbox}[enhanced,arc=3mm,boxrule=1.5mm,
+ frame hidden,colback=blue!10!white,
+ borderline={1mm}{0mm}{blue,dotted} ]
+ \lipsum[2]
+\end{tcolorbox}
+\end{dispExample}
+
+
+\begin{dispExample}
+% \usepackage{lipsum}
+\begin{tcolorbox}[enhanced,skin=enhancedmiddle,
+ frame hidden,interior hidden,top=0mm,bottom=0mm,boxsep=0mm,
+ borderline={0.75mm}{0mm}{red},
+ borderline={0.75mm}{0.75mm}{red!50!yellow},
+ borderline={0.75mm}{1.5mm}{yellow}, ]
+ \lipsum[3]
+\end{tcolorbox}
+\end{dispExample}
+
+\begin{dispExample}
+% \usepackage{lipsum}
+\newtcolorbox{mygreenbox}[2][]{%
+ enhanced,width=\linewidth-6pt,
+ enlarge top by=3pt,enlarge bottom by=3pt,
+ enlarge left by=3pt,enlarge right by=3pt,
+ title={#2},frame hidden,boxrule=0pt,top=1mm,bottom=1mm,
+ colframe=green!30!black, colbacktitle=green!50!yellow,
+ coltitle=black, colback=green!25!white,
+ borderline={0.5pt}{-0.5pt}{green!75!blue},
+ borderline={1pt}{-3pt}{green!50!blue},#1}
+
+\begin{mygreenbox}{My title}
+ \lipsum[4]
+\end{mygreenbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{no borderline}{}{no default, initially set}
+ Removes all border lines if set before.
+\end{docTcbKey}
+
+
+\clearpage
+\subsection{Shadow Option Keys}\label{subsec:shadows}
+The following shadow options are applicable for most skins which
+use |tikzpicture| as \refKey{/tcb/graphical environment}.
+Therefore, the skin \refSkin{standard} does not support these shadows,
+but most other skins, e.\,g.\ \refSkin{enhanced}.
+
+The shadows are stackable, i.\,e.\ several different shadows can be
+used on the same |tcolorbox|. They are drawn \emph{before} the box frame is drawn.
+
+
+\begin{docTcbKey}{shadow}{=\marg{xshift}\marg{yshift}\marg{offset}\marg{options}}{no default}
+ Adds a new shadow to the stack of shadows.
+ This shadow is follows the outline of the |tcolorbox| but is shifted by
+ \meta{xshift} and \meta{yshift}. The \meta{offset} value is a distance value
+ from the frame outline. A positive \meta{offset} value shrinks the shadow
+ and a negative \meta{offset} value enlarges the shadow.
+ The shadow is filled along a TikZ path with the given TikZ \meta{options}.\\
+ The shadows adapt to the rounded corners of the |tcolorbox|. An shrinked shadow
+ will switch to sharp corners if necessary, an enlarged shadow may become
+ more rounded depending on several factors.
+ \begin{marker}
+ Shadows are not considered for the bounding box computation by default.
+ Large shadows may be overlaped by the following content. But, the
+ bounding box can be adapted if necessary.
+ \end{marker}
+
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=My own shadow,
+ shadow={2mm}{-1mm}{0mm}{black!50!white}]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip
+\begin{tcolorbox}[title=Another shadow,
+ shadow={-1mm}{-2mm}{0mm}{fill=blue,
+ opacity=0.5}]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip
+\begin{tcolorbox}[title=Double shadow,
+ shadow={-1.5mm}{-1.5mm}{0mm}{fill=blue,
+ opacity=0.25},
+ shadow={1.5mm}{-1.5mm}{0mm}{fill=red,
+ opacity=0.25}]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip
+\begin{tcolorbox}[title=Far shadow,
+ shadow={5.5mm}{-3.5mm}{2mm}{fill=black,
+ opacity=0.25}]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip\bigskip
+\begin{tcolorbox}[title=Halo shadow,
+ shadow={0mm}{0mm}{-1.5mm}%
+ {fill=yellow!75!red,opacity=0.5}]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\clearpage
+\begin{docTcbKey}{fuzzy shadow}{=\marg{xshift}\marg{yshift}\marg{offset}\marg{step}\marg{options}}{no default}
+ Adds a new fuzzy shadow to the stack of shadows. Actually, this option
+ adds seversal shadows which appear like a shadow with a fuzzy border.
+ This fuzzy shadow is follows the outline of the |tcolorbox| but is shifted by
+ \meta{xshift} and \meta{yshift}. The \meta{offset} value is a distance value
+ from the frame outline. A positive \meta{offset} value shrinks the shadow
+ and a negative \meta{offset} value enlarges the shadow.
+ The \marg{step} value describes a shrink
+ offset used for the combination of the partial shadows.
+ The shadow is filled along a TikZ path with the given TikZ \meta{options} but
+ any |opacity| value will be ignored.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=My own shadow,
+ fuzzy shadow={2mm}{-1mm}{0mm}{0.1mm}%
+ {black!50!white}]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip
+\begin{tcolorbox}[title=Another shadow,
+ fuzzy shadow={-1mm}{-2mm}{0mm}{0.2mm}%
+ {fill=blue}]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip
+\begin{tcolorbox}[title=Double shadow,
+ fuzzy shadow={-1.5mm}{-1.5mm}{0mm}{0.1mm}%
+ {blue},
+ fuzzy shadow={1.5mm}{-1.5mm}{0mm}{0.1mm}%
+ {red}]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip
+\begin{tcolorbox}[title=Far shadow,
+ fuzzy shadow={5.5mm}{-3.5mm}{0mm}{0.3mm}%
+ {black}]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip\bigskip
+\begin{tcolorbox}[title=Glow shadow,
+ fuzzy shadow={0mm}{0mm}{-1.5mm}{0.15mm}%
+ {yellow!75!red}]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+
+\begin{dispExample}
+\newtcolorbox{mybox}[1][]{enhanced,
+ fuzzy shadow={1.0mm}{-1.0mm}{0.12mm}{0mm}{blue!50!white},
+ fuzzy shadow={-1.0mm}{-1.0mm}{0.12mm}{0mm}{red!50!white},
+ fuzzy shadow={-1.0mm}{1.0mm}{0.12mm}{0mm}{green!50!white},
+ fuzzy shadow={1.0mm}{1.0mm}{0.12mm}{0mm}{yellow!50!white},#1
+}
+
+\begin{mybox}[title=A multi shadow box]
+This is a tcolorbox.
+\end{mybox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\clearpage
+
+\begin{docTcbKey}{drop shadow}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+ Optionally, the \meta{color} for the shadow can be changed.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=My own shadow,
+ drop shadow]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip
+\begin{tcolorbox}[title=Another shadow,
+ drop shadow=blue]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{drop fuzzy shadow}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+ Optionally, the \meta{color} for the shadow can be changed.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=My own shadow,
+ drop fuzzy shadow]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip
+\begin{tcolorbox}[title=Another shadow,
+ drop fuzzy shadow=blue]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\clearpage
+\begin{docTcbKey}{halo}{=\meta{size} \texttt{with} \meta{color}}{style, default |0.9mm with yellow|}
+ Adds a new halo shadow with the given \meta{color}
+ which overlaps the colorbox an all sides by \meta{size}.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=My own halo,halo]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip\bigskip
+\begin{tcolorbox}[title=Another halo,
+ halo=2mm with green]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{fuzzy halo}{=\meta{size} \texttt{with} \meta{color}}{style, default |0.9mm with yellow|}
+ Adds a new fuzzy halo shadow with the given \meta{color}
+ which overlaps the colorbox an all sides by \meta{size} plus |0.48mm|.
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=My own halo,fuzzy halo]
+This is a tcolorbox.
+\end{tcolorbox}
+\par\bigskip\bigskip
+\begin{tcolorbox}[title=Another halo,
+ fuzzy halo=2mm with green]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+
+\begin{dispExample}
+\begin{tcolorbox}[blank,
+ fuzzy halo=2mm with red!50!white,
+ fuzzy halo=1mm with white,]
+\lipsum[1]
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
+
+\begin{docTcbKey}{no shadow}{}{no default}
+ Removes all shadows if set before.
+\end{docTcbKey}
+
\clearpage
@@ -759,8 +1256,9 @@ This example uses a public domain picture from\\
\end{dispExample}
+
\clearpage
-\subsection{Skin family 'enhanced'}
+\subsection{Skin Family 'enhanced'}
\begin{marker}
If you like the standard appearance of a |tcolorbox| but you want to
have some 'enhanced' features, the |enhanced| skin is what you are looking for.
@@ -835,10 +1333,9 @@ have some 'enhanced' features, the |enhanced| skin is what you are looking for.
\begin{dispExample}
-% \usetikzlibrary{shadows} % preamble
% \usetikzlibrary{decorations.pathmorphing} % preamble
\tcbset{skin=enhanced,fonttitle=\bfseries,boxrule=1mm,
- frame style={draw=FireBrick,fill=Salmon,drop shadow},
+ frame style={draw=FireBrick,fill=Salmon},drop fuzzy shadow,
interior style={draw=FireBrick,top color=Salmon!10,bottom color=Salmon!20},
segmentation style={draw=FireBrick,solid,decorate,
decoration={coil,aspect=0,segment length=10.1mm}}}
@@ -851,9 +1348,37 @@ Of course, skins can be used for listings also.
\end{tcblisting}
\end{dispExample}
+\begin{docTcbKey}{enhanced standard}{}{style, no value}
+ For unbreakable boxes, this is identical to using \refKey{/tcb/enhanced}.
+ But, for breakable boxes, the \emph{break sequence} is identical to the \refSkin{standard} skin,
+ see Section \ref{subsec:breaksequence} from page \pageref{subsec:breaksequence}.
+\end{docTcbKey}
+
+
\clearpage
+\begin{docTcbKey}{blank}{}{style, initially unset}
+ This style relies on the skin \refSkin{enhanced}. All drawing operations
+ are disabled and all margins are set to |0pt|.
+\begin{dispExample}
+\begin{tcolorbox}[blank,watermark text=A blank box]
+\lipsum[1]
+\end{tcolorbox}
+\end{dispExample}
+
+\begin{dispExample}
+% \tcbuselibrary{fitting}
+\newtcboxfit{\mybox}[1]{blank,width=4cm,height=7cm,top=4pt,
+ watermark text=#1}
+
+\begin{tabular}{|c|c|c|}\hline
+A & B & C\\\hline
+\mybox{A}{\lipsum[1]} & \mybox{B}{\lipsum[2]} & \mybox{C}{\lipsum[3]}\\\hline
+\end{tabular}
+\end{dispExample}
+\end{docTcbKey}
+\clearpage
\begin{docCommand}{tcbline}{}
Sometimes, a line is only a line. With \refCom{tcblower} you separate
the box content into two functional units. |\tcbline| draws only a line
@@ -1139,7 +1664,7 @@ Nevertheless, this skin can be applied independently.
\end{dispExample}
\clearpage
-\subsection{Skin family 'bicolor'}
+\subsection{Skin Family 'bicolor'}
\begin{docSkin}{bicolor}
This skin is quite similar to the \refSkin{standard} and \refSkin{enhanced} skin.
But instead of a segmentation line, the optional lower part of the box is filled with a
@@ -1375,15 +1900,15 @@ Nevertheless, this skin can be applied independently.
\clearpage
-\subsection{Skin family 'beamer'}
+\subsection{Skin Family 'beamer'}
\begin{docSkin}{beamer}
This skin resembles boxes known from the |beamer| class and therefore is
called 'beamer'. It uses the normal colors from the core package but shades
- them a little bit. To use this skin, the |tikz| libraries |shadings|
- and |shadows| have to be included in the preamble by:
+ them a little bit. To use this skin, the |tikz| library |shadings|
+ has to be included in the preamble by:
\begin{dispListing}
-\usetikzlibrary{shadings,shadows}
+\usetikzlibrary{shadings}
\end{dispListing}
The appearance of the skin can be controlled by \refKey{/tcb/frame style}
and \refKey{/tcb/interior style}, if needed. Here, the \emph{segmentation}
@@ -1444,8 +1969,27 @@ This box looks like a box provided by the \texttt{beamer} class.
\end{dispExample}
+\begin{dispExample}
+\begin{tcolorbox}[beamer,colframe=blue,colback=black,
+ watermark graphics=lichtspiel.jpg,
+ coltext=white,watermark opacity=0.75,watermark stretch=1.0,
+ title=Beamer Box with background picture]
+\lipsum[1]
+\end{tcolorbox}
+\end{dispExample}
+
+
+\begin{dispExample}
+\newtcolorbox{myblock}[2][]{%
+ beamer,breakable,colback=LightBlue,colframe=DarkBlue,#1,title=#2}%
+
+\begin{myblock}{Beamerish \texttt{block}: \texttt{myblock}}
+\lipsum[1]
+\end{myblock}
+\end{dispExample}
+\clearpage
\begin{docSkin}{beamerfirst}
This is a flavor of \refSkin{beamer} which is used as a \emph{first} part
in a break sequence for \refSkin{beamer}.
@@ -1579,7 +2123,7 @@ Nevertheless, this skin can be applied independently.
\clearpage
-\subsection{Skin family 'widget'}
+\subsection{Skin Family 'widget'}
\begin{docSkin}{widget}
This skin uses the normal colors from the core package but shades
them a little bit. To use this skin, the |tikz| library |shadings|