summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fit.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fit.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fit.tex133
1 files changed, 67 insertions, 66 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fit.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fit.tex
index 2a521518498..1e0fbbd8f25 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fit.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fit.tex
@@ -12,31 +12,32 @@
\label{section-library-fit}
\begin{tikzlibrary}{fit}
- The library defines (currently only two) options for fitting a node
- so that it contains a set of coordinates.
+ The library defines (currently only two) options for fitting a node so that
+ it contains a set of coordinates.
\end{tikzlibrary}
When you load this library, the following options become available:
\begin{key}{/tikz/fit=\meta{coordinates or nodes}}
- This option must be given to a |node| path command. The
- \meta{coordinates or nodes} should be a sequence of \tikzname\
- coordinates or node names, one directly after the other without
- commas (like with the |plot coordinates| path operation). Examples
- are |(1,0) (2,2)| or |(a) (1,0) (b)|, where |a| and |b| are nodes.
-
- For this sequence of coordinates, a minimal bounding box is computed
- that encompasses all the listed \meta{coordinates or nodes}. For
- coordinates in the list, the bounding box is guaranteed to contain
- this coordinate, for nodes it is guaranteed to contain the |east|,
- |west|, |north| and |south| anchors of the node. In principle (the
- details will be explained in a moment), things are now set up such
- that the text box of the node will be exactly this bounding box.
-
- Here is an example: We fit several points in a rectangular node. By
- setting the |inner sep| to zero, we see exactly the text box of the
- node. Then we fit these points again in a circular node. Note how
- the circle encompasses exactly the same bounding box.
+ This option must be given to a |node| path command. The \meta{coordinates
+ or nodes} should be a sequence of \tikzname\ coordinates or node names,
+ one directly after the other without commas (like with the
+ |plot coordinates| path operation). Examples are |(1,0) (2,2)| or
+ |(a) (1,0) (b)|, where |a| and |b| are nodes.
+
+ For this sequence of coordinates, a minimal bounding box is computed that
+ encompasses all the listed \meta{coordinates or nodes}. For coordinates in
+ the list, the bounding box is guaranteed to contain this coordinate, for
+ nodes it is guaranteed to contain the |east|, |west|, |north| and |south|
+ anchors of the node. In principle (the details will be explained in a
+ moment), things are now set up such that the text box of the node will be
+ exactly this bounding box.
+
+ Here is an example: We fit several points in a rectangular node. By setting
+ the |inner sep| to zero, we see exactly the text box of the node. Then we
+ fit these points again in a circular node. Note how the circle encompasses
+ exactly the same bounding box.
+ %
\begin{codeexample}[]
\begin{tikzpicture}[inner sep=0pt,thick,
dot/.style={fill=blue,circle,minimum size=3pt}]
@@ -52,44 +53,45 @@ When you load this library, the following options become available:
\end{tikzpicture}
\end{codeexample}
- Every time the |fit| option is used, the following style is also
- applied to the node:
- \begin{stylekey}{/tikz/every fit (initially \normalfont empty)}
- Set this style to change the appearance of a node that uses the
- |fit| option.
- \end{stylekey}
-
- The exact effects of the |fit| option are the following:
- \begin{enumerate}
- \item A minimal bounding box containing all coordinates is
- computed. Note that if a coordinate like |(a)| is used that
- contains a node name, this has the same effect as explicitly
- providing the |(a.north)| and |(a.south)| and |(a.west)| and
- |(a.east)|. If you wish to refer only to the center of the |a|
- node, use |(a.center)| instead.
- \item The |text width| option is set to the width of this bounding box.
- \item The |align=center| option is set.
- \item The |anchor| is set to |center|.
- \item The |at| position of the node is set to the center of the
- computed bounding box.
- \item After the node has been typeset, its height and depth are
- adjusted such that they add up to the height of the computed
- bounding box and such that the text of the node is vertically
- centered inside the box.
- \end{enumerate}
- The above means that, generally speaking, if the node contains text
- like |box| in the above example, it will be centered inside the
- box. It will be difficult to put the text elsewhere, in particular,
- changing the |anchor| of the node will not have the desired
- effect. Instead, what you should do is to create a node with the
- |fit| option that does not contain any text, give it a name, and
- then use normal nodes to add text at the desired
- positions. Alternatively, consider using the |label| or |pin|
- options.
-
- Suppose, for instance, that in the above example we want the word
- ``box'' to appear inside the box, but at its top. This can be
- achieved as follows:
+ Every time the |fit| option is used, the following style is also applied to
+ the node:
+ %
+ \begin{stylekey}{/tikz/every fit (initially \normalfont empty)}
+ Set this style to change the appearance of a node that uses the |fit|
+ option.
+ \end{stylekey}
+
+ The exact effects of the |fit| option are the following:
+ %
+ \begin{enumerate}
+ \item A minimal bounding box containing all coordinates is computed.
+ Note that if a coordinate like |(a)| is used that contains a node
+ name, this has the same effect as explicitly providing the
+ |(a.north)| and |(a.south)| and |(a.west)| and |(a.east)|. If you
+ wish to refer only to the center of the |a| node, use |(a.center)|
+ instead.
+ \item The |text width| option is set to the width of this bounding box.
+ \item The |align=center| option is set.
+ \item The |anchor| is set to |center|.
+ \item The |at| position of the node is set to the center of the
+ computed bounding box.
+ \item After the node has been typeset, its height and depth are
+ adjusted such that they add up to the height of the computed
+ bounding box and such that the text of the node is vertically
+ centered inside the box.
+ \end{enumerate}
+ %
+ The above means that, generally speaking, if the node contains text like
+ |box| in the above example, it will be centered inside the box. It will be
+ difficult to put the text elsewhere, in particular, changing the |anchor|
+ of the node will not have the desired effect. Instead, what you should do
+ is to create a node with the |fit| option that does not contain any text,
+ give it a name, and then use normal nodes to add text at the desired
+ positions. Alternatively, consider using the |label| or |pin| options.
+
+ Suppose, for instance, that in the above example we want the word ``box''
+ to appear inside the box, but at its top. This can be achieved as follows:
+ %
\begin{codeexample}[]
\begin{tikzpicture}[inner sep=0pt,thick,
dot/.style={fill=blue,circle,minimum size=3pt}]
@@ -105,8 +107,8 @@ When you load this library, the following options become available:
\end{tikzpicture}
\end{codeexample}
- Here is a real-life example that uses fitting:
-
+ Here is a real-life example that uses fitting:
+ %
\begin{codeexample}[]
\begin{tikzpicture}
[vertex/.style={minimum size=2pt,fill,draw,circle},
@@ -135,14 +137,13 @@ When you load this library, the following options become available:
\node [fit=(c) (f) (f's parent),label=above right:$F^{(c,R)}$] {};
\end{tikzpicture}
\end{codeexample}
-
+ %
\end{key}
\begin{key}{/tikz/rotate fit=\meta{angle} (initially 0)}
- This key fits \meta{coordinates or nodes} inside a node that is
- rotated by \meta{angle}. As a side effect, it also sets the
- |/tikz/rotate| key.
-
+ This key fits \meta{coordinates or nodes} inside a node that is rotated by
+ \meta{angle}. As a side effect, it also sets the |/tikz/rotate| key.
+ %
\begin{codeexample}[]
\begin{tikzpicture}[inner sep=0pt,thick,
dot/.style={fill=blue,circle,minimum size=3pt}]
@@ -156,5 +157,5 @@ When you load this library, the following options become available:
\node[draw=red, rotate fit=30, fit=(a) (b) (c) (d) (e)] {};
\end{tikzpicture}
\end{codeexample}
-
+ %
\end{key}