summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-12-18 22:04:25 +0000
committerKarl Berry <karl@freefriends.org>2013-12-18 22:04:25 +0000
commit7edd1b30f6d91c3f4961d8ceca5a9af64668db1b (patch)
tree3c631b8d49caab36f4b589405ec4766a0f46aa5a /Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
parent00be60da8df9f90d4ad3914ed813951c0639b409 (diff)
tcolorbox (17dec13)
git-svn-id: svn://tug.org/texlive/trunk@32442 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.tex747
1 files changed, 696 insertions, 51 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 d6d349092b1..3dbdba3fe1e 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
@@ -105,9 +105,13 @@ Every engine for the up to four steps can be set to one of the following types:
\begin{itemize}
\item |standard|: the original code from the core package,
\item |path|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
+ \item |pathjigsaw|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
\item |pathfirst|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
+ \item |pathfirstjigsaw|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
\item |pathmiddle|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
+ \item |pathmiddlejigsaw|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
\item |pathlast|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
+ \item |pathlastjigsaw|: a |tikz| path which is controlled by \refKey{/tcb/frame style},
\item |freelance|: arbitrary user code which is given by \refKey{/tcb/frame code}.
\end{itemize}
\end{docTcbKey}
@@ -126,6 +130,7 @@ Every engine for the up to four steps can be set to one of the following types:
\end{itemize}
\end{docTcbKey}
+\clearpage
\begin{docTcbKey}{interior engine}{=\meta{name}}{no default, initially \texttt{standard}}
Sets the \emph{interior} drawing engine for an untitled box to \meta{name}.
Typically, this key is set by a \refKey{/tcb/skin}.
@@ -346,32 +351,11 @@ This is the lower part.
\end{docTcbKey}
-\begin{docTcbKey}{colbacktitle}{=\meta{color}}{style, no default, initially unset}
- Abbreviation for setting \refKey{/tcb/title style} to |fill=|\meta{color}.
- This fills the background of the title area with the given \meta{color}.\\
- This option is available if the \refKey{/tcb/title engine} is set to
- |path|, |pathfirst|, |pathmiddle|, or |pathlast|.
- It is \emph{not} available for |standard| and it \emph{may} be
- applicable for |freelance|.
-\begin{dispExample*}{sbs,lefthand ratio=0.66}
-\tcbset{colback=red!5!white,colframe=red!75!black,
- coltitle=blue!50!black,fonttitle=\bfseries}
-
-\begin{tcolorbox}[enhanced,title=My title,
- colbacktitle=yellow!50!white]
-This is a \textbf{tcolorbox}.
-\tcblower
-This is the lower part.
-\end{tcolorbox}
-\end{dispExample*}
-\end{docTcbKey}
-
\begin{docTcbKey}{title hidden}{}{style, no value}
This is a shortcut for |title style={draw=none,fill=none}|.
Depending on the skin, this option switches off the drawing of the
- title background. This is the default behavior for \refSkin{standard} and
- \refSkin{enhanced}.
+ title background. See also \refKey{/tcb/title filled} for a similar effect.
\begin{dispExample*}{sbs,lefthand ratio=0.66}
\tcbset{colback=red!5!white,colframe=red!75!black,
fonttitle=\bfseries}
@@ -386,6 +370,7 @@ This is the lower part.
\end{docTcbKey}
+
\clearpage
\subsection{Code Option Keys}\label{subsec:addcodeoptions}
The following code options are applicable for all skins which
@@ -774,6 +759,32 @@ Defines a |Tikz| scope which clips to the frame area path.
\end{docEnvironment}
\clearpage
+\begin{docEnvironment}{tcbinvclipframe}{}
+Defines a |Tikz| scope which clips to the \emph{outside} of the frame area path.
+
+\begin{dispExample}
+\tcbset{enhanced jigsaw,fonttitle=\bfseries,opacityback=0.35,colback=blue!5!white,
+ frame style={left color=red!75!black,right color=red!10!yellow}}
+
+\begin{tikzpicture}% draw two balls
+ \path[use as bounding box] (0,0.8) rectangle +(0.1,0.1);
+ \shadedraw [shading=ball] (0,0) circle (1cm);
+ \shadedraw [ball color=red] (3,-2.2) circle (1cm);
+\end{tikzpicture}
+
+\begin{tcolorbox}[title=A translucent box,
+ overlay={\begin{tcbinvclipframe}
+ \draw[red,line width=1cm] ([xshift=-2mm,yshift=2mm]frame.north west)
+ --([xshift=2mm,yshift=-2mm]frame.south east);
+ \draw[red,line width=1cm] ([xshift=-2mm,yshift=-2mm]frame.south west)
+ --([xshift=2mm,yshift=2mm]frame.north east);
+ \end{tcbinvclipframe}}]
+ \lipsum[2]
+\end{tcolorbox}
+\end{dispExample}
+\end{docEnvironment}
+
+\clearpage
\begin{docEnvironment}{tcbclipinterior}{}
Defines a |Tikz| scope which clips to the interior area path.
\begin{dispExample}
@@ -802,7 +813,8 @@ Defines a |Tikz| scope which clips to the title area path.
\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}
+\tcbset{enhanced,width=5cm,colframe=red!50!white,coltitle=black,
+ colbacktitle=yellow!50!white}
\begin{tcolorbox}[title=\mbox{This is a title which is unbreakable and far too long}]
This is a tcolorbox.
@@ -972,6 +984,30 @@ This is a tcolorbox.
\end{docTcbKey}
+\begin{docTcbKey}{show bounding box}{\colOpt{=\meta{color}}}{default |red|, initially unset}
+ Technically, this option is no borderline option but an overlay option, see
+ \Vref{subsec:overlays}. It is documented here, because it needs a
+ |tikzpicture| environment and it displays the bounding box borderline of
+ a |tcolorbox|. Its intended use is debugging and fine tuning.
+ The optional \meta{color} is the base color for the bounding box
+ borderline.
+\begin{dispExample}
+\tcbset{enhanced,nobeforeafter,width=4cm,fonttitle=\bfseries}
+
+\begin{tcolorbox}[show bounding box,title=Normal]
+This is a tcolorbox.
+\end{tcolorbox}%
+\begin{tcolorbox}[show bounding box=blue,title=Shadow,drop fuzzy shadow]
+This is a tcolorbox.
+\end{tcolorbox}%
+\begin{tcolorbox}[show bounding box=green,title=Enlarged,drop fuzzy shadow,
+ enlarge by=2mm]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample}
+\end{docTcbKey}
+
+
\clearpage
\subsection{Shadow Option Keys}\label{subsec:shadows}
The following shadow options are applicable for most skins which
@@ -982,6 +1018,10 @@ 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}{no shadow}{}{no default}
+ Removes all shadows if set before.
+\end{docTcbKey}
+
\begin{docTcbKey}{shadow}{=\marg{xshift}\marg{yshift}\marg{offset}\marg{options}}{no default}
Adds a new shadow to the stack of shadows.
@@ -1101,7 +1141,6 @@ This is a tcolorbox.
\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.
@@ -1120,6 +1159,8 @@ This is a tcolorbox.
\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.
@@ -1174,7 +1215,6 @@ This is a tcolorbox.
\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}
@@ -1213,20 +1253,395 @@ This is a tcolorbox.
\end{dispExample*}
\begin{dispExample}
-\begin{tcolorbox}[blank,
+\begin{tcolorbox}[blank,enhanced jigsaw,boxsep=2pt,arc=2pt,
fuzzy halo=2mm with red!50!white,
- fuzzy halo=1mm with white,]
+ fuzzy halo=1mm with white]
\lipsum[1]
\end{tcolorbox}
\end{dispExample}
\end{docTcbKey}
+\clearpage
+For all following shadows, the optionally given \meta{color} for the shadow can be changed
+equivalent to the preceding examples.
-\begin{docTcbKey}{no shadow}{}{no default}
- Removes all shadows if set before.
+\begin{docTcbKey}{drop shadow southeast}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+ This shadow is identical to \refKey{/tcb/drop shadow}.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow southeast,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow south}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+ This shadow is identical to \refKey{/tcb/drop midday shadow}.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow south,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow southwest}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow southwest,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow west}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow west,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow northwest}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow northwest,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow north}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow north,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\clearpage
+\begin{docTcbKey}{drop shadow northeast}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow northeast,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop shadow east}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop shadow east,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+
+\begin{docTcbKey}{drop fuzzy shadow southeast}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+ This shadow is identical to \refKey{/tcb/drop fuzzy shadow}.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow southeast,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow south}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+ This shadow is identical to \refKey{/tcb/drop fuzzy midday shadow}.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow south,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow southwest}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow southwest,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow west}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow west,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\clearpage
+\begin{docTcbKey}{drop fuzzy shadow northwest}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow northwest,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow north}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow north,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow northeast}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow northeast,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+\begin{docTcbKey}{drop fuzzy shadow east}{\colOpt{=\meta{color}}}{style, default |black!50!white|}
+ Adds a new fuzzy shadow with standard dimensions to the stack of shadows.
+\begin{dispExample*}{sbs,lefthand ratio=0.7}
+\begin{tcolorbox}[drop fuzzy shadow east,
+ enhanced,colback=red!5!white,colframe=red!75!black]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}%
+
+
+\clearpage
+\subsection{TikZ Picture Option Keys}\label{subsec:tikzpicture}
+The following general options are applicable for skins which
+use |tikzpicture| as \refKey{/tcb/graphical environment}.
+Therefore, the skin \refSkin{standard} does not support these options,
+but most other skins, e.\,g.\ \refSkin{enhanced}.
+
+
+\begin{docTcbKey}{tikz}{=\meta{tikz option list}}{no default, initially empty}
+ Adds the given \meta{tikz option list} to the main |tikzpicture| environment
+ used to draw the color box, see \cite{tantau:2010c}. If this option is
+ applied a second time, the new \meta{tikz option list} is appended to the
+ current option list.
+\begin{dispExample*}{sbs,lefthand ratio=0.66,
+ segmentation style={pattern=crosshatch dots light steel blue}}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=Transparent box,
+ tikz={opacity=0.5,transparency group}]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{tikz reset}{}{initially set}
+ Removes all options given by \refKey{/tcb/tikz}.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{at begin tikz}{=\meta{tikz code}}{no default, initially empty}
+ The given \meta{tikz code} is executed at the begin of the |tikzpicture| environment
+ after the TikZ option |execute at begin picture| was applied.
+ If this option is applied a second time, the new \meta{tikz code} is appended to the current code.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{at begin tikz reset}{}{initially set}
+ Removes all code given by \refKey{/tcb/at begin tikz}.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{at end tikz}{=\meta{tikz code}}{no default, initially empty}
+ The given \meta{tikz code} is executed at the end of the |tikzpicture| environment
+ before the TikZ option |execute at end picture| was applied.
+ If this option is applied a second time, the new \meta{tikz code} is appended to the current code.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{at end tikz reset}{}{initially set}
+ Removes all code given by \refKey{/tcb/at end tikz}.
+\end{docTcbKey}
+
+
+\clearpage
+\begin{docTcbKey}{rotate}{=\meta{angle}}{no default, initially unset}
+ Rotates the |tcolorbox| by the given \meta{angle}. Note that this is
+ a TikZ coordinate transformation i.e. not all graphical elements like shadings
+ will really be rotated.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=Rotated box,rotate=30]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\begin{docTcbKey}{scale}{=\meta{fraction}}{no default, initially unset}
+ Scales the |tcolorbox| by the given \meta{fraction}. Note that this is
+ a TikZ coordinate transformation i.e. not all graphical elements like line widths
+ will really be scaled.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\tcbset{enhanced,colback=red!5!white,
+ colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[title=Scaled box,scale=0.5]
+This is a tcolorbox.
+\end{tcolorbox}
+\begin{tcolorbox}[title=Scaled box,scale=1.25]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{remember}{}{style, initially unset}
+ Shortcut for |tikz={remember picture}|. This allows to reference nodes
+ in other TikZ pictures.
+\begin{dispExample}
+\begin{tcolorbox}[enhanced,remember,colback=red!5!white,colframe=red!75!black,
+ fonttitle=\bfseries,title=The four corners of a paper,
+ overlay={\draw[red!50!white,line width=1mm,opacity=0.5,shorten >=3mm]
+ (frame.north west) edge[->] (current page.north west)
+ (frame.north east) edge[->] (current page.north east)
+ (frame.south west) edge[->] (current page.south west)
+ (frame.south east) edge[->] (current page.south east);}]
+This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample}
\end{docTcbKey}
+\clearpage
+\begin{docTcbKey}{remember as}{=\meta{name}}{style, no default, initially unset}
+ The |frame| node will be remembered by the given \meta{name} to be referenced
+ in other TikZ pictures.
+\begin{dispExample}
+% \usepackage{lipsum}
+\newtcolorbox{mybox}[1][]{enhanced,colframe=blue!75!black,colback=blue!10!white,
+ fonttitle=\bfseries,#1}
+
+\begin{mybox}[title=First Box,nobeforeafter,width=\linewidth/4,remember as=one]
+This is a test.
+\end{mybox}
+\hfill
+\begin{mybox}[title=Second Box,nobeforeafter,width=\linewidth/4,remember as=two]
+This is a test.
+\end{mybox}
+\hfill
+\begin{mybox}[title=Third Box,nobeforeafter,width=\linewidth/4,remember as=three]
+This is a test.
+\end{mybox}
+
+\lipsum[2]
+
+\begin{mybox}[title=Fourth Box,remember as=four]
+This is a test.
+\end{mybox}
+
+\begin{tikzpicture}[overlay,remember picture,line width=1mm,draw=red!75!black]
+ \draw[->] (one.east) to[bend right] node[above] {A} (two.west);
+ \draw[->] (two.east) to[bend left] node[above] {B} (three.west);
+ \draw[->] (three.east) to[bend left=90] node[right] {C} (four.east);
+ \draw[->] (four.west) to[bend left=90] node[left] {D} (one.west);
+\end{tikzpicture}
+\end{dispExample}
+\end{docTcbKey}
+
+\clearpage
+\subsection{Jigsaw Skin Variants}\label{subsec:skinjigsaw}
+As described in \Vref{sec:skincorekeys}, a |tcolorbox| is drawn by up to
+four \emph{engines}. Typically, the \emph{frame} engine fills the complete box area
+with color and the other engines fill certain areas with other colors.
+Finally, only the area which you see as \emph{frame} of the box will display
+the frame color. For most applications, this is a good approach.
+
+For certain boxes, a more delicate procedure is needed. E.g., if the box should
+be translucent, an already painted area cannot be made unpainted. Therefore,
+more elaborate frame engines saw holes into the frame where the interior area and
+optionally the title area will be painted.
+The resulting skins are called \emph{jigsaw} skins. For \refSkin{standard}
+and \refSkin{enhanced}, there are variants called \refSkin{standard jigsaw}
+and \refSkin{enhanced jigsaw}.
+
+
+\begin{dispExample}
+\newcommand{\ballexample}{\begin{tikzpicture}
+ \path[use as bounding box] (0,0.8) rectangle +(0.1,0.1);
+ \shadedraw [shading=ball] (0,0) circle (1cm);
+ \shadedraw [ball color=red] (3,-2.2) circle (1cm);
+\end{tikzpicture}}
+
+\tcbset{enhanced,colback=blue!5!white,
+ frame style={left color=red!75!black,right color=red!10!yellow},
+ fonttitle=\bfseries }
+
+\ballexample
+
+\begin{tcolorbox}[title=A normal box]
+ \lipsum[2]
+\end{tcolorbox}
+
+\ballexample
+
+\begin{tcolorbox}[title=A translucent jigsaw box,
+ enhanced jigsaw,opacityback=0.35]
+ \lipsum[2]
+\end{tcolorbox}
+\end{dispExample}
+
+
+\begin{dispExample*}{segmentation style={pattern=crosshatch dots light steel blue}}
+\tcbset{enhanced,colback=red!10!white,coltitle=black,
+ frame style={left color=red!75!black,right color=red!10!yellow},
+ fonttitle=\bfseries,interior hidden,title hidden}
+
+\begin{tcolorbox}[title=A normal box with hidden interior and titel]
+ This is a tcolorbox.
+\end{tcolorbox}
+
+\begin{tcolorbox}[enhanced jigsaw,
+ title=A jigsaw box with hidden interior and titel]
+ This is a tcolorbox.
+\end{tcolorbox}
+\end{dispExample*}
+
+
+\begin{dispExample}
+\newtcolorbox{mybox}{skin=enhancedmiddle jigsaw,leftrule=5mm,rightrule=5mm,
+ boxsep=0mm,top=0mm,bottom=0mm,
+ frame style={top color=blue,bottom color=red},interior hidden}
+
+\begin{mybox}
+ \lipsum[2]
+\end{mybox}
+\end{dispExample}
\clearpage
@@ -1235,7 +1650,7 @@ This is a tcolorbox.
fonttitle=\bfseries,before=\par\smallskip,
title=Environment and engines for the skin '\texttt{#1}'}}
-\subsection{Skin 'standard'}\label{subsec:skinstandard}
+\subsection{Skin Family 'standard'}\label{subsec:skinstandard}
\begin{marker}Note that the option keys \refKey{/tcb/frame style},
\refKey{/tcb/interior style},
\refKey{/tcb/segmentation style}, and
@@ -1268,7 +1683,7 @@ This is a tcolorbox.
\begin{dispExample}
\tcbset{standard,equal height group=standard,
colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
- width=(\linewidth-6mm)/4,nobeforeafter,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
%
\begin{tcolorbox}
@@ -1290,6 +1705,53 @@ This is a tcolorbox.
\end{dispExample}
+\clearpage
+
+\begin{docSkin}{standard jigsaw}
+ This is the standard jigsaw skin from the core package. It differs from
+ the skin \refSkin{standard} by its frame engine, see \Vref{subsec:skinjigsaw}.
+\begin{tcolorbox}[skintable=standard jigsaw]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |pgfpicture|\\
+ \refKey{/tcb/frame engine}: \> |standardjigsaw|\\
+ \refKey{/tcb/interior titled engine}: \> |standard|\\
+ \refKey{/tcb/interior engine}: \> |standard|\\
+ \refKey{/tcb/segmentation engine}: \> |standard|\\
+ \refKey{/tcb/title engine}: \> |standard|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{docTcbKey}{standard jigsaw}{}{style, no value}
+ This is an abbreviation for setting |skin=standard jigsaw|.
+\end{docTcbKey}
+
+\begin{dispExample}
+\tcbset{standard jigsaw,equal height group=standardjigsaw,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
+ opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
\clearpage
\subsection{Skin Family 'enhanced'}
@@ -1526,8 +1988,188 @@ Nevertheless, this skin can be applied independently.
\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}{enhancedlast}
+This is a flavor of \refSkin{enhanced} which is used as a \emph{last} part
+in a break sequence for \refSkin{enhanced}.
+Nevertheless, this skin can be applied independently.
+\begin{tcolorbox}[skintable=enhancedlast]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathlast|\\
+ \refKey{/tcb/interior titled engine}: \> |pathlast|\\
+ \refKey{/tcb/interior engine}: \> |pathlast|\\
+ \refKey{/tcb/segmentation engine}: \> |path|\\
+ \refKey{/tcb/title engine}: \> |pathlast|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{dispExample}
+\tcbset{skin=enhancedlast,equal height group=enhancedlast,
+ colback=LightGreen,colframe=DarkGreen,
+ width=(\linewidth-6mm)/4,nobeforeafter,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}{enhanced jigsaw}
+ This is the jigsaw variant of skin \refSkin{enhanced}.
+ It differs by its frame engine, see \Vref{subsec:skinjigsaw}.
+\begin{tcolorbox}[skintable=enhanced jigsaw]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathjigsaw|\\
+ \refKey{/tcb/interior titled engine}: \> |path|\\
+ \refKey{/tcb/interior engine}: \> |path|\\
+ \refKey{/tcb/segmentation engine}: \> |path|\\
+ \refKey{/tcb/title engine}: \> |path|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+\begin{docTcbKey}{enhanced jigsaw}{}{style, no value}
+ This is an abbreviation for setting |skin=enhanced jigsaw|.
+\end{docTcbKey}
+
+\begin{dispExample}
+\tcbset{enhanced jigsaw,equal height group=enhancedjigsaw,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
+ opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}{enhancedfirst jigsaw}
+ This is the jigsaw variant of skin \refSkin{enhancedfirst}.
+ It differs by its frame engine, see \Vref{subsec:skinjigsaw}.
+\begin{tcolorbox}[skintable=enhancedfirst jigsaw]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathfirstjigsaw|\\
+ \refKey{/tcb/interior titled engine}: \> |pathfirst|\\
+ \refKey{/tcb/interior engine}: \> |pathfirst|\\
+ \refKey{/tcb/segmentation engine}: \> |path|\\
+ \refKey{/tcb/title engine}: \> |pathfirst|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\tcbset{skin=enhancedfirst jigsaw,equal height group=enhancedfirstjigsaw,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
+ opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
+\clearpage
+\begin{docSkin}{enhancedmiddle jigsaw}
+ This is the jigsaw variant of skin \refSkin{enhancedmiddle}.
+ It differs by its frame engine, see \Vref{subsec:skinjigsaw}.
+\begin{tcolorbox}[skintable=enhancedmiddle jigsaw]
+ \begin{tabbing}
+ \refKey{/tcb/interior titled engine}: \=\kill
+ \refKey{/tcb/graphical environment}: \> |tikzpicture|\\
+ \refKey{/tcb/frame engine}: \> |pathmiddlejigsaw|\\
+ \refKey{/tcb/interior titled engine}: \> |pathmiddle|\\
+ \refKey{/tcb/interior engine}: \> |pathmiddle|\\
+ \refKey{/tcb/segmentation engine}: \> |path|\\
+ \refKey{/tcb/title engine}: \> |pathmiddle|
+ \end{tabbing}
+\end{tcolorbox}
+\end{docSkin}
+
+
+\begin{dispExample}
+\tcbset{skin=enhancedmiddle jigsaw,equal height group=enhancedmiddlejigsaw,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
+ opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
+ left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
+%
+\begin{tcolorbox}
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+\end{tcolorbox}\hfill
+\begin{tcolorbox}[adjusted title=My title]
+ This is my content.
+ \tcblower
+ More content.
+\end{tcolorbox}
+\end{dispExample}
+
+
\begin{docTcbKey}{marker}{}{style, no value}
- This styles relies on the skin \refSkin{enhancedmiddle}. It is
+ This styles relies on the skin \refSkin{enhancedmiddle jigsaw}. It is
intended to be used as an optical marker like a highlighter pen.
\begin{dispExample}
\begin{tcolorbox}[marker]
@@ -1541,10 +2183,9 @@ Nevertheless, this skin can be applied independently.
\begin{dispListing*}{before upper={This examples demonstrates the creation of several
\emph{text marker} environments based on \refSkin{enhancedmiddle}.\par\medskip}}
\tcbset{textmarker/.style={%
- skin=enhancedmiddle,breakable,parbox=false,
+ skin=enhancedmiddle jigsaw,breakable,parbox=false,
boxrule=0mm,leftrule=5mm,rightrule=5mm,boxsep=0mm,arc=0mm,outer arc=0mm,
- left=3mm,right=3mm,top=1mm,bottom=1mm,enlarge left by=-8mm,enlarge right by=-8mm,
- toptitle=1mm,bottomtitle=1mm,width=\the\dimexpr\linewidth+1.6cm\relax}}
+ left=3mm,right=3mm,top=1mm,bottom=1mm,toptitle=1mm,bottomtitle=1mm,oversize}}
\newtcolorbox{yellow}{textmarker,colback=yellow!5!white,colframe=yellow}
\newtcolorbox{orange}{textmarker,colback=DarkOrange!5!white,
@@ -1552,41 +2193,45 @@ Nevertheless, this skin can be applied independently.
\newtcolorbox{red}{textmarker,colback=red!5!white,colframe=red}
\newtcolorbox{blue}{textmarker,colback=DeepSkyBlue!5!white,colframe=DeepSkyBlue}
\newtcolorbox{green}{textmarker,colback=Chartreuse!5!white,colframe=Chartreuse}
+\newtcolorbox{rainbow}{textmarker,interior hidden,
+ frame style={top color=blue,bottom color=red,middle color=green}}
\begin{yellow}
- \lipsum[1]
+ \lipsum[1-3]
\end{yellow}
\begin{orange}
- \lipsum[2]
+ \lipsum[4]
\end{orange}
\begin{red}
- \lipsum[3]
+ \lipsum[5]
\end{red}
\begin{green}
- \lipsum[4]
+ \lipsum[6]
\end{green}
\begin{blue}
- \lipsum[5]
+ \lipsum[7]
\end{blue}
-\lipsum[6]% following text
+
+\begin{rainbow}
+ \lipsum[8]
+\end{rainbow}
\end{dispListing*}
{\tcbusetemp}
\clearpage
-\begin{docSkin}{enhancedlast}
-This is a flavor of \refSkin{enhanced} which is used as a \emph{last} part
-in a break sequence for \refSkin{enhanced}.
-Nevertheless, this skin can be applied independently.
+\begin{docSkin}{enhancedlast jigsaw}
+ This is the jigsaw variant of skin \refSkin{enhancedlast}.
+ It differs by its frame engine, see \Vref{subsec:skinjigsaw}.
\begin{tcolorbox}[skintable=enhancedlast]
\begin{tabbing}
\refKey{/tcb/interior titled engine}: \=\kill
\refKey{/tcb/graphical environment}: \> |tikzpicture|\\
- \refKey{/tcb/frame engine}: \> |pathlast|\\
+ \refKey{/tcb/frame engine}: \> |pathlastjigsaw|\\
\refKey{/tcb/interior titled engine}: \> |pathlast|\\
\refKey{/tcb/interior engine}: \> |pathlast|\\
\refKey{/tcb/segmentation engine}: \> |path|\\
@@ -1595,10 +2240,12 @@ Nevertheless, this skin can be applied independently.
\end{tcolorbox}
\end{docSkin}
+
\begin{dispExample}
-\tcbset{skin=enhancedlast,equal height group=enhancedlast,
- colback=LightGreen,colframe=DarkGreen,
- width=(\linewidth-6mm)/4,nobeforeafter,
+\tcbset{skin=enhancedlast jigsaw,equal height group=enhancedlastjigsaw,
+ colback=LightGreen,colframe=DarkGreen,colbacklower=LimeGreen!75!LightGreen,
+ colbacktitle=LimeGreen!75!DarkGreen,width=(\linewidth-6mm)/4,nobeforeafter,
+ opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
left=1mm,right=1mm,top=1mm,bottom=1mm,middle=1mm}
%
\begin{tcolorbox}
@@ -1620,8 +2267,6 @@ Nevertheless, this skin can be applied independently.
\end{dispExample}
-
-
\clearpage
\subsection{Skin Family 'freelance'}
\begin{marker}