summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-library-layers.tex
blob: 9a32694abb857961908645d6d292c8b8cce911f7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
% !TeX root = tikz-ext-manual.tex
% !TeX spellcheck = en_US
% Copyright 2022 by Qrrbrbirlbel
%
% This file may be distributed and/or modified
%
% 1. under the LaTeX Project Public License and/or
% 2. under the GNU Free Documentation License.
%

\section{Layers}
\begin{tikzlibrary}{ext.layers}
This library extends \tikzname's functionalities to put nodes, edges, matrices and pics
on a separate layer without having to use the \referenceEnvironmentandIndexO{pgfonlayer} environment.

\textbf{Consider this library experimental.}
If you can, avoid it and use the |pgfonlayer| environment
or change the drawing order.
\end{tikzlibrary}

\begin{multicols}{2}
\subsection{Internal keys}
\begin{key}{/tikz-ext/patch=\meta{specification}}
Since this library is experimental, its functionality needs to be activated explicitly.
The \meta{specification} is one of
\begin{itemize}
\item |node|,
\item |matrix|,
\item |pic|%
  \footnote{Only the normal \referenceKeyandIndexO[/tikz/pics/]{code}
            can be placed on different layers.
            Both \referenceKeyandIndexO[/tikz/pics/]{background code}
            and \referenceKeyandIndexO[/tikz/pics/]{foreground code}
            will not be affected.},
\item |edge| or
\item |all| which applies all the patches at once.
\end{itemize}
\end{key}

These keys only work when a patch is applied but don't need to be used
since the patching activated specific
\begin{key}{/tikz-ext/layers/in box=\meta{box}}
\end{key}

\begin{key}{/tikz-ext/layers/on layer=\meta{layer}}
\end{key}

\subsection{User-level keys}
\begin{key}{/tikz/node on layer=\meta{layer}}
\end{key}
\begin{key}{/tikz/node in box=\meta{box}}
\end{key}

\begin{key}{/tikz/matrix on layer=\meta{layer}}
\end{key}
\begin{key}{/tikz/matrix in box=\meta{box}}
\end{key}

\begin{key}{/tikz/edge on layer=\meta{layer}}
\end{key}
\begin{key}{/tikz/edge in box=\meta{box}}
\end{key}

\begin{key}{/tikz/pic on layer=\meta{layer}}
\end{key}
\begin{key}{/tikz/pic in box=\meta{box}}
\end{key}
\end{multicols}