diff options
author | Karl Berry <karl@freefriends.org> | 2006-10-15 22:37:32 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-10-15 22:37:32 +0000 |
commit | 237df1eb06d422ff243a05b9a25501ba287681c1 (patch) | |
tree | 4cc4f2032474921cb986d1ca63b3cf9a267b480a /Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shapes.tex | |
parent | 15e21b5bab66eca251ac48fdc052126505428d4e (diff) |
pgf/tikz 1.09 big update (13oct06)
git-svn-id: svn://tug.org/texlive/trunk@2332 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shapes.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shapes.tex | 185 |
1 files changed, 185 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shapes.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shapes.tex new file mode 100644 index 00000000000..91b717f13ac --- /dev/null +++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shapes.tex @@ -0,0 +1,185 @@ +% Copyright 2006 by Till Tantau +% +% This file may be distributed and/or modified +% +% 1. under the LaTeX Project Public License and/or +% 2. under the GNU Free Documentation License. +% +% See the file doc/generic/pgf/licenses/LICENSE for more details. + + +\section{Shape Library} + +\begin{pgflibrary}{shapes} + This library packages defines additional shapes, which are + described in the following. +\end{pgflibrary} + + +\begin{shape}{circle split} + This shape is a multi-part shape consisting of a circle with a line + in the middle. The upper part is the main part (the |text| part), + the lower part is the |lower| part. + +\begin{codeexample}[] +\begin{tikzpicture} + \node [circle split,draw,double,fill=red!20] + { + $q_1$ + \nodepart{lower} + $00$ + }; +\end{tikzpicture} +\end{codeexample} + + The shape inherits all anchors from the |circle| shape and defines + the |lower| anchor in addition. See also the + following figure: +\begin{codeexample}[] +\Huge +\begin{tikzpicture} + \node[name=s,shape=circle split,style=shape example] {text\nodepart{lower}lower}; + \foreach \anchor/\placement in + {north west/above left, north/above, north east/above right, + west/left, center/below, east/right, + mid west/right, mid/above, mid east/left, + base west/left, base/below, base east/right, + south west/below left, south/below, south east/below right, + text/left, lower/left, 130/above} + \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)} + node[\placement] {\scriptsize\texttt{(s.\anchor)}}; +\end{tikzpicture} +\end{codeexample} +\end{shape} + +\begin{shape}{cross out} + This shape ``crosses out'' the node. Its foreground path are simply + two diagonal lines that between the corners of the node's bounding + box. Here is an example: + +\begin{codeexample}[] +\begin{tikzpicture} + \draw[help lines] (0,0) grid (3,2); + \node [cross out,draw=red] at (1.5,1) {cross out}; +\end{tikzpicture} +\end{codeexample} + + A useful application is inside text as in the following example: +\begin{codeexample}[] +Cross \tikz[baseline] \node [cross out,draw,anchor=text] {me}; out! +\end{codeexample} + + This shape inherits all anchors from the |rectangle| shape, see also + the following figure: +\begin{codeexample}[] +\Huge +\begin{tikzpicture} + \node[name=s,shape=cross out,style=shape example] {cross out\vrule width 1pt height 2cm}; + \foreach \anchor/\placement in + {north west/above left, north/above, north east/above right, + west/left, center/above, east/right, + mid west/right, mid/above, mid east/left, + base west/left, base/below, base east/right, + south west/below left, south/below, south east/below right, + text/left, 10/right, 130/above} + \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)} + node[\placement] {\scriptsize\texttt{(s.\anchor)}}; +\end{tikzpicture} +\end{codeexample} +\end{shape} + + +\begin{shape}{diamond} + This shape is a diamond tightly fitting the text box. The ratio + between width and height is 1 by default, but can be changed by + setting the shape aspect ratio (using the |aspect| option of + \tikzname). The following figure shows the anchors this + shape defines; the anchors |10| and |130| are example of border anchors. +\begin{codeexample}[] +\Huge +\begin{tikzpicture} + \node[name=s,shape=diamond,style=shape example] {Diamond\vrule width 1pt height 2cm}; + \foreach \anchor/\placement in + {north west/above left, north/above, north east/above right, + west/left, center/above, east/right, + mid/above, + base/below, + south west/below left, south/below, south east/below right, + text/left, 10/right, 130/above} + \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)} + node[\placement] {\scriptsize\texttt{(s.\anchor)}}; +\end{tikzpicture} +\end{codeexample} +\end{shape} + +\begin{shape}{ellipse} + This shape is an ellipse tightly fitting the text box, if no inner + separation is given. The following figure shows the anchors this + shape defines; the anchors |10| and |130| are example of border anchors. +\begin{codeexample}[] +\Huge +\begin{tikzpicture} + \node[name=s,shape=ellipse,style=shape example] {Ellipse\vrule width 1pt height 2cm}; + \foreach \anchor/\placement in + {north west/above left, north/above, north east/above right, + west/left, center/above, east/right, + mid west/right, mid/above, mid east/left, + base west/left, base/below, base east/right, + south west/below left, south/below, south east/below right, + text/left, 10/right, 130/above} + \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)} + node[\placement] {\scriptsize\texttt{(s.\anchor)}}; +\end{tikzpicture} +\end{codeexample} +\end{shape} + +\begin{shape}{forbidden sign} + This shape places the node inside a circle with a diagonal from the + lower left to the upper right added. The circle is part of the + background, the diagonal line part of the foreground path; thus, the + diagonal line is on top of the text. + +\begin{codeexample}[] +\begin{tikzpicture} + \node [forbidden sign,line width=1ex,draw=red,fill=white] {Smoking}; +\end{tikzpicture} +\end{codeexample} + + The shape inherits all anchors from the |circle| shape, see also the + following figure: +\begin{codeexample}[] +\Huge +\begin{tikzpicture} + \node[name=s,shape=forbidden sign,style=shape example] {Forbidden\vrule width 1pt height 2cm}; + \foreach \anchor/\placement in + {north west/above left, north/above, north east/above right, + west/left, center/above, east/right, + mid west/right, mid/above, mid east/left, + base west/left, base/below, base east/right, + south west/below left, south/below, south east/below right, + text/left, 10/right, 130/above} + \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)} + node[\placement] {\scriptsize\texttt{(s.\anchor)}}; +\end{tikzpicture} +\end{codeexample} +\end{shape} + + +\begin{shape}{strike out} + This shape is idential to the |cross out| shape, only its foreground + path consists of a single line from the lower left to the upper + right. + +\begin{codeexample}[] +Strike \tikz[baseline] \node [strike out,draw,anchor=text] {me}; out! +\end{codeexample} + + See the |cross out| shape for the anchors. +\end{shape} + + + +%%% Local Variables: +%%% mode: latex +%%% TeX-master: "pgfmanual-pdftex-version" +%%% End: |