diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/tcolorbox/tcolorbox.doc.vignette.tex |
Initial commit
Diffstat (limited to 'macros/latex/contrib/tcolorbox/tcolorbox.doc.vignette.tex')
-rw-r--r-- | macros/latex/contrib/tcolorbox/tcolorbox.doc.vignette.tex | 760 |
1 files changed, 760 insertions, 0 deletions
diff --git a/macros/latex/contrib/tcolorbox/tcolorbox.doc.vignette.tex b/macros/latex/contrib/tcolorbox/tcolorbox.doc.vignette.tex new file mode 100644 index 0000000000..c1d9d7efc0 --- /dev/null +++ b/macros/latex/contrib/tcolorbox/tcolorbox.doc.vignette.tex @@ -0,0 +1,760 @@ +% !TeX root = tcolorbox.tex +% include file of tcolorbox.tex (manual of the LaTeX package tcolorbox) +\clearpage +\section{Library \mylib{vignette}}\label{sec:vignette}% +\tcbset{external/prefix=external/vignette_}% +The library is loaded by a package option or inside the preamble by: +\begin{dispListing} +\tcbuselibrary{vignette} +\end{dispListing} +This also loads the \mylib{skins} library, see \Fullref{sec:skins}, +and the |fadings| library of |tikz| \cite{tantau:tikz_and_pgf}. + + +\subsection{Vignette Drawing}\label{subsec:vignettedrawing} + +\begin{docCommand}[doc new=2016-04-22]{tcbvignette}{\marg{options}} + In this context, a \emph{vignette} is a four part rectangular frame. + It is constructed as several \tikzname\ paths and, therefore, can only be + used inside a |tikzpicture| environment or inside \refEnv{tcolorbox} options. + + The \meta{options} control position, size and style settings of the vignette. + Theses options have the common key path |/tcb/vig/| and are described in + the following. + + The next examples show direct \refCom{tcbvignette} usage without + a \refEnv{tcolorbox}. + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{} +\end{tikzpicture} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \node[draw,fill=blue!15!white] (A) {Test}; + \tcbvignette{outside node=A,raised color=blue} +\end{tikzpicture} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \node[draw,fill=blue!15!white] (A) {Another Test}; + \tcbvignette{size=3mm,outside node=A, + north style=red,east style=yellow, + south style=blue,west style=green} +\end{tikzpicture} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \node[inner sep=3mm,fill=red!75] (A) {Test}; + \tcbvignette{over node=A,fade in} +\end{tikzpicture} +\end{dispExample*} + +\refCom{tcbvignette} can be used directly inside appropriate options keys +for \refEnv{tcolorbox}. Note that options like \refKey{/tcb/underlay} need +\refKey{/tcb/enhanced} or similar settings. + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,size=small,sharp corners, + colback=green!10,colframe=green!50!black, + boxrule=1mm,titlerule=0mm, + title=My title,center title,fonttitle=\bfseries, + underlay={\tcbvignette{size=1mm,inside node=frame, + raised color=green!50!black}}] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} + +Mostly, convenient short cuts like \refKey{/tcb/underlay vignette} can +be used to add a \emph{vignette} to a \refEnv{tcolorbox}. Here, \refCom{tcbvignette} +is used internally. + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,size=small,sharp corners, + colback=green!10,colframe=green!50!black, + boxrule=1mm,titlerule=0mm, + title=My title,center title,fonttitle=\bfseries, + underlay vignette] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} + +\end{docCommand} + + + +\subsection{Generic Geometry Settings}\label{subsec:vignettegeometry} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{xmin}{=\meta{length}}{no default, initially |0pt|} + Sets the lower horizontal limit of a \refCom{tcbvignette}. +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{xmax}{=\meta{length}}{no default, initially |1cm|} + Sets the upper horizontal limit of a \refCom{tcbvignette}. +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{ymin}{=\meta{length}}{no default, initially |0pt|} + Sets the lower vertical limit of a \refCom{tcbvignette}. +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{ymax}{=\meta{length}}{no default, initially |1cm|} + Sets the upper vertical limit of a \refCom{tcbvignette}. +\end{vigTcbKey} + + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \fill [black!20] (0,0) rectangle (3,2); + \path [pattern=checkerboard,pattern color=black!30] + (0,0) rectangle (3,2); + \tcbvignette{xmin=1cm,xmax=2.5cm,ymin=0.5cm,ymax=1.75cm} +\end{tikzpicture} +\end{dispExample*} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{lower left corner}{=\meta{coordinates}}{style, initially |0,0|} + Sets the lower left corner of a \refCom{tcbvignette}. + This style sets \refKey{/tcb/vig/xmin} and \refKey{/tcb/vig/ymin}. +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{upper right corner}{=\meta{coordinates}}{style, initially |1,1|} + Sets the upper right corner of a \refCom{tcbvignette}. + This style sets \refKey{/tcb/vig/xmax} and \refKey{/tcb/vig/ymax}. +\end{vigTcbKey} + + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \fill [black!20] (0,0) rectangle (3,2); + \path [pattern=checkerboard,pattern color=black!30] + (0,0) rectangle (3,2); + \tcbvignette{lower left corner={1,0.5}, + upper right corner={2.5,1.75}} +\end{tikzpicture} +\end{dispExample*} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{inside node}{=\meta{name}}{style, initally unset} + Places the \refCom{tcbvignette} inside the node with the given \meta{name}. + The outer limits of the \emph{vignette} are adapted to the node geometry. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \node[minimum width=2cm,minimum height=1cm] (A) {Node A}; + \tcbvignette{inside node=A} + \draw[very thick] (A.south west) rectangle (A.north east); +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{outside node}{=\meta{name}}{style, initally unset} + Places the \refCom{tcbvignette} outside the node with the given \meta{name}. + The inner limits of the \emph{vignette} are adapted to the node geometry. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \node[minimum width=2cm,minimum height=1cm] (A) {Node A}; + \tcbvignette{outside node=A} + \draw[very thick] (A.south west) rectangle (A.north east); +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{over node}{=\meta{name}}{style, initally unset} + Places the \refCom{tcbvignette} over the node with the given \meta{name}. + The outer limits of the \emph{vignette} are adapted to the node geometry, but + are shifted to the outside by \refKey{/tcb/vig/over node offset}. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \node[minimum width=2cm,minimum height=1cm] (A) {Node A}; + \tcbvignette{over node offset=1mm,over node=A} + \draw[very thick] (A.south west) rectangle (A.north east); +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{over node offset}{=\meta{length}}{no default, initially |0.1mm|} + Determines the shift value for \refKey{/tcb/vig/over node}. + Note that \refKey{/tcb/vig/over node offset} has to be set \emph{before} + \refKey{/tcb/vig/over node} is used. +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{north size}{=\meta{length}}{no default, initially |2mm|} + Sets the thickness of the north \emph{vignette} part. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{north size=4mm} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{south size}{=\meta{length}}{no default, initially |2mm|} + Sets the thickness of the south \emph{vignette} part. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{south size=4mm} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{east size}{=\meta{length}}{no default, initially |2mm|} + Sets the thickness of the east \emph{vignette} part. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{east size=4mm} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{west size}{=\meta{length}}{no default, initially |2mm|} + Sets the thickness of the west \emph{vignette} part. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{west size=4mm} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{vertical size}{=\meta{length}}{style, initially |2mm|} + Sets \refKey{/tcb/vig/north size} and \refKey{/tcb/vig/south size}, + to the given \meta{length}. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{vertical size=4mm} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{horizontal size}{=\meta{length}}{style, initially |2mm|} + Sets \refKey{/tcb/vig/east size} and \refKey{/tcb/vig/west size}, + to the given \meta{length}. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{horizontal size=4mm} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{size}{=\meta{length}}{style, initially |2mm|} + Sets \refKey{/tcb/vig/north size}, \refKey{/tcb/vig/south size}, + \refKey{/tcb/vig/east size}, and \refKey{/tcb/vig/west size} to the given \meta{length}. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{size=4mm} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{marker} +\refKey{/tcb/vig/north size}, \refKey{/tcb/vig/south size}, etc. have to +be set \emph{before} \refKey{/tcb/vig/outside node} is used. +\end{marker} + + + +\subsection{Generic Color and Style Settings}\label{subsec:vignettestyle} + +\begin{vigTcbKey}[][doc new=2016-04-22]{north style}{=\marg{style}}{no default, initially |red!50!white|} + Sets \tikzname\ \meta{style} options for the north \emph{vignette} part. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{north style=blue} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + +\begin{vigTcbKey}[][doc new=2016-04-22]{south style}{=\marg{style}}{no default, initially |red!50!black|} + Sets \tikzname\ \meta{style} options for the south \emph{vignette} part. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{south style={draw=blue,fill=yellow}} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + +\clearpage + +\begin{vigTcbKey}[][doc new=2016-04-22]{east style}{=\marg{style}}{no default, initially |red!75!black|} + Sets \tikzname\ \meta{style} options for the east \emph{vignette} part. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{east style={left color=yellow!75!black, + right color=blue!75!black}} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{west style}{=\marg{style}}{no default, initially |red!75!white|} + Sets \tikzname\ \meta{style} options for the west \emph{vignette} part. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{west style={preaction={fill=black!20}, + pattern=checkerboard, + pattern color=black!30}} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-05-24]{scope}{=\marg{style}}{no default, initially empty} + The four \emph{vignette} parts are drawn inside a \tikzname\ |scope| + environment which takes the given \meta{style} as option. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{scope={transparency group,opacity=0.25}} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + + +\begin{vigTcbKey}[][doc new=2016-04-22]{raised color}{=\meta{color}}{no default} + Creates a raised frame impression by setting the four style options + \refKey{/tcb/vig/north style}, + \refKey{/tcb/vig/south style}, + \refKey{/tcb/vig/east style}, and + \refKey{/tcb/vig/west style} + to darkened and lightened variations of the given \meta{color}. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{raised color=blue} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{lowered color}{=\meta{color}}{no default} + Creates a lowered frame impression by setting the four style options + \refKey{/tcb/vig/north style}, + \refKey{/tcb/vig/south style}, + \refKey{/tcb/vig/east style}, and + \refKey{/tcb/vig/west style} + to darkened and lightened variations of the given \meta{color}. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{lowered color=green!75!black} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{color from}{=\meta{inner} |to| \meta{outer}}{no default} + Sets the four style options + \refKey{/tcb/vig/north style}, + \refKey{/tcb/vig/south style}, + \refKey{/tcb/vig/east style}, and + \refKey{/tcb/vig/west style} + such that the color shades from the + \meta{inner} color to the \meta{outer} color. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{color from=red to blue!50} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{base color}{=\meta{color}}{no default} + Sets the base color for \refKey{/tcb/vig/raised color}, + \refKey{/tcb/vig/lowered color}, \refKey{/tcb/finish fading vignette}. + Typically, this value has not to be set directly. +\end{vigTcbKey} + + +\clearpage +\begin{vigTcbKey}[][doc new=2016-04-22]{draw method}{=\docValue{direct}\textbar\docValue{clipped}}{no default, initially |direct|} + Especially, if shadings or fadings are used, the drawn \emph{vignette} + graphs are displayed sometimes not as perfect as expected. Glitches and + imperfections are very dependent on the previewer software. + The \refKey{/tcb/vig/draw method} intends to give a choice of alternative + drawing methods. + \begin{itemize} + \item\docValue{direct}: The \emph{vignette} parts are drawn/filled + by using a single \tikzname\ graph. This is the preferred (and default) + method for solid color graphs. + \item\docValue{clipped}: The \emph{vignette} parts are drawn somewhat + oversized and are clipped to the intended region. + In combination with shadings and fadings this seems to give a + better/different optical result (depends on the previewer). + \end{itemize} +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{color from=red to yellow} +\end{tikzpicture} +\end{dispExample*} +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \tcbvignette{color from=red to yellow,draw method=clipped} +\end{tikzpicture} +\end{dispExample*} + +\begin{marker} +This option is a stopgap and may be changed or preferably removed in +future. +\end{marker} +\end{vigTcbKey} + + + +\subsection{Generic Fading Settings}\label{subsec:vignettefading} + +The |fadings| library of |tikz| \cite{tantau:tikz_and_pgf} is loaded +automatically by the \mylib{vignette} library. +Amongst others, the fadings +\docFading{west}, +\docFading{east}, +\docFading{north}, and +\docFading{south} are defined inside the |fadings| library. + +The \mylib{vignette} library adds some more fadings called +\docFading{semi west}, +\docFading{semi east}, +\docFading{semi north}, and +\docFading{semi south}. +These fadings are much \emph{weaker} than the normal fadings. + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \fill [black!20] (0,0) rectangle (1,1); + \path [pattern=checkerboard,pattern color=black!30] + (0,0) rectangle (1,1); + \fill [path fading=semi west,blue] (0,0) rectangle (1,1); +\end{tikzpicture} +\end{dispExample*} + + + +\begin{tcboxedraster}{base example,title=Comparison of the Fadings} + \def\doShadingExample#1{% + \begin{tcolorbox}[sbs,size=fbox,colback=white,lower separated=false, + righthand width=2cm,left=5mm] + \docFading{#1}\tcblower + \begin{tikzpicture} + \fill [black!20] (0,0) rectangle (1,1); + \path [pattern=checkerboard,pattern color=black!30] (0,0) rectangle (1,1); + \fill [path fading=#1,blue] (0,0) rectangle (1,1); + \end{tikzpicture} + \end{tcolorbox}}% + \doShadingExample{west} + \doShadingExample{east} + \doShadingExample{north} + \doShadingExample{south} + \doShadingExample{semi west} + \doShadingExample{semi east} + \doShadingExample{semi north} + \doShadingExample{semi south} +\end{tcboxedraster} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{fade in}{\colOpt{=\marg{style}}}{style, default |white|} + Sets the four style options + \refKey{/tcb/vig/north style}, + \refKey{/tcb/vig/south style}, + \refKey{/tcb/vig/east style}, and + \refKey{/tcb/vig/west style} + such that the paths fade from outside to inside. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \fill [black!20] (-0.5,-0.5) rectangle (1.5,1.5); + \path [pattern=checkerboard,pattern color=black!30] + (-0.5,-0.5) rectangle (1.5,1.5); + \tcbvignette{fade in=blue} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{fade out}{\colOpt{=\marg{style}}}{style, default |white|} + Sets the four style options + \refKey{/tcb/vig/north style}, + \refKey{/tcb/vig/south style}, + \refKey{/tcb/vig/east style}, and + \refKey{/tcb/vig/west style} + such that the paths fade from inside to outside. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \fill [black!20] (-0.5,-0.5) rectangle (1.5,1.5); + \path [pattern=checkerboard,pattern color=black!30] + (-0.5,-0.5) rectangle (1.5,1.5); + \tcbvignette{fade out=blue} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{semi fade in}{\colOpt{=\marg{style}}}{style, default |white|} + Sets the four style options + \refKey{/tcb/vig/north style}, + \refKey{/tcb/vig/south style}, + \refKey{/tcb/vig/east style}, and + \refKey{/tcb/vig/west style} + such that the paths fade weak from outside to inside. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \fill [black!20] (-0.5,-0.5) rectangle (1.5,1.5); + \path [pattern=checkerboard,pattern color=black!30] + (-0.5,-0.5) rectangle (1.5,1.5); + \tcbvignette{semi fade in=blue} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + +\begin{vigTcbKey}[][doc new=2016-04-22]{semi fade out}{\colOpt{=\marg{style}}}{style, default |white|} + Sets the four style options + \refKey{/tcb/vig/north style}, + \refKey{/tcb/vig/south style}, + \refKey{/tcb/vig/east style}, and + \refKey{/tcb/vig/west style} + such that the paths fade weak from inside to outside. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tikzpicture} + \fill [black!20] (-0.5,-0.5) rectangle (1.5,1.5); + \path [pattern=checkerboard,pattern color=black!30] + (-0.5,-0.5) rectangle (1.5,1.5); + \tcbvignette{semi fade out=blue} +\end{tikzpicture} +\end{dispExample*} +\end{vigTcbKey} + + + + +\clearpage +\subsection{Vignette as Underlay}\label{subsec:vignetteunderlay} + +\begin{docTcbKey}[][doc new=2016-04-22]{underlay vignette}{\colOpt{=\marg{options}}}{style, no default} + This puts a \refCom{tcbvignette} with the given \meta{options} + as \refKey{/tcb/underlay} to a \refEnv{tcolorbox}. + The dimensions of the \emph{vignette} are matched to the dimensions of + the \refEnv{tcolorbox}. For example, \refKey{/tcb/leftrule} is used as + \refKey{/tcb/vig/west size}. Also, \refKey{/tcb/colframe} is used as + \refKey{/tcb/vig/raised color}. + + For a \refKey{/tcb/breakable} tcolorbox, the \emph{vignette} is also + been broken. + Alternatively, \refCom{tcbvignette} could be used directly inside + an \refKey{/tcb/underlay} with appropriate settings. + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,size=small,sharp corners, + colback=green!10,colframe=green!50!black, + boxrule=2mm,titlerule=0mm, + title=My title,center title,fonttitle=\bfseries, + underlay vignette] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,size=small,arc=0pt, + colback=blue!10,colframe=blue,boxrule=2mm, + underlay vignette={size=1.5mm}] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,size=small,sharp corners, + colframe=red,interior hidden,boxrule=2mm, + colupper=white,center upper,fontupper=\bfseries, + underlay vignette] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,size=small,sharp corners, + colback=red!50!yellow,frame hidden,boxrule=2mm, + underlay vignette={color from=red!50!yellow to white, + draw method=clipped,size=2.1mm}] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\tcbox[enhanced,sharp corners,colback=red!10,colframe=red] + {Test} + +\tcbox[enhanced,sharp corners,colback=red!10,colframe=red, + underlay vignette]{Test} +\end{dispExample*} + +\end{docTcbKey} + + +\clearpage +\begin{docTcbKey}[][doc new=2016-04-22]{underlay raised shading vignette}{\colOpt{=\marg{options}}}{style, no default} + This is a special style derived from \refKey{/tcb/underlay vignette}, + where the frame color is shaded to create a soft raised frame impression. + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,sharp corners, + colback=green!10, + colframe=green!50!black, + size=small,boxrule=2mm,titlerule=0mm, + title=My title,center title,fonttitle=\bfseries, + underlay raised shading vignette] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + + + +\begin{docTcbKey}[][doc new=2016-04-22]{underlay raised fading vignette}{\colOpt{=\marg{options}}}{style, no default} + This style gives a similar effect as \refKey{/tcb/underlay raised shading vignette}, + but a path fading is used here. Different optical impression are very + previewer-dependent. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,sharp corners, + colback=green!10, + colframe=green!50!black, + size=small,boxrule=2mm,titlerule=0mm, + title=My title,center title,fonttitle=\bfseries, + underlay raised fading vignette] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2016-04-22]{underlay shade in vignette}{\colOpt{=\marg{options}}}{style, no default} + This is a special style derived from \refKey{/tcb/underlay vignette}, + where the frame color is shaded into the interior color. +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,sharp corners,frame hidden, + colback=green!10, + colframe=green!50!black, + size=small,boxrule=2mm,titlerule=0mm, + underlay shade in vignette] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} +\end{docTcbKey} + + +\clearpage +\subsection{Vignette as Finish}\label{subsec:vignettefinish} + + +\begin{docTcbKey}[][doc new=2016-04-22]{finish vignette}{\colOpt{=\marg{options}}}{style, no default} + This puts a \refCom{tcbvignette} with the given \meta{options} + as \refKey{/tcb/finish} to a \refEnv{tcolorbox}. + The default style settings create a raised frame impression by + drawing black and white color parts with reduced opacity. + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,size=small, + colback=green!10,colframe=green!50!black, + boxrule=0.5mm,titlerule=0mm, + title=My title,center title,fonttitle=\bfseries, + finish vignette={size=1mm}] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\tcbincludegraphics[blankest,width=3cm, + finish vignette={size=3mm}]{pink_marble.png} +\end{dispExample*} +\end{docTcbKey} + + +\begin{docTcbKey}[][doc new=2016-04-22]{finish raised fading vignette}{\colOpt{=\marg{options}}}{style, no default} + This puts a \refCom{tcbvignette} with the given \meta{options} + as \refKey{/tcb/finish} to a \refEnv{tcolorbox}. + The default style settings create a soft raised frame impression by + drawing fading black and white color parts. + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,size=small, + colback=green!10,colframe=green!50!black, + boxrule=0.5mm,titlerule=0mm, + title=My title,center title,fonttitle=\bfseries, + finish raised fading vignette={size=1mm}] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\tcbincludegraphics[blankest,width=3cm, + finish raised fading vignette={size=3mm}]{pink_marble.png} +\end{dispExample*} + +\end{docTcbKey} + + +\clearpage +\begin{docTcbKey}[][doc new=2016-04-22]{finish fading vignette}{\colOpt{=\marg{options}}}{style, no default} + This puts a \refCom{tcbvignette} with the given \meta{options} + as \refKey{/tcb/finish} to a \refEnv{tcolorbox}. + The default style settings fade the box into white from inside to outside. + Note that \refKey{/tcb/vig/over node} is used here. + \refKey{/tcb/vig/over node offset} can be adapted to overlap the box + more or less. The fade color can be set using + \refKey{/tcb/vig/base color}. + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[enhanced,size=small, + colback=green!10,colframe=green!50!black, + boxrule=0.5mm,titlerule=0mm, + title=My title,center title,fonttitle=\bfseries, + finish fading vignette={size=2mm}] + This is a tcolorbox. +\end{tcolorbox} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\tcbincludegraphics[blankest,width=3cm, + finish fading vignette={size=3mm}]{pink_marble.png} +\end{dispExample*} + +\begin{dispExample*}{sbs,righthand width=3cm,center lower} +\begin{tcolorbox}[colback=blue!50!black,size=small, + title=Example] +\tcbincludegraphics[blankest, + finish fading vignette={base color=blue!50!black,size=3mm, + over node offset=0.2mm}]{pink_marble.png} +\end{tcolorbox} +\end{dispExample*} + +\end{docTcbKey} + + +\begin{dispExample*}{} +\begin{tcbitemize}[raster columns=3,bicolor, + raster equal height,sharp corners,boxrule=2mm, + colframe=red,colback=yellow!5,colbacklower=yellow!25!red!20] +\tcbitem A +\tcbitem[underlay vignette] B +\tcbitem[underlay={\tcbvignette{inside node=interior, + lowered color=red,size=1mm}}] C +\tcbitem[underlay vignette, + underlay={\tcbvignette{inside node=interior, + lowered color=red,size=1mm}}] D +\tcbitem[boxrule=3mm,underlay vignette={size=2mm}, + underlay={\tcbvignette{inside node=interior, + lowered color=red,size=1mm}}] E +\tcbitem[underlay raised shading vignette] F +\tcbitem[underlay raised shading vignette, + underlay={\tcbvignette{inside node=interior, + lowered color=red,size=1mm}}] G +\tcbitem[title=H1,underlay={\tcbvignette{inside node=interior, + lowered color=red,size=1mm}},finish vignette] H2 +\tcbitem[boxrule=0.25mm,colback=red!30,finish vignette] I1 \tcblower I2 +\tcbitem[tile,colback=red!30,finish raised fading vignette] J1 \tcblower J2 +\tcbitem[boxrule=1mm,underlay={\tcbvignette{inside node=interior, + raised color=red,size=1mm}}] K +\tcbitem[boxrule=1mm,title=L1,underlay={\tcbvignette{inside node=title, + lowered color=red,size=0.5mm}}] L2 +\end{tcbitemize} +\end{dispExample*} |