diff options
author | Karl Berry <karl@freefriends.org> | 2016-04-27 22:56:01 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-04-27 22:56:01 +0000 |
commit | 10b12106d8ae2296611d43f2dfd622f86da2e615 (patch) | |
tree | 222a4864ce0ffb796457da4b95f4543266f568af /Master/texmf-dist/doc/latex | |
parent | 48b3038496bf03bf75673179dae38809fb3d8caf (diff) |
tcolorbox (27apr16)
git-svn-id: svn://tug.org/texlive/trunk@40792 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
15 files changed, 888 insertions, 21 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES index ca5fba5bc7d..e406f526253 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES +++ b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES @@ -1,4 +1,4 @@ -%% The LaTeX package tcolorbox - version 3.90 (2016/02/29) +%% The LaTeX package tcolorbox - version 3.91 (2016/04/27) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2016 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de> @@ -875,3 +875,30 @@ version 3.90 (2016/02/29) 'raster multicolumn', 'raster multirow' - library 'documentation': removal of some unwanted blanks + +version 3.91 (2016/04/27) +- bug fix: '\tcbline' was indented when setting '\parindent' inside a box +- bug fix: 'minimum for equal height group' changed current equal height group + and settings with 'em' or 'ex' units were converted to 0pt +- bug fix: setting '-output-directory' and 'outputdir=' for the minted package + broke \tcblisting for 'listing engine=minted' +- documentation: biber problem with latin1 encoding circumvented +- new options: + 'minimum for current equal height group' +- library 'theorems': + * new option: 'label separator' +- new library 'vignette' for ornamental frames: + * new fadings: 'semi west', 'semi east', 'semi north', 'semi south' + * new macros: '\tcbvignette' + * new options: + 'xmin', 'xmax', 'ymin', 'ymax', + 'lower left corner', 'upper right corner', 'inside node', 'outside node', + 'over node', 'over node offset', 'north size', 'south size', 'east size', + 'west size', 'size', 'north style', 'south style', 'east style', 'west style', + 'draw method', 'fade out', 'semi fade out', 'fade in', 'semi fade in', + 'base color', 'raised color', 'lowered color', + 'underlay vignette', 'underlay raised fading vignette', + 'underlay raised shading vignette', 'underlay shade in vignette', + 'finish vignette', 'finish raised fading vignette', 'finish fading vignette' +- library 'raster': + * new environment: 'tcboxeditemize' diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README index 55be40956e3..6301cd0b820 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/README +++ b/Master/texmf-dist/doc/latex/tcolorbox/README @@ -1,4 +1,4 @@ -%% The LaTeX package tcolorbox - version 3.90 (2016/02/29) +%% The LaTeX package tcolorbox - version 3.91 (2016/04/27) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2016 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de> @@ -43,6 +43,7 @@ Contents of the package 'tcbskins.code.tex' LaTeX package file (library of tcolorbox) 'tcbskinsjigsaw.code.tex' LaTeX package file (library of tcolorbox) 'tcbtheorems.code.tex' LaTeX package file (library of tcolorbox) + 'tcbvignette.code.tex' LaTeX package file (library of tcolorbox) 'tcbxparse.code.tex' LaTeX package file (library of tcolorbox) 'blueshade.png' Picture (package) 'crinklepaper.png' Picture (package) @@ -76,6 +77,7 @@ Alternatively, put the files to their respective locations within the TeX instal 'tcbskins.code.tex' -> /tex/latex/tcolorbox 'tcbskinsjigsaw.code.tex' -> /tex/latex/tcolorbox 'tcbtheorems.code.tex' -> /tex/latex/tcolorbox + 'tcbvignette.code.tex' -> /tex/latex/tcolorbox 'tcbxparse.code.tex' -> /tex/latex/tcolorbox 'blueshade.png' -> /tex/latex/tcolorbox 'crinklepaper.png' -> /tex/latex/tcolorbox diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf Binary files differindex 57d5ba6e149..f5a41c289dc 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex index ef72f3a4197..3d1438cb5c8 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex @@ -1,4 +1,4 @@ -%% The LaTeX package tcolorbox - version 3.90 (2016/02/29) +%% The LaTeX package tcolorbox - version 3.91 (2016/04/27) %% tcolorbox-example.tex: an example for tcolorbox %% %% ------------------------------------------------------------------------------------------- diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex index 09318e42bb5..736ec69c11f 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex @@ -1965,6 +1965,25 @@ with a listing. \end{dispExample} \end{docTcbKey} + +\begin{docTcbKey}[][doc new=2016-03-24]{minimum for current equal height group}{=\meta{length}}{no default, initially unset} + Sets \refKey{/tcb/minimum for equal height group} for the current equal height + group. Apparently, this only works for an already known equal height group, i.e. + \refKey{/tcb/equal height group} has to be set \emph{before} this option is used. + This option is likely to be used in combination with \refKey{/tcb/raster equal height} + +\begin{dispExample} +% \tcbuselibrary{raster} +\begin{tcbitemize}[raster equal height,colframe=blue!75!black,colback=white, + raster every box/.style={minimum for current equal height group=2cm}] + \tcbitem A + \tcbitem B +\end{tcbitemize} +\end{dispExample} + +\end{docTcbKey} + + \clearpage \begin{docTcbKey}[][doc new and updated={2015-11-27}{2016-02-22}]{use height from group}{\colOpt{=\meta{id}}}{style, default current group} Sets the current box to a fixed \refKey{/tcb/height} which is copied from diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.external.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.external.tex index 139a1ca799f..1d8c4172409 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.external.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.external.tex @@ -193,7 +193,7 @@ the text before and after have to be given separately outside the \begin{tcbexternal}[minipage]{example_tcolorbox2} \color{white}% The interior of the tcolorbox is externalized. - One can use numbered boxes without problem. + One can use numbered boxes without problems. Note that the text color has to be set for the text manually since it is converted into an image. \end{tcbexternal} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex index b408632b921..b11f0760348 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex @@ -208,7 +208,7 @@ Feasible values for \meta{name} are: \begin{itemize} \item\docValue{figures}: blend into the standard |figure| environment. \item\docValue{tables}: blend into the standard |table| environment. -\item\docValue{listings}: blend into the standard |lstlistings| environment +\item\docValue{listings}: blend into the standard |lstlisting| environment of the package |listings| \cite{heinz:2015a}. \begin{marker} Note that |blend into=listings| can only be used in the document content diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex index 3f75aeb9f11..2a15909bcd0 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex @@ -89,6 +89,11 @@ The following keys are used inside |\tcbuselibrary| respectively Section~\ref{sec:skins} from page~\pageref{sec:skins}. \end{docTcbKey} +\begin{docTcbKey}[library]{vignette}{}{\mylib{vignette}} + Provides code for more ornamental; see + Section~\ref{sec:vignette} from page~\pageref{sec:vignette}. +\end{docTcbKey} + \begin{docTcbKey}[library]{raster}{}{\mylib{raster}} Provides additional macros and options for typesetting multiple boxes arranged in a kind of raster; @@ -143,12 +148,12 @@ The following keys are used inside |\tcbuselibrary| respectively see Section~\ref{sec:hooks} from page~\pageref{sec:hooks}. \end{docTcbKey} +\clearpage \begin{docTcbKey}[library]{xparse}{}{\mylib{xparse}} Provides document command production with |xparse| for |tcolorbox|; see Section~\ref{sec:xparse} from page~\pageref{sec:xparse}. \end{docTcbKey} -\clearpage \begin{docTcbKey}[library]{external}{}{\mylib{external}} Provides externalization support for stand-alone document snippets, see \Fullref{sec:external}. @@ -194,6 +199,7 @@ The following keys are used inside |\tcbuselibrary| respectively raster equal height,beamer,colframe=blue!50!black,colback=blue!10!white] \tcbitem[adjusted title=Advanced Features] \mylib{skins}\\ + \mylib{vignette}\\ \mylib{raster}\\ \mylib{breakable}\\ \mylib{magazine}\\ diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.picturecredits.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.picturecredits.tex index 156e075d905..0b9db2bbd15 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.picturecredits.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.picturecredits.tex @@ -7,7 +7,8 @@ The following pictures were used inside this documentation. \DeclareTotalTColorBox{\diabox}{ O{} v m } { bicolor,fonttitle=\bfseries\ttfamily,adjusted title={#2},center title, - colframe=blue!20!black,leftupper=0mm,rightupper=0mm,colback=black!75!white,#1} + colframe=blue!20!black,leftupper=0mm,rightupper=0mm,colback=black!75!white, + finish vignette={size=1.5mm},#1} { \tikz\path[fill zoom image={#2}] (0,0) rectangle (\linewidth,4cm);% \tcblower#3} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex index 009552f1a3b..8ea4cbc3a4d 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex @@ -212,8 +212,29 @@ If \refKey{/tcb/fit} should be used, turn over to \refEnv{tcbraster}. \begin{tcolorbox}Seven\end{tcolorbox} \end{tcbraster} \end{dispExample} +\end{docEnvironment} +\clearpage +\begin{docEnvironment}[doc new=2016-04-27]{tcboxeditemize}{\oarg{raster options}\marg{box options}} + This is a convenience environment which combines a \refEnv{tcolorbox} with + an embedded \refEnv{tcbitemize}. The \meta{box options} are given to the + outer \refEnv{tcolorbox}, while the \meta{raster options} are given to the + embedded \refEnv{tcbitemize}. + This environment is especially useful for rasters inside rasters. + +\begin{dispExample} +\begin{tcboxeditemize}[raster columns=3, raster equal height, + size=small,colframe=red!50!black,colback=red!10!white,colbacktitle=red!50!white, + title={Box \# \thetcbrasternum}] + {colback=yellow!10,fonttitle=\bfseries,title=Boxed Itemize} + \tcbitem First box + \tcbitem Second box + \tcbitem This is a box\\with a second line + \tcbitem Another box + \tcbitem A box again +\end{tcboxeditemize} +\end{dispExample} \end{docEnvironment} @@ -438,6 +459,7 @@ If \refKey{/tcb/fit} should be used, turn over to \refEnv{tcbraster}. Puts the enclosed boxes into a common \refKey{/tcb/equal height group}. The \meta{id} of the equal height group is chosen automatically, but it may be set manually by \refKey{/tcb/raster equal height group}. + Also see \refKey{/tcb/minimum for current equal height group}. Feasible values for \meta{type} are: \begin{itemize} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty index 560b9b45b3e..0fbf2d64a0b 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty @@ -68,11 +68,11 @@ \tcbmakedocSubKey{newTcbKey}{tcb/new} \tcbmakedocSubKey{boxTcbKey}{tcb/boxtitle} \tcbmakedocSubKey{extTcbKey}{tcb/external} +\tcbmakedocSubKey{vigTcbKey}{tcb/vig} \tcbmakedocSubKey{docTikzKey}{tikz} \def\tikzname{Ti\emph{k}Z} -\makeatletter \newrobustcmd{\tcbIndexPrintSkinCA}[1]{\tcb@Index@Print@CA{#1}{\kvtcb@col@key}{Skin}} \newrobustcmd{\tcbIndexPrintSkinC}[1]{\tcb@Index@Print@C{#1}{\kvtcb@col@key}} \def\tcb@index@Skin#1{\iftcb@doc@toindex\index{#1\idx@actual\tcbIndexPrintSkinCA{#1}}\index{Skins\idx@level#1\idx@actual\tcbIndexPrintSkinC{#1}}\fi}% @@ -83,7 +83,16 @@ \end{tcb@doc@head}}% {\end{tcb@manual@entry}} \def\refSkin{\tcb@ref@doc{skin}} -\makeatother + +\newrobustcmd{\tcbIndexPrintFadCA}[1]{\tcb@Index@Print@CA{#1}{\kvtcb@col@value}{fading}} +\newrobustcmd{\tcbIndexPrintFadC}[1]{\tcb@Index@Print@C{#1}{\kvtcb@col@value}} +\def\tcb@Print@Fad#1{\textcolor{\kvtcb@col@value}{\bfseries\tcb@scantokens{#1}}} +\def\tcb@index@Fad#1{\iftcb@doc@toindex\kvtcb@index@command{#1\idx@actual\tcbIndexPrintFadCA{#1}}\kvtcb@index@command{Fadings\idx@level#1\idx@actual\tcbIndexPrintFadC{#1}}\fi} + +\DeclareDocumentCommand\docFading{sm}{% + \tcb@Print@Fad{#2}% + \IfBooleanTF{#1}{}{\tcb@index@Fad{#2}}% +} \newtcolorbox{marker}[1][]{enhanced, before skip=2mm,after skip=3mm, @@ -146,6 +155,8 @@ tcbincludegraphics,tcbincludepdf,pdfpages,imagepage,imagepath,imagename, tcbline,tcboxedtitleheight,tcboxedtitlewidth, tcbsettowidthofnode,tcbsetmacrotowidthofnode,tcbsettoheightofnode,tcbsetmacrotoheightofnode, + % vignette + tcbvignette, % xparse DeclareTColorBox,NewTColorBox,RenewTColorBox,ProvideTColorBox, DeclareTotalTColorBox,NewTotalTColorBox,RenewTotalTColorBox,ProvideTotalTColorBox, @@ -185,7 +196,7 @@ after skip=8pt plus 4pt minus 2pt }, base example/.style={bicolor, - beforeafter example,arc is angular, + beforeafter example,arc is angular,fonttitle=\bfseries, fontlower=\footnotesize, colframe=Blue_Dark, colback=Blue_Bright, diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex index 86d55451b8e..0ef0f86af09 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex @@ -25,7 +25,8 @@ This also loads the package |amsmath|. used only in rare cases. The first mandatory parameter is the title text for the theorem and the second mandatory parameter is a \meta{marker}. The theorem is - automatically labeled with \meta{prefix}|:|\meta{marker}.\par + automatically labeled with \meta{prefix}\meta{separator}\meta{marker} + where \meta{separator} is predefined as '|:|', see \refKey{/tcb/label separator}.\par The new environment \meta{name}|*| takes one optional and one mandatory parameter and represents an unnumbered variant of the environment \meta{name}. This variant is not labeled and not listed in lists of theorems. @@ -89,7 +90,8 @@ This also loads the package |amsmath|. used only in rare cases. The first mandatory parameter is the title text for the theorem and the second mandatory parameter is a \meta{marker}. The theorem is - automatically labeled with \meta{prefix}|:|\meta{marker}. + automatically labeled with \meta{prefix}\meta{separator}\meta{marker} + where \meta{separator} is predefined as '|:|', see \refKey{/tcb/label separator}. \end{deprecated} \end{docCommand} @@ -355,6 +357,24 @@ Sets \refKey{/tcb/terminator sign} to the default empty text. \end{docTcbKey} +\begin{docTcbKey}[][doc new=2016-04-19]{label separator}{=\meta{separator}}{no default, initially |:|} + The given \meta{separator} is used for labels created with environments which + are defined themselves by \refCom{newtcbtheorem}. This \meta{separator} is + put between \meta{prefix} (defined by \refCom{newtcbtheorem}) + and \meta{marker} (defined by an actual theorem environment). +\begin{dispExample} +\newtcbtheorem[use counter from=mytheo]{sometheorem}{Theorem}% + {colback=white,colframe=red!50!black,fonttitle=\bfseries, + label separator=*}{theo} +\begin{sometheorem}{My example}{myex} +My theorem text. +\end{sometheorem} +See Example~\ref{theo*myex}. +\end{dispExample} +\end{docTcbKey} + + +\clearpage \begin{docTcbKey}{theorem name and number}{}{style, no value, initially set} Prints theorem name followed by theorem number inside the title. \begin{dispExample} @@ -367,7 +387,7 @@ My theorem text. \end{dispExample} \end{docTcbKey} -\clearpage + \begin{docTcbKey}{theorem number and name}{}{style, no value} Prints theorem number followed by theorem name inside the title. \begin{dispExample} @@ -392,7 +412,7 @@ My theorem text. \end{dispExample} \end{docTcbKey} - +\clearpage \begin{docTcbKey}{theorem}{=\marg{display name}\marg{counter}\marg{title}\marg{marker}}{no default} This key is internally used by \refCom{tcbmaketheorem}, but can be used directly in a |tcolorbox| for a more flexible approach. @@ -412,7 +432,7 @@ created by hand or using \refCom{tcbmaketheorem} or using its successor \refCom{newtcbtheorem}. \end{docTcbKey} -\clearpage + \begin{docTcbKey}{highlight math}{}{style, no value} Predefined style which is used for \refCom{tcbhighmath}. It can be changed comfortable with \refKey{/tcb/highlight math style}. @@ -439,6 +459,7 @@ created by hand or using \refCom{tcbmaketheorem} or using its successor \end{dispExample} \end{docTcbKey} +\clearpage \begin{docTcbKey}{math upper}{}{style, no value} Sets the upper part to mathematical mode with font |\displaystyle|. \end{docTcbKey} @@ -457,7 +478,6 @@ created by hand or using \refCom{tcbmaketheorem} or using its successor \end{docTcbKey} -\clearpage \begin{marker} The following styles are only tested to work with the original |amsmath| environments. If e.g. the |equation| environment is redefined as |gather|, then @@ -495,6 +515,7 @@ created by hand or using \refCom{tcbmaketheorem} or using its successor of the lower part. \end{docTcbKey} +\enlargethispage*{1cm} \begin{docTcbKey}[][doc updated=2014-10-30]{ams equation*}{}{style, no value} Adds an |amsmath| |equation*| environment to the start and end of the upper \emph{and} lower part. diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.vignette.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.vignette.tex new file mode 100644 index 00000000000..fc80dc54dfd --- /dev/null +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.vignette.tex @@ -0,0 +1,747 @@ +% !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:2015a}. + + +\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} + +\clearpage +\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} + +\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} + +\clearpage +\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-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:2015a} 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*} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf Binary files differindex b0c98874c31..bf0fe95bc50 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex index 74d604ca65d..52e8c18975c 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex @@ -1,5 +1,5 @@ % \LaTeX-Main\ -%% The LaTeX package tcolorbox - version 3.90 (2016/02/29) +%% The LaTeX package tcolorbox - version 3.91 (2016/04/27) %% tcolorbox.tex: Manual %% %% ------------------------------------------------------------------------------------------- @@ -29,14 +29,15 @@ \RequirePackage{csquotes} \RequirePackage[style=numeric-comp,sorting=nyt, - maxnames=8,minnames=8,abbreviate=false,backend=biber]{biblatex} + maxnames=8,minnames=8,abbreviate=false,backend=biber, + bibencoding=latin1,texencoding=ascii]{biblatex} \DeclareFieldFormat{url}{\newline\url{#1}}% \DeclareListFormat{language}{}% \setlength{\bibitemsep}{\smallskipamount} \addbibresource{tcolorbox.doc.bib} -\def\version{3.90}% -\def\datum{2016/02/29}% +\def\version{3.91}% +\def\datum{2016/04/27}% \makeindex \hypersetup{ @@ -48,8 +49,17 @@ \usepackage{pgfplots} +%\nocite{*} + +% intermediate hack to compensate a biblatex error (3.4) +\makeatletter +\def\ifempty#1{% + \protected@edef\z{#1}% + \expandafter\ifblank\expandafter{\z}} +\makeatother + %\tcbset{draftmode} -%\includeonly{tcolorbox.doc.skins} +%\includeonly{tcolorbox.doc.intro} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \begin{document} @@ -66,6 +76,7 @@ \include{tcolorbox.doc.skins} \include{tcolorbox.doc.graphics} \include{tcolorbox.doc.filling} +\include{tcolorbox.doc.vignette} \include{tcolorbox.doc.raster} \include{tcolorbox.doc.listings} \include{tcolorbox.doc.theorems} |