summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-03-18 22:07:07 +0000
committerKarl Berry <karl@freefriends.org>2014-03-18 22:07:07 +0000
commit1ae7c2b9cce883c37a23327ae611d51921b8a1b6 (patch)
tree30c54ccafd5c22eb8062943c723a3e5156ab3c61 /Master/texmf-dist/doc/latex/tcolorbox
parentd834f9da1e08f7fab4ec7359c5aaf2d42c63b1fc (diff)
tcolorbox (18mar14)
git-svn-id: svn://tug.org/texlive/trunk@33222 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/CHANGES21
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/README6
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/blueshade.pngbin0 -> 62882 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.pngbin0 -> 21663 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/goldshade.pngbin0 -> 76829 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/pink_marble.pngbin0 -> 15166 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdfbin283402 -> 346953 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex15
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex10
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex7
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex4
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex42
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.picturecredits.tex37
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex353
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin3481400 -> 3785087 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex22
16 files changed, 494 insertions, 23 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index 09fefc3cdde..aa0e2e58f08 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 2.71 (2014/02/21)
+%% The LaTeX package tcolorbox - version 2.72 (2014/03/18)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -428,5 +428,20 @@ version 2.71 (2014/02/21)
'keys', 'index colorize', 'index annotate',
'color command', 'color environment', 'color key', 'color value', 'color color'
-
-
+version 2.72 (2014/03/18)
+- bug fix: mixing \newtcblisting with 'ams align' and similar options was not possíble
+- bug fix: footnotes lost for 'listing outside text' and similar options
+- sidebyside and outside implementation slightly changed for beamer usage
+- bicolor skin respects 'opacityback' for the upper part now
+- new TikZ options:
+ 'fill image opacity', 'fill image options',
+ 'fill plain image', 'fill plain image*', 'fill stretch image', 'fill stretch image*',
+ 'fill overzoom image', 'fill overzoom image*', 'fill zoom image', 'fill zoom image*',
+ 'fill shrink image', 'fill shrink image*', 'fill tile image', 'fill tile image*'
+- library 'skins':
+ * new options:
+ 'frame style image', 'frame style tile', 'interior style image', 'interior style tile',
+ 'title style image', 'title style tile'
+- library 'listings':
+ * new options:
+ 'every listing line', 'every listing line*'
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index c4bb263c551..3d23872cd1a 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 2.71 (2014/02/21)
+%% The LaTeX package tcolorbox - version 2.72 (2014/03/18)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -47,6 +47,10 @@ Contents of the package
'tcolorbox-example.pdf' Compiled example
'Basilica_5.png' Example picture
'lichtspiel.jpg' Example picture
+ 'blueshade.png' Example picture
+ 'crinklepaper.png' Example picture
+ 'goldshade.png' Example picture
+ 'pink_marble.png' Example picture
Installation
============
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/blueshade.png b/Master/texmf-dist/doc/latex/tcolorbox/blueshade.png
new file mode 100644
index 00000000000..4b1713e657c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tcolorbox/blueshade.png
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.png b/Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.png
new file mode 100644
index 00000000000..c030edf7656
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.png
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/goldshade.png b/Master/texmf-dist/doc/latex/tcolorbox/goldshade.png
new file mode 100644
index 00000000000..7e082640532
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tcolorbox/goldshade.png
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/pink_marble.png b/Master/texmf-dist/doc/latex/tcolorbox/pink_marble.png
new file mode 100644
index 00000000000..d3279dff5cf
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tcolorbox/pink_marble.png
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
index 40fd4ce9b05..9b8ab2d3db6 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex
index 5fd04ca11bd..87d09062de5 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 2.71 (2014/02/21)
+%% The LaTeX package tcolorbox - version 2.72 (2014/03/18)
%% tcolorbox-example.tex: an example for tcolorbox
%%
%% -------------------------------------------------------------------------------------------
@@ -40,7 +40,8 @@
Lower part of my box.
\end{tcolorbox}
-\begin{tcolorbox}[colback=yellow!5!white,colframe=yellow!75!black,title=My title]
+\begin{tcolorbox}[colback=yellow!5!white,colframe=yellow!50!black,
+ colbacktitle=yellow!75!black,title=My title]
I can do this also with a title.
\tcblower
Lower part of my box.
@@ -64,6 +65,16 @@
\end{tcolorbox}
+\begin{tcolorbox}[enhanced,frame style image=blueshade.png,
+ opacityback=0.75,opacitybacktitle=0.25,
+ colback=blue!5!white,colframe=blue!75!black,
+ title=My title]
+ This box is filled with an external image.\par
+ Title and interior are made partly transparent to show the image.
+\end{tcolorbox}
+
+
+
\clearpage
%----------------------------------------------------------
\section{\LaTeX-Examples}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
index 795e97388c1..405f891259a 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
@@ -30,7 +30,13 @@
colbacktitle=Navy!15!ExampleBack,top=0mm,before=\par\smallskip,%
listing style=mydocumentation,listing only}
-\hspace{0pt}
+\bigskip
+
+\begin{marker}
+If you have trouble printing this document, the reason is quite likely the
+cover page. Printing the pages starting with page 2 or page 3 should work.
+\end{marker}
+
\clearpage
\begin{center}
\begin{tcolorbox}[enhanced,hbox,tikznode,left=8mm,right=8mm,boxrule=0.4pt,
@@ -57,6 +63,8 @@
\begin{tcolorbox}[breakable,enhanced jigsaw,title={Contents},fonttitle=\bfseries\Large,
colback=yellow!10!white,colframe=red!50!black,before=\par\bigskip\noindent,
+ interior style={fill overzoom image=goldshade.png,fill image opacity=0.25},
+ colbacktitle=red!50!yellow!75!black,
watermark color=yellow!75!red!25!white,pad at break=3mm,
watermark text={\bfseries\Large Contents},
%enlargepage=2\baselineskip,
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 b2770352663..4b339d30172 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
@@ -748,15 +748,14 @@ This is the lower part.
% \usepackage{changepage} for 'check odd page'
% \usepackage{lipsum}
% \usetikzlibrary{patterns}
-% \tcbuselibrary{skins,breakable,hooks}
+% \tcbuselibrary{skins,breakable}
\begin{tcolorbox}[skin=enhancedmiddle,breakable,
check odd page,toggle left and right,
boxrule=0mm,top=0mm,bottom=0mm,left=1mm,right=1mm,
rightrule=1cm,colupper=blue!25!black,
- watermark graphics=lichtspiel.jpg,watermark opacity=0.5,
- watermark overzoom=1.00,watermark opacity=0.25,
+ interior style={fill overzoom image=lichtspiel.jpg,fill image opacity=0.25},
frame style={pattern=crosshatch dots light steel blue},
- overlay app={%
+ overlay={%
\ifoddpage\coordinate (X) at ([xshift=-5mm]frame.east);
\else\coordinate (X) at ([xshift=5mm]frame.west);\fi
\fill[shading=ball,ball color=blue!50!white,opacity=0.5] (X) circle (4mm);}]
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 4432811ab50..043f8d61196 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.intro.tex
@@ -159,7 +159,9 @@ The following keys are used inside |\tcbuselibrary| respectively
\begin{tcolorbox}[title={Package \texttt{tcolorbox}},center title,fonttitle=\bfseries,arc=0pt,
- colback=red!10!white,colframe=red!50!black]
+ colback=red!10!white,
+ interior style={fill tile image*={width=2cm}{pink_marble.png},fill image opacity=0.5},
+ colframe=red!50!black]
\begin{tcolorbox}[beamer,adjusted title=Basic Features,colframe=blue!50!black,colback=blue!10!white]
Base package
\end{tcolorbox}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
index 6627745ba61..041e9281896 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
@@ -367,8 +367,44 @@ Note that listings outside \refEnv{tcblisting} and
Typically, a user is not expected to use this key at all.
\end{docTcbKey}
+\begin{docTcbKey}{every listing line}{=\meta{text}}{no default, initially unset/empty}
+Inserts some \meta{text} to the begin of every line of a listing.
+Note that this a hack of the |listings| package code. This may become unusable
+or superfluous in the future.
+\begin{dispExample}
+\newtcblisting{commandshell}{colback=black,colupper=white,colframe=yellow!75!black,
+ listing only,listing options={style=tcblatex,language=sh},
+ every listing line={\textcolor{red}{\small\ttfamily\bfseries root \$> }}}
+
+\begin{commandshell}
+ls -al
+cd /usr/lib
+\end{commandshell}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{every listing line*}{=\meta{text}}{no default, initially unset/empty}
+Identical to \refKey{/tcb/every listing line} plus additional enlargement
+of \refKey{/tcb/rightupper} by the width of \meta{text}. Therefore, this
+option has to be used after the geometry settings are done.
+This option is intended to be used in conjunction with \refKey{/tcb/hbox}.
+
+\begin{dispExample}
+\newtcblisting{commandshell}{colback=black,colupper=white,colframe=yellow!75!black,
+ listing only,listing options={style=tcblatex,language=sh},hbox,
+ every listing line*={\textcolor{red}{\small\ttfamily\bfseries root \$> }}}
+
+\begin{commandshell}
+ls -al
+cd /usr/lib
+\end{commandshell}
+\end{dispExample}
+\end{docTcbKey}
+
See further options in \Vref{sec:commonlistingkeys}.
+\clearpage
\subsection{Option Keys of the \mylib{listingsutf8} Library}
The \mylib{listingsutf8} library is an extension of the
\mylib{listings} library, so
@@ -384,7 +420,7 @@ all options from \Vref{sec:speclistingkeys} are applicable.
See further options in \Vref{sec:commonlistingkeys}.
-
+\clearpage
\subsection{Option Keys of the \mylib{minted} Library}
\begin{docTcbKey}{minted language}{=\meta{programming language}}{no default, initially |latex|}
@@ -403,7 +439,7 @@ public class HelloWorld {
\end{dispExample}
\end{docTcbKey}
-\clearpage
+
\begin{docTcbKey}{minted options}{=\meta{key list}}{no default, initially |tabsize=2,fontsize=\textbackslash small|}
Sets the options from the package |minted| \cite{rudolph:2011a}
which are used during typesetting of the listing.
@@ -427,7 +463,7 @@ public class HelloWorld {
\end{dispExample}
\end{docTcbKey}
-
+\clearpage
\begin{docTcbKey}{minted style}{=\meta{style}}{no default, initially unset}
Sets a \meta{style} known to |Pygments| \cite{pygments:2013}. This is
independent from \refKey{/tcb/minted options}. Note that styles are always
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.picturecredits.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.picturecredits.tex
new file mode 100644
index 00000000000..c39429d7d54
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.picturecredits.tex
@@ -0,0 +1,37 @@
+% !TeX root = tcolorbox.tex
+% include file of tcolorbox.tex (manual of the LaTeX package tcolorbox)
+\clearpage
+\section{Picture Credits}
+The following pictures were used inside this documentation.
+
+\def\parorfillfill{\hfill\global\let\parorfill\parorfillpar}
+\def\parorfillpar{\par\global\let\parorfill\parorfillfill}
+\let\parorfill\parorfillfill
+
+\newcommand{\diabox}[3][]{%
+ \begin{tcolorbox}[bicolor,before=,after=\parorfill,equal height group=diabox,width=7.9cm,
+ fonttitle=\bfseries\ttfamily,adjusted title=\detokenize{#2},center title,
+ colframe=blue!20!black,leftupper=0mm,rightupper=0mm,colback=black!75!white,#1]
+ \tikz\path[fill zoom image={#2}] (0,0) rectangle (\linewidth,4cm);%
+ \tcblower%
+ #3%
+ \end{tcolorbox}}
+
+\diabox[before=]{Basilica_5.png}{
+ \url{http://commons.wikimedia.org/wiki/File:Basilica_5.png}}
+\diabox{lichtspiel.jpg}{
+ Photograph taken by Thomas F.~Sturm.}
+\diabox{crinklepaper.png}{%
+ Created with |GIMP|.\\
+ \url{http://www.gimp.org}}
+\diabox{pink_marble.png}{%
+ Created with |GIMP|.\\
+ \url{http://www.gimp.org}}
+\diabox{blueshade.png}{%
+ Created with |GIMP|.\\
+ \url{http://www.gimp.org}}
+\diabox{goldshade.png}{%
+ Created with |GIMP|.\\
+ \url{http://www.gimp.org}}
+
+
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
index 3b1fce4615b..256e66803f6 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
@@ -232,6 +232,42 @@ This is the lower part.
\end{docTcbKey}
+\begin{docTcbKey}{frame style image}{=\meta{file name}}{no default, initially unset}
+ Fills the frame with an external image referenced by \meta{file name}.
+ For advanced features like blending of a picture with the background,
+ use \refKey{/tcb/frame style} together with \refKey{/tikz/fill stretch image}.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\tcbset{colback=red!5!white,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ frame style image=blueshade.png]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{frame style tile}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
+ Fills the frame with a tile pattern based on an external image referenced by \meta{file name}.
+ The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
+ For advanced features like blending of a picture with the background,
+ use \refKey{/tcb/frame style} together with \refKey{/tikz/fill tile image}.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\tcbset{colback=red!5!white,coltitle=red!30!black,
+ opacityback=0.75,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ frame style tile={width=1cm}{pink_marble.png}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\clearpage
\begin{docTcbKey}{frame hidden}{}{style, no value}
This is a shortcut for |frame style={draw=none,fill=none}|.
Depending on the skin, this option switches off the drawing of the
@@ -272,7 +308,42 @@ This is the lower part.
\end{dispExample*}
\end{docTcbKey}
+
+\begin{docTcbKey}{interior style image}{=\meta{file name}}{no default, initially unset}
+ Fills the interior with an external image referenced by \meta{file name}.
+ For advanced features like blending of a picture with the background,
+ use \refKey{/tcb/interior style} together with \refKey{/tikz/fill stretch image}.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\tcbset{colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ interior style image=goldshade.png]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
\clearpage
+\begin{docTcbKey}{interior style tile}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
+ Fills the interior with a tile pattern based on an external image referenced by \meta{file name}.
+ The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
+ For advanced features like blending of a picture with the background,
+ use \refKey{/tcb/interior style} together with \refKey{/tikz/fill tile image}.
+
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\tcbset{colframe=red!75!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ interior style tile={width=2cm}{crinklepaper.png}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
\begin{docTcbKey}{interior hidden}{}{style, no value}
This is a shortcut for |interior style={draw=none,fill=none}|.
@@ -315,6 +386,7 @@ This is the lower part.
\end{docTcbKey}
+\clearpage
\begin{docTcbKey}{segmentation hidden}{}{style, no value}
This is a shortcut for |segmentation style={draw=none,fill=none}|.
Depending on the skin, this option switches off the drawing of the
@@ -334,7 +406,6 @@ This is the lower part.
\end{docTcbKey}
-\clearpage
\begin{docTcbKey}{title style}{=\meta{\texttt{\upshape tikz} keys}}{style, no default}
The \meta{\texttt{\upshape tikz} keys} are used inside the |tikz| path command
for drawing the \emph{title area} of the box.\\
@@ -357,6 +428,44 @@ This is the lower part.
\end{docTcbKey}
+\begin{docTcbKey}{title style image}{=\meta{file name}}{no default, initially unset}
+ Fills the title area with an external image referenced by \meta{file name}.
+ For advanced features like blending of a picture with the background,
+ use \refKey{/tcb/title style} together with \refKey{/tikz/fill stretch image}.
+
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\tcbset{colback=blue!5!white,colframe=blue!75!black,
+ fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ title style image=blueshade.png]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\clearpage
+\begin{docTcbKey}{title style tile}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
+ Fills the title area with a tile pattern based on an external image referenced by \meta{file name}.
+ The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
+ For advanced features like blending of a picture with the background,
+ use \refKey{/tcb/title style} together with \refKey{/tikz/fill tile image}.
+
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\tcbset{colback=red!5!white,colframe=red!75!black,
+ coltitle=blue!50!black,fonttitle=\bfseries}
+
+\begin{tcolorbox}[enhanced,title=My title,
+ title style tile={width=1cm}{pink_marble.png}]
+This is a \textbf{tcolorbox}.
+\tcblower
+This is the lower part.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
\begin{docTcbKey}{title hidden}{}{style, no value}
This is a shortcut for |title style={draw=none,fill=none}|.
@@ -3348,3 +3457,245 @@ Nevertheless, this skin can be applied independently.
\end{dispExample}
+\clearpage
+\subsection{TikZ Image Fill Extensions}\label{subsec:tikzimagefilling}
+The \mylib{skins} library adds some image fill options to the vast option set of
+|tikz| \cite{tantau:2013a}. These options can be used in any |tikzpicture|.
+
+\begin{docTikzKey}{fill plain image}{=\meta{file name}}{no default, initially unset}
+ Fills the current path with an external image referenced by \meta{file name}.
+ The image is put in the center of the path, but it is not resized to fit into
+ the path area.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[draw,fill plain image=goldshade.png]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\begin{docTikzKey}{fill plain image*}{=\meta{file name}}{no default, initially unset}
+ Fills the current path with an external image referenced by \meta{file name}.
+ The image is put in the center of the path, but it is not resized to fit into
+ the path area.
+ The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[draw,fill plain image*={width=2.5cm}{goldshade.png}]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\begin{docTikzKey}{fill stretch image}{=\meta{file name}}{no default, initially unset}
+ Fills the current path with an external image referenced by \meta{file name}.
+ The image is stretched to fill the path area.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[fill stretch image=goldshade.png]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\begin{docTikzKey}{fill stretch image*}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
+ Fills the current path with an external image referenced by \meta{file name}.
+ The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
+ The image is stretched to fill the path area.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[fill stretch image*=
+ {angle=90,origin=c}{goldshade.png}]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\begin{docTikzKey}{fill overzoom image}{=\meta{file name}}{no default, initially unset}
+ Fills the current path with an external image referenced by \meta{file name}.
+ The image is zoomed such that the path area fills the image.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[fill overzoom image=goldshade.png]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\begin{docTikzKey}{fill overzoom image*}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
+ Fills the current path with an external image referenced by \meta{file name}.
+ The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
+ The image is zoomed such that the path area fills the image.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[fill overzoom image*=
+ {angle=90,origin=c}{goldshade.png}]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\begin{docTikzKey}{fill zoom image}{=\meta{file name}}{no default, initially unset}
+ Fills the current path with an external image referenced by \meta{file name}.
+ The image is zoomed such that it fits inside the path area.
+ Typically, some parts of the path area will stay unfilled.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[draw,fill zoom image=goldshade.png]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\begin{docTikzKey}{fill zoom image*}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
+ Fills the current path with an external image referenced by \meta{file name}.
+ The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
+ The image is zoomed such that it fits inside the path area.
+ Typically, some parts of the path area will stay unfilled.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[draw,fill zoom image*=
+ {angle=90,origin=c}{goldshade.png}]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+\clearpage
+\begin{docTikzKey}{fill shrink image}{=\meta{file name}}{no default, initially unset}
+ Fills the current path with an external image referenced by \meta{file name}.
+ The image is zoomed such that it fits inside the path area, but it never
+ gets enlarged.
+ Typically, some parts of the path area will stay unfilled.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[draw,fill shrink image=goldshade.png]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\begin{docTikzKey}{fill shrink image*}{=\meta{file name}}{no default, initially unset}
+ Fills the current path with an external image referenced by \meta{file name}.
+ The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
+ The image is zoomed such that it fits inside the path area, but it never
+ gets enlarged.
+ Typically, some parts of the path area will stay unfilled.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[draw,fill shrink image*={width=1.5cm}{goldshade.png}]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+
+\begin{docTikzKey}{fill tile image}{=\meta{file name}}{no default, initially unset}
+ Fills the current path with a tile pattern using an external image referenced by \meta{file name}.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[fill tile image=pink_marble.png]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\begin{docTikzKey}{fill tile image*}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
+ Fills the current path with a tile pattern using an external image referenced by \meta{file name}.
+ The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[fill tile image*={width=1cm}{pink_marble.png}]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\clearpage
+\begin{docTikzKey}{fill image opacity}{=\meta{fraction}}{no default, initially |1.0|}
+ Sets the fill opacity for the image fill options to the given \meta{fraction}.
+\begin{dispExample}
+\begin{tikzpicture}
+\path[fill stretch image=goldshade.png] (0,0) circle (1cm);
+\path[fill=red,fill stretch image=goldshade.png,fill image opacity=0.75]
+ (2,0) circle (1cm);
+\path[fill=red,fill stretch image=goldshade.png,fill image opacity=0.5]
+ (4,0) circle (1cm);
+\path[fill=red,fill stretch image=goldshade.png,fill image opacity=0.25]
+ (6,0) circle (1cm);
+\path[fill=red] (8,0) circle (1cm);
+\end{tikzpicture}
+\end{dispExample}
+\end{docTikzKey}
+
+
+\begin{docTikzKey}{fill image options}{=\meta{graphics options}}{no default, initially empty}
+ The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command
+ for the image fill options. This can be just together with
+ \refKey{/tikz/fill stretch image}, \refKey{/tikz/fill overzoom image}, \refKey{/tikz/fill zoom image},
+ and \refKey{/tikz/fill tile image}.
+\begin{dispExample*}{sbs,lefthand ratio=0.66}
+\begin{tikzpicture}
+\path[fill image options={width=1cm},
+ fill tile image=pink_marble.png]
+ (2.75,-0.75) -- (3,0) -- (2.75,0.75)
+ \foreach \w in {45,90,...,315}
+ { -- (\w:1.5cm) } -- cycle;
+\end{tikzpicture}
+\end{dispExample*}
+\end{docTikzKey}
+
+
+\begin{dispExample*}{sbs,lefthand ratio=0.6,center lower,
+ title=Image blending example}
+\begin{tikzpicture}[every node/.style=
+ {circle,minimum width=2cm}]
+\node[fill stretch image=blueshade.png]
+ (A) at (120:3cm) {A};
+\node[fill stretch image=goldshade.png]
+ (B) at (60:3cm) {B};
+\node[
+ preaction={fill stretch image=blueshade.png},
+ fill stretch image=goldshade.png,
+ fill image opacity=0.5] (C) {C};
+\path (A) -- node{$+$} (B);
+\draw[->,very thick] (A)--(C);
+\draw[->,very thick] (B)--(C);
+\end{tikzpicture}
+\end{dispExample*}
+
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index 1c29db55d11..07472f82bfb 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex
index a62aa250081..75bcb6955be 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 2.71 (2014/02/21)
+%% The LaTeX package tcolorbox - version 2.72 (2014/03/18)
%% tcolorbox.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
@@ -79,6 +79,7 @@
\tcbmakedocSubKey{docTcbKey}{tcb}
\tcbmakedocSubKey{langTcbKey}{tcb/doclang}
\tcbmakedocSubKey{newTcbKey}{tcb/new}
+\tcbmakedocSubKey{docTikzKey}{tikz}
\makeatletter
\newrobustcmd{\tcbIndexPrintSkinCA}[1]{\tcb@Index@Print@CA{#1}{\kvtcb@col@key}{Skin}}
@@ -97,8 +98,8 @@
\newtcolorbox{marker}[1][]{marker,#1}
-\def\version{2.71}%
-\def\datum{2014/02/21}%
+\def\version{2.72}%
+\def\datum{2014/03/18}%
\makeindex
\hypersetup{
@@ -151,10 +152,15 @@
\tcbset{documentation listing style=mydocumentation,%
sbs/.style={sidebyside,before lower app={\tcbset{sidebyside=false}}},%
- innerbox/.style={reset,documentation listing style=mydocumentation,docexample/.style={docexample original}%,listing engine=minted,documentation minted style=perldoc,
+ innerbox/.style={reset,documentation listing style=mydocumentation,
+ docexample/.style={docexample original}%,listing engine=minted,documentation minted style=perldoc,
},
- base example/.style={bicolor,colframe=Navy!50!ExampleFrame,colback=Navy!5!ExampleBack,fontlower=\footnotesize,
- colbacklower=ExampleBack!5!white,drop fuzzy shadow},
+ base example/.style={bicolor,
+ colframe=Navy!50!ExampleFrame,colback=Navy!5!ExampleBack,fontlower=\footnotesize,
+ %interior style={fill stretch image=blueshade.png,fill image opacity=0.15},
+ frame style={fill stretch image*={angle=180,origin=c}{blueshade.png},fill image opacity=0.75},
+ colbacklower=ExampleBack!5!white,opacityback=0.9,
+ drop fuzzy shadow},
docexample/.style={base example,%
every box on layer 2/.style={every box},
before upper={\tcbset{innerbox}},before lower={\tcbset{innerbox}}
@@ -283,7 +289,7 @@
\input{\jobname_preamble_J.tex}
%\tcbset{draftmode}
-%\includeonly{tcolorbox.doc.coreoptions}
+%\includeonly{tcolorbox.doc.skins}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}
@@ -300,6 +306,8 @@
\include{tcolorbox.doc.fitting}
\include{tcolorbox.doc.hooks}
\include{tcolorbox.doc.documentation}
+\appendix
+\include{tcolorbox.doc.picturecredits}
\include{tcolorbox.doc.references}
\include{tcolorbox.doc.index}
\end{document}