diff options
Diffstat (limited to 'Master')
32 files changed, 1252 insertions, 74 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} diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbbreakable.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbbreakable.code.tex index a66a929fae7..3618a0255cd 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbbreakable.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbbreakable.code.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) %% tcbbreakable.code.tex: Code for breakable colorboxes %% %% ------------------------------------------------------------------------------------------- @@ -17,7 +17,7 @@ %% %% This work consists of all files listed in README %% -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \let\tcb@parboxrestore@true=\tcb@parboxrestore \let\tcb@parboxrestore@false\tcb@parbox@false@settings diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbdocumentation.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbdocumentation.code.tex index f813d8ecb14..bd32634d4b7 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbdocumentation.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbdocumentation.code.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) %% tcbdocumentation.code.tex: Code for LaTeX documentations %% %% ------------------------------------------------------------------------------------------- @@ -17,7 +17,7 @@ %% %% This work consists of all files listed in README %% -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \tcbuselibrary{listings,skins,xparse,external} diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbexternal.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbexternal.code.tex index 9f4a67717c8..16100d92048 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbexternal.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbexternal.code.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) %% tcbexternal.code.tex: Code for externalization %% %% ------------------------------------------------------------------------------------------- @@ -17,7 +17,7 @@ %% %% This work consists of all files listed in README %% -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} { \catcode`\"=12 diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbfitting.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbfitting.code.tex index 14b76fc8a97..fe06d6ca36f 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbfitting.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbfitting.code.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) %% tcbfitting.code.tex: Code for fit boxes %% %% ------------------------------------------------------------------------------------------- @@ -18,7 +18,7 @@ %% This work consists of all files listed in README %% %\makeatletter -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \newdimen\tcbfitdim \newdimen\tcb@lowerfitdim diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbhooks.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbhooks.code.tex index 63e0fb91139..8a0dc9f06ee 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbhooks.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbhooks.code.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) %% tcbhooks.code.tex: Code for adding hooks %% %% ------------------------------------------------------------------------------------------- @@ -18,7 +18,7 @@ %% This work consists of all files listed in README %% %\makeatletter -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \tcbset{% before upper app/.code={\appto\kvtcb@before@upper{#1}},% diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcblistings.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcblistings.code.tex index 5c06ee8db89..90d62d37c35 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcblistings.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcblistings.code.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) %% tcblistings.code.tex: Code for colorboxes with listings %% %% ------------------------------------------------------------------------------------------- @@ -18,7 +18,7 @@ %% This work consists of all files listed in README %% %\makeatletter -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \RequirePackage{listings}[2007/02/22] diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcblistingscore.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcblistingscore.code.tex index e5211fdc781..0263c476cb4 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcblistingscore.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcblistingscore.code.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) %% tcblistingscode.code.tex: Auxiliary code for colorboxes with listings %% %% ------------------------------------------------------------------------------------------- @@ -18,7 +18,7 @@ %% This work consists of all files listed in README %% %\makeatletter -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \RequirePackage{pdftexcmds} diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcblistingsutf8.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcblistingsutf8.code.tex index 9c3bc9dd7b6..7a29fe1cd7c 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcblistingsutf8.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcblistingsutf8.code.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) %% tcblistingsutf8.code.tex: Code for colorboxes with listings in UTF-8 %% %% ------------------------------------------------------------------------------------------- @@ -17,7 +17,7 @@ %% %% This work consists of all files listed in README %% -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \RequirePackage{listingsutf8}[2011/11/10] \tcbuselibrary{listings} diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbmagazine.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbmagazine.code.tex index d65b9e769ce..51684b96a8c 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbmagazine.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbmagazine.code.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) %% tcbmagazine.code.tex: Code for box sets and magazine styles %% %% ------------------------------------------------------------------------------------------- @@ -17,7 +17,7 @@ %% %% This work consists of all files listed in README %% -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \tcbuselibrary{breakable} diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbminted.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbminted.code.tex index 16af5e8e9f2..df752c63a0c 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbminted.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbminted.code.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) %% tcbminted.code.tex: Code for colorboxes with listings %% %% ------------------------------------------------------------------------------------------- @@ -18,7 +18,7 @@ %% This work consists of all files listed in README %% %\makeatletter -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \RequirePackage{minted}[2011/09/17] @@ -27,15 +27,14 @@ \def\tcb@minted@input@listing#1#2#3#4{% \edef\temp@a{#4}% \ifx\temp@a\@empty% - \else - %\usemintedstyle{\temp@a}% + \else% \toks@=\expandafter{#4}% \edef\tcb@temp{\noexpand\usemintedstyle{\the\toks@}}% \tcb@temp% \fi% \toks@=\expandafter{#1}% \edef\tcb@temp{\noexpand\inputminted[\the\toks@]}% - \tcb@temp{#2}{#3}% + \tcb@temp{#2}{\minted@outputdir#3}% } \def\tcb@minted@uselistinglisting{% diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbraster.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbraster.code.tex index 7d2269d3519..8d29897a05e 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbraster.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbraster.code.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) %% tcbskinsjigsaw.code.tex: Code for colorboxes with different skins %% %% ------------------------------------------------------------------------------------------- @@ -17,7 +17,7 @@ %% %% This work consists of all files listed in README %% -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \newcounter{tcbrastercolumn} \newcounter{tcbrasterrow} @@ -228,3 +228,7 @@ \newenvironment{tcboxedraster}[2][]{% \tcolorbox[#2]\tcbraster[#1]}% {\endtcbraster\endtcolorbox} + +\newenvironment{tcboxeditemize}[2][]{% + \tcolorbox[#2]\tcbitemize[#1]}% + {\endtcbitemize\endtcolorbox} diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbskins.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbskins.code.tex index 9bc4926d41d..ea9958de51c 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbskins.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbskins.code.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) %% tcbskins.code.tex: Code for colorboxes with different skins %% %% ------------------------------------------------------------------------------------------- @@ -17,7 +17,7 @@ %% %% This work consists of all files listed in README %% -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \RequirePackage{tikz}[2010/10/13] @@ -175,7 +175,7 @@ } \def\tcb@draw@pseudo@segmentation#1{% -\begingroup\tcb@shield@externalize\begin{tikzpicture}% +\begingroup\tcb@shield@externalize\noindent\begin{tikzpicture}% \path[use as bounding box] (0,{\the\dimexpr-\kvtcb@middle-\kvtcb@boxsep\relax}) rectangle (\linewidth,{\the\dimexpr\kvtcb@middle+\kvtcb@boxsep\relax}); \node[line width=0mm,inner sep=0mm,draw=none,fill=none,rectangle, diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbskinsjigsaw.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbskinsjigsaw.code.tex index 6325257bebd..a790ddc43d9 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbskinsjigsaw.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbskinsjigsaw.code.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) %% tcbskinsjigsaw.code.tex: Code for colorboxes with different skins %% %% ------------------------------------------------------------------------------------------- @@ -17,7 +17,7 @@ %% %% This work consists of all files listed in README %% -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \tcbuselibrary{skins} diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbtheorems.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbtheorems.code.tex index e01802d9c7b..d1fb74a6faf 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbtheorems.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbtheorems.code.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) %% tcbtheorems.code.tex: Code for theorems in colorboxes %% %% ------------------------------------------------------------------------------------------- @@ -18,7 +18,7 @@ %% This work consists of all files listed in README %% %\makeatletter -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \RequirePackage{amsmath} @@ -51,7 +51,7 @@ \def\temp@a{#2}% \ifx\temp@a\@empty% \else% - \tcbset{label={#1:#2}}% + \tcbset{label={#1\kvtcb@label@sep#2}}% \fi% } @@ -104,6 +104,7 @@ terminator sign colon/.style={terminator sign={:}},% terminator sign dash/.style={terminator sign={\ --}},% terminator sign none/.style={terminator sign=},% + label separator/.store in=\kvtcb@label@sep,% description delimiters/.code 2 args={\def\kvtcb@desc@delim@left{#1}\def\kvtcb@desc@delim@right{#2}},% description delimiters parenthesis/.style={description delimiters=()}, description delimiters none/.style={description delimiters={}{}}, @@ -152,7 +153,7 @@ \new@tcbtheorem} \newcommand{\tcbmaketheorem}[5]{% - \newtcolorbox{#1}[3][]{#3,theorem={#2}{#4}{##2}{#5:##3},##1}% + \newtcolorbox{#1}[3][]{#3,theorem={#2}{#4}{##2}{#5\kvtcb@label@sep##3},##1}% } \newtcbox{\tcboxmath}[1][]{nobeforeafter,math upper,tcbox raise base,#1} @@ -162,7 +163,7 @@ reset@theorems/.style={% description formatter,description color,description font, highlight math style={colframe=red,colback=yellow!25!white},% - theorem style=standard,% + theorem style=standard,label separator=:,% }, initialize@reset=reset@theorems, } diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbvignette.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbvignette.code.tex new file mode 100644 index 00000000000..18b92028d32 --- /dev/null +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbvignette.code.tex @@ -0,0 +1,313 @@ +%% The LaTeX package tcolorbox - version 3.91 (2016/04/27) +%% tcbvignette.code.tex: Code for ornamental frames +%% +%% ------------------------------------------------------------------------------------------- +%% Copyright (c) 2006-2016 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de> +%% ------------------------------------------------------------------------------------------- +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either version 1.3 +%% of this license or (at your option) any later version. +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3 or later is part of all distributions of LaTeX +%% version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status `author-maintained'. +%% +%% This work consists of all files listed in README +%% +\tcb@set@library@version{3.91} + +\tcbuselibrary{skins} + +\usetikzlibrary{fadings} + +\pgfdeclarehorizontalshading{tcb@fade@east}{100bp} +{color(0bp)=(pgftransparent!50); color(25bp)=(pgftransparent!50); + color(75bp)=(pgftransparent!100); color(100bp)=(pgftransparent!100)} + +\pgfdeclarehorizontalshading{tcb@fade@west}{100bp} +{color(0bp)=(pgftransparent!100); color(25bp)=(pgftransparent!100); + color(75bp)=(pgftransparent!50); color(100bp)=(pgftransparent!50)} + +\pgfdeclareverticalshading{tcb@fade@north}{100bp} +{color(0bp)=(pgftransparent!50); color(25bp)=(pgftransparent!50); + color(75bp)=(pgftransparent!100); color(100bp)=(pgftransparent!100)} + +\pgfdeclareverticalshading{tcb@fade@south}{100bp} +{color(0bp)=(pgftransparent!100); color(25bp)=(pgftransparent!100); + color(75bp)=(pgftransparent!50); color(100bp)=(pgftransparent!50)} + +\pgfdeclarefading{semi east}{\pgfuseshading{tcb@fade@east}} +\pgfdeclarefading{semi west}{\pgfuseshading{tcb@fade@west}} +\pgfdeclarefading{semi north}{\pgfuseshading{tcb@fade@north}} +\pgfdeclarefading{semi south}{\pgfuseshading{tcb@fade@south}} + +\def\tcb@vig@draw@north#1{\path[#1]\pgfextra{% + \pgfpathmoveto{\pgfqpoint{\tcb@vig@xA}{\tcb@vig@yB}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xB}{\tcb@vig@yB}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xb}{\tcb@vig@yb}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xa}{\tcb@vig@yb}}% + \pgfpathclose};} + +\def\tcb@vig@draw@east#1{\path[#1]\pgfextra{% + \pgfpathmoveto{\pgfqpoint{\tcb@vig@xB}{\tcb@vig@yB}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xB}{\tcb@vig@yA}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xb}{\tcb@vig@ya}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xb}{\tcb@vig@yb}}% + \pgfpathclose};} + +\def\tcb@vig@draw@south#1{\path[#1]\pgfextra{% + \pgfpathmoveto{\pgfqpoint{\tcb@vig@xB}{\tcb@vig@yA}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xA}{\tcb@vig@yA}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xa}{\tcb@vig@ya}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xb}{\tcb@vig@ya}}% + \pgfpathclose};} + +\def\tcb@vig@draw@west#1{\path[#1]\pgfextra{% + \pgfpathmoveto{\pgfqpoint{\tcb@vig@xA}{\tcb@vig@yA}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xA}{\tcb@vig@yB}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xa}{\tcb@vig@yb}}% + \pgfpathlineto{\pgfqpoint{\tcb@vig@xa}{\tcb@vig@ya}}% + \pgfpathclose};} + +\def\tcb@vig@draw@direct{% + \ifdim\tcb@vig@yB>\tcb@vig@yb\relax% + \begingroup\edef\x{\endgroup\noexpand\tcb@vig@draw@north{fill,draw=none,\expandonce\tcb@vig@style@north}}\x% + \fi% + \ifdim\tcb@vig@xB>\tcb@vig@xb\relax% + \begingroup\edef\x{\endgroup\noexpand\tcb@vig@draw@east{fill,draw=none,\expandonce\tcb@vig@style@east}}\x% + \fi% + \ifdim\tcb@vig@yA<\tcb@vig@ya\relax% + \begingroup\edef\x{\endgroup\noexpand\tcb@vig@draw@south{fill,draw=none,\expandonce\tcb@vig@style@south}}\x% + \fi% + \ifdim\tcb@vig@xA<\tcb@vig@xa\relax% + \begingroup\edef\x{\endgroup\noexpand\tcb@vig@draw@west{fill,draw=none,\expandonce\tcb@vig@style@west}}\x% + \fi% +} + +\def\tcb@vig@draw@clipped{% + \ifdim\tcb@vig@yB>\tcb@vig@yb\relax% + \begin{scope} + \tcb@vig@draw@north{clip}% + \begingroup\edef\x{\endgroup\noexpand\path[fill,\expandonce\tcb@vig@style@north]}% + \x\pgfextra{\pgfpathrectanglecorners{\pgfpoint{\tcb@vig@xA-1mm}{\tcb@vig@yb}}% + {\pgfpoint{\tcb@vig@xB+1mm}{\tcb@vig@yB}}}; + \end{scope} + \fi% + \ifdim\tcb@vig@xB>\tcb@vig@xb\relax% + \begin{scope} + \tcb@vig@draw@east{clip}% + \begingroup\edef\x{\endgroup\noexpand\path[fill,\expandonce\tcb@vig@style@east]}% + \x\pgfextra{\pgfpathrectanglecorners{\pgfpoint{\tcb@vig@xb}{\tcb@vig@yA-1mm}}% + {\pgfpoint{\tcb@vig@xB}{\tcb@vig@yB+1mm}}}; + \end{scope} + \fi% + \ifdim\tcb@vig@yA<\tcb@vig@ya\relax% + \begin{scope} + \tcb@vig@draw@south{clip}% + \begingroup\edef\x{\endgroup\noexpand\path[fill,\expandonce\tcb@vig@style@south]}% + \x\pgfextra{\pgfpathrectanglecorners{\pgfpoint{\tcb@vig@xA-1mm}{\tcb@vig@yA}}% + {\pgfpoint{\tcb@vig@xB+1mm}{\tcb@vig@ya}}}; + \end{scope} + \fi% + \ifdim\tcb@vig@xA<\tcb@vig@xa\relax% + \begin{scope} + \tcb@vig@draw@west{clip}% + \begingroup\edef\x{\endgroup\noexpand\path[fill,\expandonce\tcb@vig@style@west]}% + \x\pgfextra{% + \pgfpathrectanglecorners{\pgfpoint{\tcb@vig@xA}{\tcb@vig@yA-1mm}}% + {\pgfpoint{\tcb@vig@xa}{\tcb@vig@yB+1mm}}}; + \end{scope} + \fi% +} + +\newcommand{\tcbvignette}[1]{% + \ifdefined\pgfpictureid% + \tcbset{vig/.cd,#1}% + \tcbdimto\tcb@vig@xA{\tcb@vig@xmin}% + \tcbdimto\tcb@vig@xB{\tcb@vig@xmax}% + \tcbdimto\tcb@vig@yA{\tcb@vig@ymin}% + \tcbdimto\tcb@vig@yB{\tcb@vig@ymax}% + \tcbdimto\tcb@vig@xa{\tcb@vig@xA+\tcb@vig@size@west}% + \tcbdimto\tcb@vig@xb{\tcb@vig@xB-(\tcb@vig@size@east)}% + \tcbdimto\tcb@vig@ya{\tcb@vig@yA+\tcb@vig@size@south}% + \tcbdimto\tcb@vig@yb{\tcb@vig@yB-(\tcb@vig@size@north)}% + \tcb@vig@draw% + \else% + \tcb@warning{'tcbvignette' was found outside a 'tikzpicture' environment and is ignored}% + \fi% +} + +\tcbset{% + vig/.cd, + xmin/.store in=\tcb@vig@xmin, + xmax/.store in=\tcb@vig@xmax, + ymin/.store in=\tcb@vig@ymin, + ymax/.store in=\tcb@vig@ymax, + lower left corner/.code={\tcb@gettikzxy{(#1)}{\tcb@vig@xmin}{\tcb@vig@ymin}}, + upper right corner/.code={\tcb@gettikzxy{(#1)}{\tcb@vig@xmax}{\tcb@vig@ymax}}, + % + inside node/.style={lower left corner={#1.south west},upper right corner={#1.north east}}, + outside node/.style={lower left corner={[xshift=-\tcb@vig@size@west,yshift=-\tcb@vig@size@south]#1.south west}, + upper right corner={[xshift=\tcb@vig@size@east,yshift=\tcb@vig@size@north]#1.north east}}, + % + on node/.style={lower left corner={#1.south west},upper right corner={#1.north east}}, + over node offset/.store in=\tcb@vig@onoffset,% + over node/.style={lower left corner={[xshift=-\tcb@vig@onoffset,yshift=-\tcb@vig@onoffset]#1.south west}, + upper right corner={[xshift=\tcb@vig@onoffset,yshift=\tcb@vig@onoffset]#1.north east}}, + north size/.store in=\tcb@vig@size@north, + south size/.store in=\tcb@vig@size@south, + east size/.store in=\tcb@vig@size@east, + west size/.store in=\tcb@vig@size@west, + vertical size/.style={north size=#1,south size=#1}, + horizontal size/.style={east size=#1,west size=#1}, + size/.style={north size=#1,south size=#1,east size=#1,west size=#1}, + north style/.store in=\tcb@vig@style@north, + south style/.store in=\tcb@vig@style@south, + east style/.store in=\tcb@vig@style@east, + west style/.store in=\tcb@vig@style@west, + draw method/.is choice, + draw method/direct/.code={\let\tcb@vig@draw\tcb@vig@draw@direct},% + draw method/clipped/.code={\let\tcb@vig@draw\tcb@vig@draw@clipped},% + base color/.colorlet=tcbcol@vig@base, + raised color/.style={% + base color=#1, + north style={tcbcol@vig@base!50!white}, + east style={tcbcol@vig@base!75!black}, + south style={tcbcol@vig@base!50!black}, + west style={tcbcol@vig@base!75!white}, + }, + lowered color/.style={% + base color=#1, + north style={tcbcol@vig@base!50!black}, + east style={tcbcol@vig@base!75!white}, + south style={tcbcol@vig@base!50!white}, + west style={tcbcol@vig@base!75!black}, + }, + color from/.style args={#1 to #2}{% + north style={bottom color=#1,top color=#2}, + east style={left color=#1,right color=#2}, + south style={top color=#1,bottom color=#2}, + west style={right color=#1,left color=#2}, + }, + fade in/.style={% + north style={#1,path fading=south}, + east style={#1,path fading=west}, + south style={#1,path fading=north}, + west style={#1,path fading=east}, + }, + fade in/.default=white, + fade out/.style={% + north style={#1,path fading=north}, + east style={#1,path fading=east}, + south style={#1,path fading=south}, + west style={#1,path fading=west}, + }, + fade out/.default=white, + semi fade in/.style={% + north style={#1,path fading=semi south}, + east style={#1,path fading=semi west}, + south style={#1,path fading=semi north}, + west style={#1,path fading=semi east}, + }, + semi fade in/.default=white, + semi fade out/.style={% + north style={#1,path fading=semi north}, + east style={#1,path fading=semi east}, + south style={#1,path fading=semi south}, + west style={#1,path fading=semi west}, + }, + semi fade out/.default=white, + % + draw method=direct, + xmin=0pt, + xmax=1cm, + ymin=0pt, + ymax=1cm, + size=2mm, + over node offset=0.1mm, + raised color=red, +} + +\tcbset{% + finish@vignette/.style 2 args={finish #1={% + \begin{tcbclipframe}\tcbvignette{% + north style={white,opacity=0.25}, + east style={black!75,opacity=0.25}, + south style={black,opacity=0.25}, + west style={black!25,opacity=0.25},#2,inside node=frame + }\end{tcbclipframe}}}, + finish vignette/.style={% + finish@vignette={unbroken}{#1},% + finish@vignette={first}{#1,south size=0pt},% + finish@vignette={middle}{#1,north size=0pt,south size=0pt},% + finish@vignette={last}{#1,north size=0pt}% + }, +% + finish@raised@vignette/.style 2 args={finish #1={% + \begin{tcbclipframe}\tcbvignette{% + draw method=clipped, + north style={white,path fading=semi south}, + east style={black!75,path fading=semi west}, + south style={black,path fading=semi north}, + west style={black!25,path fading=semi east},#2,inside node=frame + }\end{tcbclipframe}}}, + finish raised fading vignette/.style={% + finish@raised@vignette={unbroken}{#1},% + finish@raised@vignette={first}{#1,south size=0pt},% + finish@raised@vignette={middle}{#1,north size=0pt,south size=0pt},% + finish@raised@vignette={last}{#1,north size=0pt}% + }, +% + finish@fading@vignette/.style 2 args={finish #1={% + \tcbvignette{% + draw method=clipped,fade in=tcbcol@vig@base,#2,over node=frame}}}, + finish fading vignette/.style={% + finish@fading@vignette={unbroken}{base color=white,#1},% + finish@fading@vignette={first}{base color=white,#1,south size=0pt},% + finish@fading@vignette={middle}{base color=white,#1,north size=0pt,south size=0pt},% + finish@fading@vignette={last}{base color=white,#1,north size=0pt}% + }, +% + underlay@vignette/.style 2 args={underlay #1={% + \begin{tcbclipframe}\tcbvignette{% + raised color=tcbcol@frame, + north size=\kvtcb@top@rule@stand, + south size=\kvtcb@bottom@rule@stand, + west size=\kvtcb@left@rule, + east size=\kvtcb@right@rule,#2,inside node=frame + }\end{tcbclipframe}}}, + underlay vignette/.style={% + underlay@vignette={unbroken}{#1},% + underlay@vignette={first}{#1,south size=0pt},% + underlay@vignette={middle}{#1,north size=0pt,south size=0pt},% + underlay@vignette={last}{#1,north size=0pt}% + }, +% + underlay@fading@vignette/.style 2 args={underlay #1={% + \begin{tcbclipframe}\tcbvignette{% + draw method=clipped, + north style={white,path fading=semi south}, + east style={black!75,path fading=semi west}, + south style={black,path fading=semi north}, + west style={black!25,path fading=semi east},#2,inside node=frame, + }\end{tcbclipframe}}}, + underlay raised fading vignette/.style={% + underlay@fading@vignette={unbroken}{#1},% + underlay@fading@vignette={first}{#1,south size=0pt},% + underlay@fading@vignette={middle}{#1,north size=0pt,south size=0pt},% + underlay@fading@vignette={last}{#1,north size=0pt}% + }, + % + underlay raised shading vignette/.style={% + underlay vignette={draw method=clipped, + north style={bottom color=tcbcol@frame,top color=tcbcol@frame!33!white}, + east style={left color=tcbcol@frame,right color=tcbcol@frame!66!black}, + south style={top color=tcbcol@frame,bottom color=tcbcol@frame!33!black}, + west style={right color=tcbcol@frame,left color=tcbcol@frame!66!white},#1}}, + % + underlay shade in vignette/.style={% + underlay vignette={draw method=clipped,color from=tcbcol@back to tcbcol@frame,#1}}, +} diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcbxparse.code.tex b/Master/texmf-dist/tex/latex/tcolorbox/tcbxparse.code.tex index 63d673d955f..9f96afdaeb0 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcbxparse.code.tex +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcbxparse.code.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) %% tcbxparse.code.tex: Code for xparse features %% %% ------------------------------------------------------------------------------------------- @@ -18,7 +18,7 @@ %% This work consists of all files listed in README %% %\makeatletter -\tcb@set@library@version{3.90} +\tcb@set@library@version{3.91} \RequirePackage{xparse}[2013/12/31] diff --git a/Master/texmf-dist/tex/latex/tcolorbox/tcolorbox.sty b/Master/texmf-dist/tex/latex/tcolorbox/tcolorbox.sty index 6bfd79d8556..e8e5424fba0 100644 --- a/Master/texmf-dist/tex/latex/tcolorbox/tcolorbox.sty +++ b/Master/texmf-dist/tex/latex/tcolorbox/tcolorbox.sty @@ -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.sty: Text color boxes %% %% ------------------------------------------------------------------------------------------- @@ -18,8 +18,8 @@ %% This work consists of all files listed in README %% \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{tcolorbox}[2016/02/29 version 3.90 text color boxes] -\def\tcb@version{3.90} +\ProvidesPackage{tcolorbox}[2016/04/27 version 3.91 text color boxes] +\def\tcb@version{3.91} \RequirePackage{pgf}[2008/01/15] \RequirePackage{verbatim}[2003/08/22] @@ -296,11 +296,8 @@ upperbox/invisible/.code={\tcb@uppervisiblefalse}, visible/.style={upperbox=visible,lowerbox=visible}, invisible/.style={upperbox=invisible,lowerbox=invisible}, -% natural height/.code={\tcb@fixedheightfalse\let\tcb@ch=\tcb@ch@natural\let\tcb@height@adjust\@empty}, natural height/.code={\tcb@fixedheightfalse\tcb@@ch@@operation{\tcb@ch@natural}}, -% height/.code={\tcb@fixedheighttrue\tcb@dim@to\kvtcb@height@fixed{#1}\let\tcb@ch=\tcb@ch@fixed\let\tcb@height@adjust\@empty}, height/.code={\tcb@fixedheighttrue\tcb@dim@to\kvtcb@height@fixed{#1}\tcb@@ch@@operation{\tcb@ch@fixed}}, -% text height/.code={\tcb@fixedheighttrue\tcb@dim@to\kvtcb@height@fixed{#1}\let\tcb@ch=\tcb@ch@innerfixed\let\tcb@height@adjust\@empty}, text height/.code={\tcb@fixedheighttrue\tcb@dim@to\kvtcb@height@fixed{#1}\tcb@@ch@@operation{\tcb@ch@innerfixed}}, add to height/.code={\iftcb@fixedheight\tcbdimto\kvtcb@height@fixed{\kvtcb@height@fixed+(#1)}\fi}, add to natural height/.code={\tcb@fixedheightfalse\def\kvtcb@height@natural@plus{#1}\tcb@@ch@@operation{\tcb@ch@natural@plus}}, @@ -309,9 +306,10 @@ height fill/.is choice,% height fill/false/.code={\let\tcb@height@adjust\@empty},% square/.style={height=\kvtcb@width}, -% equal height group/.code={\edef\tcb@ehgid{#1}\let\tcb@ch=\tcb@ch@equalheight\let\tcb@height@adjust\@empty}, equal height group/.code={\tcb@fixedheightfalse\edef\tcb@ehgid{#1}\tcb@@ch@@operation{\tcb@ch@equalheight}}, - minimum for equal height group/.code args={#1:#2}{\edef\tcb@ehgid{#1}\tcb@ehgadd{#2}}, + minimum for equal height group/.code args={#1:#2}{\bgroup\edef\tcb@ehgid{#1}\tcbdimto\tcb@min@ehg{#2}\tcb@ehgadd{\tcb@min@ehg}\egroup}, + minimum for current equal height group/.code={\ifcsundef{tcb@ehgid}{}{% + \tcbset{minimum for equal height group=\tcb@ehgid:#1}}}, use height from group/.code={\ifcsundef{tcb@ehg@height@#1}{}{\tcbset{height=\csuse{tcb@ehg@height@#1}}}}, use height from group/.default={\csuse{tcb@ehgid}}, space/.code={\def\tcb@height@fraction{#1}% @@ -521,7 +519,6 @@ varwidth upper/.default=\kvtcb@width, text fill/.style={before upper={% \ifdim\dimexpr\tcbtextheight>0pt\relax% - %\iftcb@fixedheight% \edef\tcb@temp{\noexpand\minipage[c][\tcbtextheight]}% \else% \let\tcb@temp\minipage% @@ -1033,7 +1030,6 @@ } \def\tcb@ch@fixed@space{% - %\tcbdimto\tcb@height@space{\tcb@height-\tcb@natheight}% \tcbdimto\tcb@height@spaceupper{\tcb@height@fraction\dimexpr\tcbheightspace\relax}% \tcbdimto\tcb@height@upper{\ht\tcb@upperbox+\dp\tcb@upperbox+\tcb@height@spaceupper}% \tcbdimto\tcb@height@lower{\ht\tcb@lowerbox+\dp\tcb@lowerbox+\tcbheightspace-\tcb@height@spaceupper}% @@ -1044,7 +1040,6 @@ } \def\tcb@ch@fixed@spacesave{% - %\tcbdimto\tcb@height@space{\tcb@height-\tcb@natheight}% \tcbdimto\tcb@space{\tcb@space+\tcbheightspace}% \ifdim\dimexpr\tcb@space<0pt\relax \let\tcb@space\tcb@zpt% @@ -1062,7 +1057,6 @@ } \def\tcb@ch@fixed@split{% -% \tcbdimto\tcb@height@space{\tcb@height-\tcb@natheight+\ht\tcb@upperbox+\dp\tcb@upperbox+\ht\tcb@lowerbox+\dp\tcb@lowerbox}% \tcbdimto\tcb@height@space{\tcbheightspace+\ht\tcb@upperbox+\dp\tcb@upperbox+\ht\tcb@lowerbox+\dp\tcb@lowerbox}% \tcbdimto\tcb@height@upper{\tcb@height@fraction\dimexpr\tcb@height@space\relax}% \tcbdimto\tcb@height@lower{\tcb@height@space-\tcb@height@upper}% @@ -1108,8 +1102,7 @@ \fi% }{% \csxdef{tcb@ehg@current@\tcb@ehgid}{#1}% - \edef\tcb@temp{\noexpand\AtEndDocument{\noexpand\tcb@saveehg{\tcb@ehgid}}}% - \tcb@temp% + \begingroup\edef\x{\endgroup\noexpand\AtEndDocument{\noexpand\tcb@saveehg{\tcb@ehgid}}}\x% }% } @@ -2088,10 +2081,11 @@ \tcb@add@library{fitting}{tcbfitting.code.tex} \tcb@add@library{xparse}{tcbxparse.code.tex} \tcb@add@library{external}{tcbexternal.code.tex} +\tcb@add@library{vignette}{tcbvignette.code.tex} \tcb@add@library@style{many}{raster,skins,breakable,hooks,theorems,fitting,xparse} -\tcb@add@library@style{most}{many,listingsutf8,external,magazine} -\tcb@add@library@style{all}{many,minted,listingsutf8,external,magazine,documentation} +\tcb@add@library@style{most}{many,listingsutf8,external,magazine,vignette} +\tcb@add@library@style{all}{many,minted,listingsutf8,external,magazine,vignette,documentation} \ProcessOptions* \begingroup\edef\x{\endgroup\noexpand\tcbuselibrary{\tcb@optionlist}}\x |