summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-backgrounds.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-backgrounds.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-backgrounds.tex29
1 files changed, 29 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-backgrounds.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-backgrounds.tex
index 8144d8aec42..ed7ed14b624 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-backgrounds.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-backgrounds.tex
@@ -21,6 +21,35 @@
your picture or |gridded| to put a grid behind your picture.
\end{tikzlibrary}
+
+The first use of this library is to make the following key available:
+\begin{key}{/tikz/on background layer}
+ This key can be used with a |{scope}|. It will cause everything
+ inside the scope to be typeset on a background layer. Note that the
+ scope should not be ``deeply nested'' inside the picture since
+ changes to the graphic state (like the color or the transformation
+ matrix) ``do not survive a layer switch.'' For more details on
+ layers see Section~\ref{section-layers}.
+
+\begin{codeexample}[]
+\begin{tikzpicture}
+ % On main layer:
+ \fill[blue] (0,0) circle (1cm);
+
+ \begin{scope}[on background layer]
+ \fill[yellow] (-1,-1) rectangle (1,1);
+ \end{scope}
+
+ \begin{scope}[on background layer]
+ \fill[black] (-.8,-.8) rectangle (.8,.8);
+ \end{scope}
+
+ % On main layer again:
+ \fill[blue!50] (-.5,-1) rectangle (.5,1);
+\end{tikzpicture}
+\end{codeexample}
+\end{key}
+
When this package is loaded, the following styles become available:
\begin{stylekey}{/tikz/show background rectangle}
This style causes a rectangle to be drawn behind your graphic. This