diff options
author | Karl Berry <karl@freefriends.org> | 2010-10-29 00:31:31 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-10-29 00:31:31 +0000 |
commit | 6bc1f5497cfb2f56d65c80a4c36ea3bad6dc046c (patch) | |
tree | f7751da75030fb1e06653eeb44e579fcee09c65f /Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-matrices.tex | |
parent | ed0c7c756e441b2d2ba3633da233fc24361ac0d3 (diff) |
pgf 2.10 (28oct10)
git-svn-id: svn://tug.org/texlive/trunk@20236 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-matrices.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-matrices.tex | 48 |
1 files changed, 24 insertions, 24 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-matrices.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-matrices.tex index 201fe734c2c..d77f1312123 100644 --- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-matrices.tex +++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-matrices.tex @@ -18,7 +18,7 @@ \subsection{Overview} -Matrices are a mechanism for aligning several so-called cell pictures +Matrices are a mechanism for aligning several so-called cell pictures horizontally and vertically. The resulting alignment is placed in a normal node and the command for creating matrices, |\pgfmatrix|, takes options very similar to the |\pgfnode| command. @@ -36,7 +36,7 @@ the special command |\pgfmatrixnextcell|, rows are ended using the command |\pgfmatrixendrow| (the command |\\| is setup to mean the same as |\pgfmatrixendrow| by default). Each cell contains a \emph{cell picture}, although cell pictures are not complete pictures as they -lack layers. However, each cell picture has its own bouding box like a +lack layers. However, each cell picture has its own bounding box like a normal picture does. These bounding boxes are important for the alignment as explained in the following. @@ -96,7 +96,7 @@ All matrices are typeset using the following command: path(s) of the resulting node are stroked or filled or whatever. \medskip - \textbf{Specifiying the cells and rows.\ } + \textbf{Specifying the cells and rows.\ } Even though this command uses |\halign| internally, there are two special rules for indicating cells: \begin{enumerate} @@ -112,12 +112,12 @@ All matrices are typeset using the following command: like |{minipage}| redefine |\\|, so it is good to have |\pgfmatrixendrow| as a ``fallback.'' \item Every row \emph{including the last row} must be ended using - the command |\\| or |\pgfmatrixendrow|. + the command |\\| or |\pgfmatrixendrow|. \end{enumerate} Both |\pgfmatrixnextcell| and |\pgfmatrixendrow| (and, thus, also |\\|) take an optional argument as explained in the - Section~\ref{section-matrix-spacing} + Section~\ref{section-matrix-spacing} \begin{codeexample}[] \begin{tikzpicture} @@ -142,15 +142,15 @@ All matrices are typeset using the following command: box. The origin of this coordinate system is at the left baseline end of the matrix box, which corresponds to the |text| anchor. The position \meta{shift} is then interpreted inside this coordinate - system and then used for shifting. + system and then used for shifting. This allows you to use the parameter \meta{shift} in the following way: If you use |text| as the \meta{anchor} and specify |\pgfpointanchor{inner node}{some anchor}| for the parameter - \meta{shift}, where |inner node| is a node that + \meta{shift}, where |inner node| is a node that is created in the matrix, then the whole matrix will be shifted such that |inner node.some anchor| lies at the origin of the whole - picture. + picture. \medskip \textbf{Rotations and scaling.\ } @@ -166,10 +166,10 @@ All matrices are typeset using the following command: \medskip \textbf{Callbacks.\ } - At the beginning and at the end of each cell the special macros + At the beginning and at the end of each cell the special macros |\pgfmatrixbegincode|, |\pgfmatrixendcode| and possibly |\pgfmatrixemptycode| are called. The effect is explained in - Section~\ref{section-matrix-callbacks}. + Section~\ref{section-matrix-callbacks}. \medskip \textbf{Executing extra code.\ } @@ -180,14 +180,14 @@ All matrices are typeset using the following command: \begin{enumerate} \item It can be used to simplify the next cell macro. For example, saying |\let\&=\pgfmatrixnextcell| allows you to use |\&| instead - of |\pgfmatrixnextcell|. You can also set the catcode of |&| to + of |\pgfmatrixnextcell|. You can also set the catcode of |&| to active. \item It can be used to issue an |\aftergroup| command. This allows you to regain control after the |\pgfmatrix| command. (If you do not know the |\aftergroup| command, you are probably blessed with a simple and happy life.) \end{enumerate} - + \medskip \textbf{Special considerations concerning macro expansion.\ } As said before, the matrix is typeset using |\halign| @@ -200,7 +200,7 @@ All matrices are typeset using the following command: that the macros inside \meta{matrix cells} expand to these macros sooner or later. \item In particular, you can define clever macros that insert - columns and rows as needed for special effects. + columns and rows as needed for special effects. \end{itemize} \end{command} @@ -218,7 +218,7 @@ commands for the column spacing. \end{command} \begin{command}{\pgfmatrixnextcell\opt{\oarg{additional sep list}}} - This command has two puposes: First, it is used to separate + This command has two purposes: First, it is used to separate cells. Second, by providing the optional argument \meta{additional sep list} you can modify the spacing between the columns that are separated by this command. @@ -241,11 +241,11 @@ commands for the column spacing. argument is missing, only the default separation list is processed. \item Both lists may contain dimensions, separated by commas, as - well as occurences of the keywords |between origins| and + well as occurrences of the keywords |between origins| and |between borders|. - \item All dimensions occuring in either list are added together to + \item All dimensions occurring in either list are added together to arrive at an dimension $d$. - \item The last occurence of either of the keywords is located. If + \item The last occurrence of either of the keywords is located. If neither keyword is present, we proceed as if |between borders| were present. \end{enumerate} @@ -264,7 +264,7 @@ commands for the column spacing. distance between these two lines is exactly $d$. This mode may only be used between columns \emph{already - introduced in the first row}. + introduced in the first row}. \end{itemize} All of the above rules boil down to the following effects: \begin{itemize} @@ -281,7 +281,7 @@ commands for the column spacing. \item You can now use the optional argument of |\pgfmatrixnextcell| to locally overrule the spacing between two columns. By saying |\pgfmatrixnextcell[5pt]| you \emph{add} 5pt to the space between - of the two columns, regadless of the mode. + of the two columns, regardless of the mode. You can also (locally) change the spacing mode for these two columns. For example, even if the normal spacing mode is @@ -370,7 +370,7 @@ change the appearance of cells in a very general manner. \begin{command}{\pgfmatrixemptycode} This macro is executed for empty cells. This means that \pgfname\ uses some macro magic to determine whether a cell is empty (it - immediatly ends with |\pgfmatrixemptycode| or |\pgfmatrixendrow|) + immediately ends with |\pgfmatrixemptycode| or |\pgfmatrixendrow|) and, if so, put this macro inside the cell. \begin{codeexample}[] \begin{tikzpicture} @@ -422,15 +422,15 @@ current column in a callback: \begin{command}{\pgfmatrixcurrentrow} This counter stores the current row of the current cell of the - matrix. Do not even think of changing this counter. + matrix. Do not even think of changing this counter. \end{command} \begin{command}{\pgfmatrixcurrentcolumn} This counter stores the current column of the current cell of the - matrix. + matrix. \end{command} -%%% Local Variables: +%%% Local Variables: %%% mode: latex %%% TeX-master: "pgfmanual" -%%% End: +%%% End: |