% !TeX spellcheck = en_US
% !TeX root = tikz-ext-manual.tex
% 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.
%
\clearpage
\section{Positioning Plus}
\label{library:positioning-plus}
\tikzsetnextfilename{posplus}
\begin{tikzlibrary}{ext.positioning-plus}
 With the help of the \referenceLibraryandIndexO{positioning} and the \referenceLibraryandIndexO{fit} library this extends the placement of nodes.
\end{tikzlibrary}

\subsection{Useful corner anchors}
The anchors |ext_corner north east|, |ext_corner north west|, |ext_corner south west| and |ext_corner south east|
are defined as ``generic anchors'', i.\,e. they are defined for all shapes.
This is mostly useful for the placement of circular shapes.
\begin{codeexample}[width=.45\linewidth,preamble=\usetikzlibrary{ext.positioning-plus}]
\Huge
\begin{tikzpicture}
\node[name=s,shape=circle,shape example,scale=.75,outer sep=auto]
 {Circle\vrule width 1pt height 2cm};
\foreach \anchor/\placement in {
 north west/below right, north/above, north east/below left,
 west/left, center/above, east/right,
 mid west/right, mid/above, mid east/left,
 base west/left, base/below, base east/right,
 south west/above right, south/below, south east/above left,
 text/left, 10/right, 130/above}
 \draw[node font=\scriptsize, shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
   node[\placement] {\texttt{(s.\anchor)}};
\draw (s.ext_corner north west) rectangle (s.ext_corner south east);
\foreach \anchor/\placement in {
 corner north west/above, corner north east/above,
 corner south west/below, corner south east/below}
 \draw[node font=\scriptsize, red, shift=(s.ext_\anchor)] plot[mark=x] coordinates{(0,0)}
   node[\placement] {\texttt{(s.ext\textunderscore\anchor)}};
\end{tikzpicture}
\end{codeexample}

\clearpage
\subsection{Useful placement keys for vertical and horizontal alignment}
\begin{multicols}{2}
\begin{keylist}[/\tikzext]{%
        left=\opt{\meta{specification}} (default 0pt),
       right=\opt{\meta{specification}} (default 0pt),
       above=\opt{\meta{specification}} (default 0pt),
       below=\opt{\meta{specification}} (default 0pt),
 above  left=\opt{\meta{specification}} (default 0pt),
 below  left=\opt{\meta{specification}} (default 0pt),
 above right=\opt{\meta{specification}} (default 0pt),
 below right=\opt{\meta{specification}} (default 0pt),
 mid    left=\opt{\meta{specification}} (default 0pt),
 mid   right=\opt{\meta{specification}} (default 0pt),
 base   left=\opt{\meta{specification}} (default 0pt),
 base  right=\opt{\meta{specification}} (default 0pt)%
}
 While the \meta{specification} of all these keys still accept the same form as with \tikzname,
 the |ext.positioning-plus| library extends this even more.

 The specification after |of| can contain a list of coordinates (like the |fit| key of the |fit| library).
 This means that the new node will be placed in relation to a rectangular bounding box
 that fits around all this nodes in the list.

 If this list is prefixed with \verb!|!, |-| or |+|,
 the new node will also have the same height (\verb!|!),
 the same width (|-|) or both as this bounding box.

\begin{codeexample}[preamble=\usetikzlibrary{ext.positioning-plus}, width=.3\linewidth]
\begin{tikzpicture}[nodes=draw]
\node (A) {A} node[below=of A] (BCD) {BCD};
\node[ext/right=   of |(A)(BCD)] (c) {};
\node[ext/below=.5:of -(A)(BCD)] (d) {};
\draw[help lines] (BCD.south west) -- (c.south east)
                 (BCD.north east) -- (d.south east);
\end{tikzpicture}
\end{codeexample}

 As you maybe noticed in the example above, the \meta{specification} also allows a prefix
 delimited by |:| which the |node distance| will be multiplied to with for the placement.%
 \footnote{This is probably more useful when \referenceKeyandIndexO{on grid} is used.}
\end{keylist}

\newcolumn
The |fit|ting functionality is also available without the placement.
\begin{keylist}[/\tikzext]{%
 fit bounding box=\meta{list of coordinates},
 span vertical=\meta{list of coordinates},
 span horizontal=\meta{list of coordinates},
 span=\meta{list of coordinates}}
These all create a rectangular node with the name |ext_fit bounding box|
that encompasses the \meta{list of coordinates}.

The |span vertical| key will also set \referenceKeyandIndexO[/pgf/]{minimum height}
to the height of this bounding box

The |span horizontal| key will also set \referenceKeyandIndexO[/pgf/]{minimum width}
to the width of this bounding box

The last one combines |span vertical| and |span horizontal|.
\end{keylist}

\begin{keylist}[/\tikzext]{%
 north  left=\opt{\meta{specification}} (default 0pt),
 south  left=\opt{\meta{specification}} (default 0pt),
 north right=\opt{\meta{specification}} (default 0pt),
 south right=\opt{\meta{specification}} (default 0pt),
 west  above=\opt{\meta{specification}} (default 0pt),
 west  below=\opt{\meta{specification}} (default 0pt),
 east  above=\opt{\meta{specification}} (default 0pt),
 east  below=\opt{\meta{specification}} (default 0pt)%
}
 These work similarly to |left|, |right|, |above| and |below|
 but they are north- or south-aligned.

\begin{codeexample}[preamble=\usetikzlibrary{ext.positioning-plus}]
\begin{tikzpicture}[nodes=draw]
\node[minimum height=2cm] (a) {};
\node[minimum height=3cm, ext/north right=of a] {};
\end{tikzpicture}
\end{codeexample}
\end{keylist}

The same exist for the recently introduces corner anchors, too.
\begin{keylist}[/\tikzext]{%
 corner above left=\opt{\meta{specification}} (default 0pt),
 corner below left=\opt{\meta{specification}} (default 0pt),
 corner above right=\opt{\meta{specification}} (default 0pt),
 corner below right=\opt{\meta{specification}} (default 0pt),
 corner north  left=\opt{\meta{specification}} (default 0pt),
 corner south  left=\opt{\meta{specification}} (default 0pt),
 corner north right=\opt{\meta{specification}} (default 0pt),
 corner south right=\opt{\meta{specification}} (default 0pt),
 corner west  above=\opt{\meta{specification}} (default 0pt),
 corner west  below=\opt{\meta{specification}} (default 0pt),
 corner east  above=\opt{\meta{specification}} (default 0pt),
 corner east  below=\opt{\meta{specification}} (default 0pt)%
}
 These work the same as |above left|, |below left|, \dots\
 but they use the new generic corner anchors
\end{keylist}
\end{multicols}
\endinput

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.