summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shapes.tex
diff options
context:
space:
mode:
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.tex276
1 files changed, 185 insertions, 91 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
index 4c99d465083..3beaf544170 100644
--- 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
@@ -26,6 +26,18 @@ The appearance of shapes is influenced by numerous parameters like
|minimum height| or |inner xsep|. These general parameters are documented in
Section~\ref{section-shape-common-options}
+In all of the examples presented in this section, the following
+|shape example| style is used:
+\begin{codeexample}[code only]
+\tikzset{
+ shape example/.style= {color = black!30,
+ draw,
+ fill = yellow!30,
+ line width = .5cm,
+ inner xsep = 2.5cm,
+ inner ysep = 0.5cm}
+}
+\end{codeexample}
\subsection{Predefined Shapes}
\label{section-predefined-shapes}
@@ -163,9 +175,9 @@ shapes define a standard set of anchors.
\begin{tikzpicture}
\tikzstyle{every node}=[trapezium, draw]
\node at (0,2) {A};
- \node[trapezium left angle=75, trapezium right angle=45pt]
+ \node[trapezium left angle=75, trapezium right angle=45]
at (0,1) {B};
- \node[trapezium left angle=120, trapezium right angle=60pt]
+ \node[trapezium left angle=120, trapezium right angle=60]
at (0,0) {C};
\end{tikzpicture}
\end{codeexample}
@@ -176,11 +188,11 @@ shapes define a standard set of anchors.
To use these keys in \tikzname, simply remove the \declare{|/pgf/|} path.
\begin{key}{/pgf/trapezium left angle=\meta{angle} (initially 60)}
- Set the lower internal angle of the left side.
+ Sets the lower internal angle of the left side.
\end{key}
\begin{key}{/pgf/trapezium right angle=\meta{angle} (initially 60)}
- Set the lower internal angle of the right side.
+ Sets the lower internal angle of the right side.
\end{key}
\begin{stylekey}{/pgf/trapezium angle=\meta{angle}}
@@ -374,7 +386,7 @@ shapes define a standard set of anchors.
Section~\ref{section-rotating-shape-borders}, but the border of the
star is \emph{always} constructed using the incircle.
- A star should be thought of as having an set of ``inner points''
+ A star should be thought of as having a set of ``inner points''
and ``outer points''.
The inner points of the border are based on the radius of the circle
which tightly fits the node contents, and the outer points are based
@@ -463,7 +475,7 @@ shapes define a standard set of anchors.
To use these keys in \tikzname, simply remove the \declare{|/pgf/|}
path.
- \begin{key}{/pgf/isosceles triangle apex angle=\meta{angle} (initially 45)}
+ \begin{key}{/pgf/isosceles triangle apex angle=\meta{angle} (initially 30)}
Sets the angle of the apex of the isosceles triangle.
\end{key}
@@ -545,11 +557,11 @@ shapes define a standard set of anchors.
path.
\begin{key}{/pgf/kite upper vertex angle=\meta{angle} (initially 120)}
- Set the upper internal angle of the kite.
+ Sets the upper internal angle of the kite.
\end{key}
\begin{key}{/pgf/kite lower vertex angle=\meta{angle} (initially 60)}
- Set the lower internal angle of the kite.
+ Sets the lower internal angle of the kite.
\end{key}
\begin{key}{/pgf/kite vertex angles=\meta{angle specification}}
@@ -622,11 +634,11 @@ shapes define a standard set of anchors.
\end{codeexample}
\begin{key}{/pgf/dart tip angle=\meta{angle} (initially 45)}
- Set the angle at the tip of the dart.
+ Sets the angle at the tip of the dart.
\end{key}
\begin{key}{/pgf/dart tail angle=\meta{angle} (initially 135)}
- Set the angle between the tails of the dart.
+ Sets the angle between the tails of the dart.
\end{key}
The anchors for the |dart| shape are shown below (note that the
@@ -678,7 +690,7 @@ shapes define a standard set of anchors.
path.
\begin{key}{/pgf/circular sector angle=\meta{angle} (initially 60)}
- Set the central angle of the sector.
+ Sets the central angle of the sector.
\end{key}
The anchors for the circular sector shape are shown below.
@@ -735,7 +747,7 @@ shapes define a standard set of anchors.
width will stretch the curved ends.
\begin{codeexample}[]
-\begin{tikzpicture}[>=stealth, shape aspect=.5]
+\begin{tikzpicture}[shape aspect=.5]
\tikzset{every node/.style={cylinder, shape border rotate=90, draw}}
\node [minimum height=1.5cm] {A};
\node [minimum width=1.5cm] at (1.5,0) {B};
@@ -751,7 +763,7 @@ shapes define a standard set of anchors.
to some minimum width.
\begin{codeexample}[]
-\begin{tikzpicture}[>=stealth]
+\begin{tikzpicture}[]
\tikzset{every node/.style={cylinder, shape border rotate=90, draw}}
\node [aspect=1.0] {A};
\node [aspect=0.5] at (1,0) {B};
@@ -771,22 +783,22 @@ shapes define a standard set of anchors.
\end{key}
\begin{codeexample}[]
-\begin{tikzpicture}[>=stealth, aspect=0.5]
+\begin{tikzpicture}[aspect=0.5]
\node [cylinder, cylinder uses custom fill, cylinder end fill=red!50,
cylinder body fill=red!25] {Cylinder};
\end{tikzpicture}
\end{codeexample}
\begin{key}{/pgf/cylinder end fill=\meta{color} (initially white)}
- Set the color for the end of the cylinder.
+ Sets the color for the end of the cylinder.
\end{key}
\begin{key}{/pgf/cylinder body fill=\meta{color} (initially white)}
- Set the color for the body of the cylinder.
+ Sets the color for the body of the cylinder.
\end{key}
- The anchors this shape are shown below (anchor |160| is an
- example of a border anchor). Note the cylinder shape does not
+ The anchors of this shape are shown below (anchor |160| is an
+ example of a border anchor). Note that the cylinder shape does not
distinguish between |outer xsep| and |outer ysep|. Only the larger
of the two values is used for the shape. Note also the difference
between the |center| and |shape center| anchors: |center| is the
@@ -831,14 +843,28 @@ shapes define a standard set of anchors.
-\begin{shape}{forbidden sign}
+\begin{shape}{correct 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
+ upper left to the lower 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 [correct forbidden sign,line width=1ex,draw=red,fill=white] {Smoking};
+\end{tikzpicture}
+\end{codeexample}
+
+ The shape inherits all anchors from the |circle| shape.
+\end{shape}
+
+\begin{shape}{forbidden sign}
+ This shape is like |correct forbidden sign|, only the line goes from
+ the lower left to the upper right. The strange naming of these
+ shapes is for historical reasons.
+
+\begin{codeexample}[]
+\begin{tikzpicture}
\node [forbidden sign,line width=1ex,draw=red,fill=white] {Smoking};
\end{tikzpicture}
\end{codeexample}
@@ -888,17 +914,17 @@ shapes define a standard set of anchors.
\tikzname{}, simply remove the \declare{|/pgf/|} path).
\begin{key}{/pgf/cloud puffs=\meta{integer} (initially 10)}
- Set the number of puffs for the cloud.
+ Sets the number of puffs for the cloud.
\end{key}
\begin{key}{/pgf/cloud puff arc=\meta{angle} (initially 135)}
- Set the length of the puff arc (in degrees). A shorter arc can
+ Sets the length of the puff arc (in degrees). A shorter arc can
produce better looking joins between puffs for larger line widths.
\end{key}
Like the diamond shape, the cloud shape also uses the
- \declare{|aspect|} key, to determine the ratio of the width and the
- height of the cloud. However there may be circumstances where it may
+ \declare{|aspect|} key to determine the ratio of the width and the
+ height of the cloud. However, there may be circumstances where it may
be undesirable to continually specify the |aspect| for the cloud.
Therefore, the following key is implemented:
@@ -961,7 +987,7 @@ shapes define a standard set of anchors.
\begin{shape}{starburst}
This shape is a randomly generated elliptical star,
- which supports the rotating of the shape border as described in
+ which supports the rotation of the shape border as described in
Section~\ref{section-rotating-shape-borders}.
\begin{codeexample}[]
\begin{tikzpicture}
@@ -974,7 +1000,7 @@ shapes define a standard set of anchors.
Using a specified `starburst point height' value, the outer points
are generated randomly between this value and one quarter of this
- value. For a given starburst shape the angle between each point is
+ value. For a given starburst shape, the angle between each point is
fixed, and is determined by the number of points specified for
the starburst.
@@ -996,15 +1022,15 @@ shapes define a standard set of anchors.
\declare{|/pgf/|} path.
\begin{key}{/pgf/starburst points=\meta{integer} (initially 17)}
- Set the number of points for the starburst.
+ Sets the number of outer points for the starburst.
\end{key}
\begin{key}{/pgf/starburst point height=\meta{length} (initially .5cm)}
- Set the \emph{maximum} distance between the inner point radius
+ Sets the \emph{maximum} distance between the inner point radius
and the outer point radius.
\end{key}
\begin{key}{/pgf/random starburst=\meta{integer} (initially 100)}
- Set the seed for the random number generator for creating the
+ Sets the seed for the random number generator for creating the
starburst. The maximum value for \meta{integer} is |16383|.
If \meta{integer}|=0|, the random number generator will not be
used, and the maximum point height will be used for all outer
@@ -1056,13 +1082,13 @@ shapes define a standard set of anchors.
keys in \tikzname{}, simply remove the \declare{|/pgf/|} path):
\begin{key}{/pgf/signal pointer angle=\meta{angle} (initially 90)}
- Set the angle for the pointed sides of the shape. This angle is
+ Sets the angle for the pointed sides of the shape. This angle is
maintained when enforcing any minimum size requirements, so
any adjustment to the width will affect the height, and vice versa.
\end{key}
\begin{key}{/pgf/signal from=\meta{direction}\space\opt{and \meta{opposite direction}} (initially nowhere)}
- Set which sides take an inward pointer (i.e., that points towards the
+ Sets which sides take an inward pointer (i.e., that points towards the
center of the shape). The possible values for \meta{direction} and
\meta{opposite direction} are the compass point directions |north|,
|south|, |east| and |west| (or |above|, |below|, |right| and |left|).
@@ -1074,8 +1100,8 @@ shapes define a standard set of anchors.
\end{key}
\begin{key}{/pgf/signal to=\meta{direction}\space\opt{and \meta{opposite direction}} (initially east)}
- Set which sides take an outward pointer (i.e., that points away from
- the the shape).
+ Sets which sides take an outward pointer (i.e., that points away from
+ the shape).
\end{key}
Note that \pgfname{} will ignore any instruction to use directions
@@ -1130,7 +1156,7 @@ shapes define a standard set of anchors.
\declare{|/pgf/|} path):
\begin{key}{/pgf/tape bend top=\meta{bend style} (initially in and out)}
- Specify how the top side bends. The \meta{bend style} is either
+ Specifies how the top side bends. The \meta{bend style} is either
|in and out|, |out and in| or |none| (i.e., a straight line).
The bending sides are drawn in a
clockwise direction, and using the bend style |in and out| will mean
@@ -1164,11 +1190,11 @@ shapes define a standard set of anchors.
\end{key}
\begin{key}{/pgf/tape bend bottom=\meta{bend style} (initially in and out)}
- Specify how the bottom side bends.
+ Specifies how the bottom side bends.
\end{key}%
\begin{key}{/pgf/tape bend height=\meta{length} (initially 5pt)}
- Set the total height for a side with a bend.
+ Sets the total height for a side with a bend.
\begin{codeexample}[]
\begin{tikzpicture}[>=stealth]
@@ -1207,6 +1233,74 @@ shapes define a standard set of anchors.
+\begin{shape}{magnetic tape}
+
+ This shape represents a `magnetic tape' or any sequential data store
+ that is sometimes used in flowcharts. It is essentially a circle with a
+ little tail:
+
+\begin{codeexample}[]
+\tikz\node [magnetic tape, draw] (A) {A};
+\end{codeexample}
+
+ The following keys can be used to customise the |magnetic tape|
+ shape:
+
+
+\begin{key}{/pgf/magnetic tape tail extend=\meta{distance} (initially 0cm)}
+
+ This key sets how far the tail extends beyond the radius of
+ the tape. Negative values will be ignored.
+
+\begin{codeexample}[]
+\begin{tikzpicture}[every node/.style={magnetic tape, draw}]
+ \node [magnetic tape tail extend=0cm] at (0,0) {A};
+ \node [magnetic tape tail extend=0.25cm] at (0,1) {B};
+\end{tikzpicture}
+\end{codeexample}
+\end{key}
+
+
+
+\begin{key}{/pgf/magnetic tape tail=\meta{proportion} (initially 0.15)}
+
+ This key sets the thickness of the `tail' to be \meta{proportion}
+ times the radius of the shape. The \meta{proportion} should be
+ between |0.0| and |1.0|.
+
+\begin{codeexample}[]
+\begin{tikzpicture}[every node/.style={magnetic tape, draw}]
+ \node [magnetic tape tail=0.5, magnetic tape tail extend=0.5cm] {A};
+ \node [magnetic tape tail=0.25] at (0,1) {B};
+\end{tikzpicture}
+\end{codeexample}
+\end{key}
+
+
+ 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=magnetic tape,shape example,inner sep=0.75cm,
+magnetic tape tail extend=0.5cm]
+ {Magnetic Tape\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/right, mid east/left,
+ base west/below, base/below, base east/right,
+ south west/below left, south/below, south east/left,
+ text/left, 10/right, 130/above,
+ tail east/right, tail south east/below, tail north east/above}
+ \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
+ node[\placement] {\scriptsize\texttt{(s.\anchor)}};
+\end{tikzpicture}
+\end{codeexample}
+\end{shape}
+
+
\subsection{Arrow Shapes}
\begin{pgflibrary}{shapes.arrows}
@@ -1217,11 +1311,11 @@ shapes define a standard set of anchors.
\end{pgflibrary}
\begin{shape}{single arrow}
- This shape is an arrow, which tightly fits the note contents
+ This shape is an arrow, which tightly fits the node contents
(including any |inner sep|).
This shape supports the rotation of the shape border, as
described in Section~\ref{section-rotating-shape-borders}.
- The angle of rotation determines which direction the arrow
+ The angle of rotation determines in which direction the arrow
points (provided no other rotational transformations are applied).
\begin{codeexample}[]
@@ -1255,7 +1349,7 @@ shapes define a standard set of anchors.
path).
\begin{key}{/pgf/single arrow tip angle=\meta{angle} (initially 90)}
- Set the angle for the arrow tip. Enlarging the arrow to some
+ Sets the angle for the arrow tip. Enlarging the arrow to some
minimum width may increase the height of the shape to maintain
this angle.
\end{key}
@@ -1315,7 +1409,7 @@ shapes define a standard set of anchors.
\begin{shape}{double arrow}
- This shape is a double arrow, which tightly fits the note contents
+ This shape is a double arrow, which tightly fits the node contents
(including any |inner sep|), and supports the rotation of the shape
border, as described in Section~\ref{section-rotating-shape-borders}.
@@ -1349,7 +1443,7 @@ shapes define a standard set of anchors.
path).
\begin{key}{/pgf/double arrow tip angle=\meta{angle} (initially 90)}
- Set the angle for the arrow tip. Enlarging the arrow to some
+ Sets the angle for the arrow tip. Enlarging the arrow to some
minimum width may increase the height of the shape to maintain
this angle.
\end{key}
@@ -1429,25 +1523,25 @@ There are various \pgfname{} keys for drawing this shape (to use these
keys in \tikzname, simply remove the \declare{/pgf/} path).
\begin{key}{/pgf/arrow box tip angle=\meta{angle} (initially 90)}
- Set the angle at the arrow tip for all four arrows.
+ Sets the angle at the arrow tip for all four arrows.
\end{key}
\begin{key}{/pgf/arrow box head extend=\meta{length} (initially .125cm)}
- Set the distance the arrow head extends away from the shaft
+ Sets the distance the arrow head extends away from the shaft
of the arrow. This applies to all arrows.
\end{key}
\begin{key}{/pgf/arrow box head indent=\meta{length} (initially 0cm)}
- Move the point where the arrow head joins the shaft of the arrow
+ Moves the point where the arrow head joins the shaft of the arrow
\emph{towards} the arrow tip. This applies to all arrows.
\end{key}
\begin{key}{/pgf/arrow box shaft width=\meta{length} (initially .125cm)}
- Set the width of the shaft of all arrows.
+ Sets the width of the shaft of all arrows.
\end{key}
\begin{key}{/pgf/arrow box north arrow=\meta{distance} (initially .5cm)}
- Set distance the north arrow extends from the node. By default this
+ Sets the distance the north arrow extends from the node. By default this
is from the border of the shape, but by using the additional keyword
|from center|, the distance will be measured from the center of the
shape. If \meta{distance} is |0pt| or a negative distance, the arrow
@@ -1455,19 +1549,19 @@ keys in \tikzname, simply remove the \declare{/pgf/} path).
\end{key}
\begin{key}{/pgf/arrow box south arrow=\meta{distance} (initially .5cm)}
- Set distance the south arrow extends from the node.
+ Sets the distance the south arrow extends from the node.
\end{key}
\begin{key}{/pgf/arrow box east arrow=\meta{distance} (initially .5cm)}
- Set distance the east arrow extends from the node.
+ Sets the distance the east arrow extends from the node.
\end{key}
\begin{key}{/pgf/arrow box west arrow=\meta{distance} (initially .5cm)}
- Set distance the west arrow extends from the node.
+ Sets the distance the west arrow extends from the node.
\end{key}
\begin{key}{/pgf/arrow box arrows={\ttfamily\char`\{}\meta{list}{\ttfamily\char`\}}}
- Set the distance that all arrows extend from the node. The
+ Sets the distance that all arrows extend from the node. The
specification in \meta{list} consists of the four compass points
|north|, |south|, |east| or |west|, separated by commas (so the list
must be contained within braces).
@@ -1479,7 +1573,7 @@ keys in \tikzname, simply remove the \declare{/pgf/} path).
Any sides not specified will not be drawn with an arrow.
\end{key}
-The anchors for this shape are shown below (unfortunately due to its
+The anchors for this shape are shown below (unfortunately, due to its
size, this example must be rotated). Anchor |75| is an example of a
border anchor.
If a side is drawn without an arrow, the anchors for that arrow should
@@ -1616,7 +1710,7 @@ to the center of the appropriate side.
\begin{shape}{rectangle split}
- This shape is a rectangle which can be either split horizontally
+ This shape is a rectangle which can be split either horizontally
or vertically into several parts.
\begin{codeexample}[]
@@ -1652,15 +1746,15 @@ these extra boxes, the following key is provided:
\begin{key}{/pgf/rectangle split allocate boxes=\meta{number}}
This key checks if \meta{number} boxes have been allocated, and if
- not allocates the required boxes using |\newbox| (some ``magic'' is
+ not, it allocates the required boxes using |\newbox| (some ``magic'' is
performed to get around the fact that |\newbox| is declared |\outer|
in plain \TeX).
\end{key}
- When split vertically, the rectangle split will observe any
- |minimum width| requirements but any |minimum height| will be ignored.
+ When split vertically, the rectangle split will meet any
+ |minimum width| requirements, but any |minimum height| will be ignored.
Conversely when split horizontally, |minimum height| requirements
- will be observed, but any |minimum width| will be ignored.
+ will be met, but any |minimum width| will be ignored.
In addition, |inner sep| is applied
to every part that is used, so it cannot be specified
independently for a particular part.
@@ -1672,7 +1766,7 @@ these extra boxes, the following key is provided:
\begin{key}{/pgf/rectangle split parts=\meta{number} (initially 4)}
Split the rectangle into \meta{number} parts,
which should be in the range |1| to |20|. If more than four parts
- are need, the boxes should be allocated in advance as
+ are needed, the boxes should be allocated in advance as
described above.
\begin{codeexample}[]
@@ -1711,25 +1805,25 @@ these extra boxes, the following key is provided:
\end{key}
%
\begin{key}{/pgf/rectangle split empty part width=\meta{length} (initially 1ex)}
- Set the default width for a node part box if it is empty and
+ Sets the default width for a node part box if it is empty and
empty parts are not ignored.
\end{key}
\begin{key}{/pgf/rectangle split empty part height=\meta{length} (initially 1ex)}
- Set the default height for a node part box if it is empty and
+ Sets the default height for a node part box if it is empty and
empty parts are not ignored.
\end{key}
\begin{key}{/pgf/rectangle split empty part depth=\meta{length} (initially 0ex)}
- Set the default depth for a node part box if it is empty and
+ Sets the default depth for a node part box if it is empty and
empty parts are not ignored.
\end{key}
\begin{key}{/pgf/rectangle split part align={\ttfamily\char`\{}\meta{list}{\ttfamily\char`\}} (initially center)}
- Set the alignment of the boxes inside the node parts.
+ Sets the alignment of the boxes inside the node parts.
Each item in \meta{list} should be
separated by commas (so if there is more than one item in
- \meta{list} it must be surrounded by braces).
+ \meta{list}, it must be surrounded by braces).
When the rectangle is split vertically, the entries in \meta{list}
must be one of |left|, |right|, or |center|. If \meta{list} has less
@@ -1752,7 +1846,7 @@ these extra boxes, the following key is provided:
When the rectangle is split horizontally, the entries in \meta{list}
must be one of |top|, |bottom|, |center| or |base|. Note that using
- the value |base| will only makes sense if all the node part boxes are
+ the value |base| will only make sense if all the node part boxes are
being aligned in this way. This is because the |base| value aligns
the boxes in relation to each other, whereas the other values align
the boxes in relation to the part of the shape they occupy.
@@ -1774,7 +1868,7 @@ these extra boxes, the following key is provided:
\end{key}
\begin{key}{/pgf/rectangle split draw splits=\opt{\meta{boolean}} (default true)}
- Set whether the line or lines between node parts will be drawn.
+ Sets whether the line or lines between node parts will be drawn.
Internally, this sets the \TeX-if |\ifpgfrectanglesplitdrawsplits|
appropriately.
\end{key}
@@ -1790,12 +1884,12 @@ these extra boxes, the following key is provided:
\end{key}
\begin{key}{/pgf/rectangle split part fill={\ttfamily\char`\{}\meta{list}{\ttfamily\char`\}} (initially white)}
- Set the custom fill color for each node part shape.
- Each item in \meta{list} should be separated by commas (so if
- there is more than one item in \meta{list} it must be surrounded
+ Sets the custom fill color for each node part shape.
+ The items in \meta{list} should be separated by commas (so if
+ there is more than one item in \meta{list}, it must be surrounded
by braces).
If \meta{list} has less entries than node
- parts then the remaining node parts use the color from
+ parts, then the remaining node parts use the color from
the last entry in the list. This key will automatically set
|/pgf/rectangle split use custom fill|.
@@ -1813,7 +1907,7 @@ these extra boxes, the following key is provided:
The anchors for the |rectangle split| shape split vertically into four,
are shown below (anchor |70| is an example of a border angle). When a
- node part is missing, the anchors prefixed with name of that node part
+ node part is missing, the anchors prefixed with the name of that node part
should be considered unavailable. They are (unavoidably) defined, but
default to other anchor positions.
@@ -1859,7 +1953,7 @@ these extra boxes, the following key is provided:
\end{pgflibrary}
Callouts consist of a
-main shape, and a pointer (which is part of the shape) which points
+main shape and a pointer (which is part of the shape) which points
to something in (or outside) the picture. The position on the border
of the main shape to which the pointer is connected is determined
automatically. However, the pointer is ignored when calculating the
@@ -1903,14 +1997,14 @@ on whether they are being used in \pgfname{} or \tikzname{}.
\begin{key}{/pgf/callout relative pointer=\meta{coordinate} (initially {\ttfamily\char`\\pgfpointpolar\char`\{315\char`\}\char`\{.5cm\char`\}})}
- Set the vector of the callout pointer `relative' to the callout
+ Sets the vector of the callout pointer `relative' to the callout
shape.
\end{key}
\begin{key}{/pgf/callout absolute pointer=\meta{coordinate}}
- Set the vector of the callout pointer absolutely within the picture.
+ Sets the vector of the callout pointer absolutely within the picture.
\end{key}
@@ -1932,7 +2026,7 @@ on whether they are being used in \pgfname{} or \tikzname{}.
the following key:
\begin{key}{/pgf/callout pointer shorten=\meta{distance} (initially 0cm)}
- Move the callout pointer towards the center of the callouts main
+ Moves the callout pointer towards the center of the callout's main
shape by \meta{distance}.
\begin{codeexample}[]
@@ -1957,14 +2051,14 @@ on whether they are being used in \pgfname{} or \tikzname{}.
\begin{key}{/pgf/callout pointer width=\meta{length} (initially .25cm)}
- Set the width of the pointer at the border of the rectangle.
+ Sets the width of the pointer at the border of the rectangle.
\end{key}
The anchors for this shape are shown below (anchor |60| is an
example of a border anchor). The pointer direction is ignored when
placing anchors.
Additionally, when using an absolute pointer, the |pointer|
- anchor should not be used to used to position the shape as it is
+ anchor should not to be used to used to position the shape as it is
calculated whilst the shape is being drawn.
\begin{codeexample}[]
@@ -1991,7 +2085,7 @@ on whether they are being used in \pgfname{} or \tikzname{}.
\begin{shape}{ellipse callout}%
- This shape is a callout whose main shape is a ellipse, which
+ This shape is a callout whose main shape is an ellipse, which
tightly fits the node contents (including any |inner sep|).
It uses the |absolute callout pointer|,
|relative callout pointer| and |callout pointer shorten| keys, and
@@ -1999,7 +2093,7 @@ on whether they are being used in \pgfname{} or \tikzname{}.
\begin{key}{/pgf/callout pointer arc=\meta{angle} (initially 15)}
- Set the width of pointer at the border of the ellipse according
+ Sets the width of the pointer at the border of the ellipse according
to an arc of length \meta{angle}.
\end{key}
@@ -2053,7 +2147,7 @@ The main shape can be modified using the same keys as the |cloud|
shape. The following keys are also supported:
\begin{key}{/pgf/callout pointer start size=\meta{value} (initially .2 of callout)}
- Set the size of the first segment in the pointer (i.e., the segment
+ Sets the size of the first segment in the pointer (i.e., the segment
nearest the main cloud shape). There are three possible forms for
\meta{value}:
\begin{itemize}
@@ -2072,11 +2166,11 @@ shape. The following keys are also supported:
\end{key}
\begin{key}{/pgf/callout pointer end size=\meta{value} (initially .1 of callout)}
- Set the size of the last ellipse in the pointer.
+ Sets the size of the last ellipse in the pointer.
\end{key}
\begin{key}{/pgf/callout pointer segments=\meta{number} (initially 2)}
- Set the number of segments in the pointer. Note that \pgfname{} will
+ Sets the number of segments in the pointer. Note that \pgfname{} will
happily overlap segments if too many are specified.
\end{key}
@@ -2116,13 +2210,13 @@ of the last segment is drawn at the |pointer| anchor.
\subsection{Miscellaneous Shapes}
\begin{pgflibrary}{shapes.misc}
- This library defines general-purpose shapes that do not fit in the
+ This library defines general-purpose shapes that do not fit into the
previous categories.
\end{pgflibrary}
\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
+ two diagonal lines between the corners of the node's bounding
box. Here is an example:
\begin{codeexample}[]
@@ -2172,7 +2266,7 @@ Strike \tikz[baseline] \node [strike out,draw,anchor=text] {me}; out!
\begin{shape}{rounded rectangle}
- This shape is a rectangle which can be optionally round sides.
+ This shape is a rectangle which can have optionally rounded sides.
\begin{codeexample}[]
\begin{tikzpicture}
@@ -2186,7 +2280,7 @@ Strike \tikz[baseline] \node [strike out,draw,anchor=text] {me}; out!
\begin{key}{/pgf/rounded rectangle arc length=\meta{angle} (initially 180)}
- Set the length of the arcs for the rounded ends. Recommended values
+ Sets the length of the arcs for the rounded ends. Recommended values
for \meta{angle} are between |90| and |180|.
\begin{codeexample}[]
@@ -2201,7 +2295,7 @@ Strike \tikz[baseline] \node [strike out,draw,anchor=text] {me}; out!
\end{key}
\begin{key}{/pgf/rounded rectangle west arc=\meta{arc type} (initially convex)}
- Set the style of the rounding for the left side. The permitted values
+ Sets the style of the rounding for the left side. The permitted values
for \meta{arc type} are |concave|, |convex|, or |none|.
\begin{codeexample}[]
@@ -2219,7 +2313,7 @@ Strike \tikz[baseline] \node [strike out,draw,anchor=text] {me}; out!
\end{stylekey}
\begin{key}{/pgf/rounded rectangle east arc=\meta{arc type} (initially convex)}
- Set the style of the rounding for the east side.
+ Sets the style of the rounding for the east side.
\end{key}
\begin{stylekey}{/pgf/rounded rectangle right arc=\meta{arc type}}
@@ -2265,7 +2359,7 @@ Strike \tikz[baseline] \node [strike out,draw,anchor=text] {me}; out!
these keys in \tikzname{} simply remove the \declare{|/pgf/|} path).
\begin{key}{/pgf/chamfered rectangle angle=\meta{angle} (initially 45)}
- Set the angle \emph{from the vertical} for the chamfer.
+ Sets the angle \emph{from the vertical} for the chamfer.
\begin{codeexample}[]
\begin{tikzpicture}
@@ -2277,7 +2371,7 @@ Strike \tikz[baseline] \node [strike out,draw,anchor=text] {me}; out!
\end{key}
\begin{key}{/pgf/chamfered rectangle xsep=\meta{length} (initially .666ex)}
- Set the distance that the chamfer extends horizontally beyond the node
+ Sets the distance that the chamfer extends horizontally beyond the node
contents (which includes the |inner sep|).
If \meta{length} is large, such
that the top and bottom chamfered edges would cross, then
@@ -2295,7 +2389,7 @@ Strike \tikz[baseline] \node [strike out,draw,anchor=text] {me}; out!
\end{key}
\begin{key}{/pgf/chamfered rectangle ysep=\meta{length} (initially .666ex)}
- Set the distance that the chamfer extends vertically beyond the node
+ Sets the distance that the chamfer extends vertically beyond the node
contents.
If \meta{length} is large, such that the left and right chamfered
edges would cross, then \meta{length} is ignored and the chamfered
@@ -2303,11 +2397,11 @@ Strike \tikz[baseline] \node [strike out,draw,anchor=text] {me}; out!
\end{key}
\begin{key}{/pgf/chamfered rectangle sep=\meta{length} (initially .666ex)}
- Set both the |xsep| and |ysep| simultaneously.
+ Sets both the |xsep| and |ysep| simultaneously.
\end{key}
\begin{key}{/pgf/chamfered rectangle corners=\meta{list} (initially chamfer all)}
- Specify which corners are chamfered. The corners are identified by
+ Specifies which corners are chamfered. The corners are identified by
their ``compass point'' directions (i.e. |north east|, |north west|,
|south west|, and |south east|), and must be separated by commas (so
if there is more than one corner in the list, it must be surrounded