diff options
author | Karl Berry <karl@freefriends.org> | 2013-12-18 22:04:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-12-18 22:04:25 +0000 |
commit | 7edd1b30f6d91c3f4961d8ceca5a9af64668db1b (patch) | |
tree | 3c631b8d49caab36f4b589405ec4766a0f46aa5a /Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex | |
parent | 00be60da8df9f90d4ad3914ed813951c0639b409 (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.tex | 747 |
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} |