diff options
author | Norbert Preining <norbert@preining.info> | 2023-02-11 03:01:17 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2023-02-11 03:01:17 +0000 |
commit | 73abb311c03e955ad9f7b7464390a5722b20b915 (patch) | |
tree | a8e116777430169c28f315127303eb19626a4d30 /macros/latex/contrib/tcolorbox/tcolorbox.doc.skins.tex | |
parent | e10a52ebe817fe7ff0235c066d83f51f39d3e023 (diff) |
CTAN sync 202302110301
Diffstat (limited to 'macros/latex/contrib/tcolorbox/tcolorbox.doc.skins.tex')
-rw-r--r-- | macros/latex/contrib/tcolorbox/tcolorbox.doc.skins.tex | 35 |
1 files changed, 16 insertions, 19 deletions
diff --git a/macros/latex/contrib/tcolorbox/tcolorbox.doc.skins.tex b/macros/latex/contrib/tcolorbox/tcolorbox.doc.skins.tex index 73d93d228b..0292ceb48a 100644 --- a/macros/latex/contrib/tcolorbox/tcolorbox.doc.skins.tex +++ b/macros/latex/contrib/tcolorbox/tcolorbox.doc.skins.tex @@ -42,8 +42,6 @@ This is the lower part. \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{exdispExample*}{frame_style_image}{sbs,lefthand ratio=0.66} \tcbset{colback=red!5!white,fonttitle=\bfseries} @@ -60,8 +58,6 @@ This is the lower part. \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{exdispExample*}{frame_style_tile}{sbs,lefthand ratio=0.66} \tcbset{colback=red!5!white,coltitle=red!30!black, opacityback=0.75,fonttitle=\bfseries} @@ -119,8 +115,6 @@ This is the lower part. \clearpage \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{exdispExample*}{interior_style_image}{sbs,lefthand ratio=0.66} \tcbset{colframe=red!75!black,fonttitle=\bfseries} @@ -137,9 +131,6 @@ This is the lower part. \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{exdispExample*}{interior_style_tile}{sbs,lefthand ratio=0.66} \tcbset{colframe=red!75!black,fonttitle=\bfseries} @@ -237,9 +228,6 @@ This is the lower part. \clearpage \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{exdispExample*}{title_style_image}{sbs,lefthand ratio=0.66} \tcbset{colback=blue!5!white,colframe=blue!75!black, fonttitle=\bfseries} @@ -257,9 +245,6 @@ This is the lower part. \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{exdispExample*}{title_style_tile}{sbs,lefthand ratio=0.66} \tcbset{colback=red!5!white,colframe=red!75!black, coltitle=blue!50!black,fonttitle=\bfseries} @@ -1233,7 +1218,7 @@ This example uses a public domain picture from\\ \enlargethispage*{1cm} -\begin{docTcbKey}{watermark zoom}{=\meta{fraction}}{no default, initially |0.75|} +\begin{docTcbKey}[][doc updated=2022-07-21]{watermark zoom}{=\meta{fraction}}{default |1|, initially |0.75|} Sets the zoom value for a watermark. The zoom respects the aspect ratio. The value $1.0$ means to fill the whole box until the watermark touches the frame. \begin{dispExample} @@ -1251,13 +1236,13 @@ This example uses a public domain picture from\\ \clearpage -\begin{docTcbKey}{watermark shrink}{=\meta{fraction}}{no default, initially unset} +\begin{docTcbKey}[][doc updated=2022-07-21]{watermark shrink}{=\meta{fraction}}{default |1|, initially unset} Identically to \refKey{/tcb/watermark zoom}, but the watermark never gets enlarged. Thus, the watermark keeps its original size or is shrunk. \end{docTcbKey} -\begin{docTcbKey}{watermark overzoom}{=\meta{fraction}}{no default, initially unset} +\begin{docTcbKey}[][doc updated=2022-07-21]{watermark overzoom}{=\meta{fraction}}{default |1|, initially unset} Sets the overzoom value for a watermark. The overzoom respects the aspect ratio. The value $1.0$ means to fill the whole box until the watermark touches all four sides of the frame. @@ -1284,7 +1269,7 @@ To avoid this optical glitch, just set \refKey{/tcb/pad at break} to any desired \end{marker} \clearpage -\begin{docTcbKey}{watermark stretch}{=\meta{fraction}}{no default, initially unset} +\begin{docTcbKey}[][doc updated=2022-07-21]{watermark stretch}{=\meta{fraction}}{default |1|, initially unset} Sets the stretch value for a watermark. The stretch value is applied to width and height in relation to the box dimensions. It does not respect the aspect ratio. The value $1.0$ means to fill the whole box. @@ -1333,6 +1318,16 @@ To avoid this optical glitch, just set \refKey{/tcb/pad at break} to any desired \end{dispExample} \end{docTcbKey} +\begin{marker} +Removing the clipping should be necessary only in very rare situations. Until +version 5.1.1 (2022/06/24), theoretically, the watermark could be extended +over the boundaries of the box without limit. Newer versions restrict the +watermark to a box scaled 4 times the actual |tcolorbox|. +If you really need to extend further, you are strongly advised to implement +this by using \refKey{/tcb/overlay} or \refKey{/tcb/underlay} directly +where no restrictions apply. +Note that a watermark is just a special \refKey{/tcb/overlay}. +\end{marker} \clearpage @@ -2507,6 +2502,8 @@ The differences between underlays and overlays are: \refKey{/tcb/underlay} overwrites this key. \end{docTcbKey} +\enlargethispage*{1cm} + \begin{docTcbKey}{underlay unbroken}{=\meta{graphical code}}{no default, initially unset} If the box is set to be \refKey{/tcb/breakable} but \emph{is not} broken actually or if the box is set to be \refKey{/tcb/unbreakable}, |