diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-paths.tex')
| -rw-r--r-- | Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-paths.tex | 61 |
1 files changed, 31 insertions, 30 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-paths.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-paths.tex index 5284f22bb36..eacaa4b84e8 100644 --- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-paths.tex +++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-paths.tex @@ -16,7 +16,7 @@ The ``basic entity of drawing'' in \pgfname\ is the \emph{path}. A path consists of several parts, each of which is either a closed or open curve. An open curve has a starting point and an end point and, in between, consists of several \emph{segments}, each of which is -either a straight line or a Bézier curve. Here is an example of a +either a straight line or a B\'ezier curve. Here is an example of a path (in red) consisting of two parts, one open, one closed: \begin{codeexample}[] @@ -58,7 +58,7 @@ Section~\ref{section-bb} for more details. Each path construction command extends the current path in some way. The ``current path'' is a global entity that persists across \TeX\ groups. Thus, between calls to the path construction commands -you can perform arbitrary computations and even open and closed \TeX\ +you can perform arbitrary computations and even open and close \TeX\ groups. The current path only gets ``flushed'' when the |\pgfusepath| command is called (or when the soft-path subsystem is used directly, see Section~\ref{section-soft-paths}). @@ -83,7 +83,7 @@ can also be used to start a new part of a path. \pgfpathlineto{\pgfpoint{2cm}{1cm}} \pgfpathlineto{\pgfpoint{3cm}{0.5cm}} \pgfpathlineto{\pgfpoint{3cm}{0cm}} - \pgfsetfillcolor{examplefill} + \pgfsetfillcolor{yellow!80!black} \pgfusepath{fill,stroke} \end{pgfpicture} \end{codeexample} @@ -95,14 +95,14 @@ can also be used to start a new part of a path. \pgfpathmoveto{\pgfpoint{2cm}{1cm}} % New part \pgfpathlineto{\pgfpoint{3cm}{0.5cm}} \pgfpathlineto{\pgfpoint{3cm}{0cm}} - \pgfsetfillcolor{examplefill} + \pgfsetfillcolor{yellow!80!black} \pgfusepath{fill,stroke} \end{pgfpicture} \end{codeexample} The command will apply the current coordinate transformation matrix to \meta{coordinate} before using it. - The command will update the bounding box of the current path and + It will update the bounding box of the current path and picture, if necessary. \end{command} @@ -121,14 +121,14 @@ can also be used to start a new part of a path. \pgfpathmoveto{\pgfpointorigin} \pgfpathlineto{\pgfpoint{1cm}{1cm}} \pgfpathlineto{\pgfpoint{2cm}{1cm}} - \pgfsetfillcolor{examplefill} + \pgfsetfillcolor{yellow!80!black} \pgfusepath{fill,stroke} \end{pgfpicture} \end{codeexample} The command will apply the current coordinate transformation matrix to \meta{coordinate} before using it. - The command will update the bounding box of the current path and + It will update the bounding box of the current path and picture, if necessary. \end{command} @@ -136,10 +136,10 @@ can also be used to start a new part of a path. \subsection{The Curve-To Path Operations} \begin{command}{\pgfpathcurveto\marg{support 1}\marg{support 2}\marg{coordinate}} - This command extends the current path with a Bézier curve from the + This command extends the current path with a B\'ezier curve from the last point of the path to \meta{coordinate}. The \meta{support 1} and \meta{support 2} are the first and second support point of the - Bézier curve. For more information on Bézier curve, please consult a + B\'ezier curve. For more information on B\'ezier curves, please consult a standard textbook on computer graphics. Like the line-to command, this command may not be the first path @@ -149,14 +149,14 @@ can also be used to start a new part of a path. \pgfpathmoveto{\pgfpointorigin} \pgfpathcurveto {\pgfpoint{1cm}{1cm}}{\pgfpoint{2cm}{1cm}}{\pgfpoint{3cm}{0cm}} - \pgfsetfillcolor{examplefill} + \pgfsetfillcolor{yellow!80!black} \pgfusepath{fill,stroke} \end{pgfpicture} \end{codeexample} The command will apply the current coordinate transformation matrix to \meta{coordinate} before using it. - The command will update the bounding box of the current path and + It will update the bounding box of the current path and picture, if necessary. However, the bounding box is simply made large enough such that it encompasses all of the support points and the \meta{coordinate}. This will guarantee that the curve is @@ -168,14 +168,14 @@ can also be used to start a new part of a path. \begin{command}{\pgfpathquadraticcurveto\marg{support}\marg{coordinate}} This command works like |\pgfpathcurveto|, only it uses a quadratic - Bézier curve rather than a cubic one. This means that only one + B\'ezier curve rather than a cubic one. This means that only one support point is needed. \begin{codeexample}[] \begin{pgfpicture} \pgfpathmoveto{\pgfpointorigin} \pgfpathquadraticcurveto {\pgfpoint{1cm}{1cm}}{\pgfpoint{2cm}{0cm}} - \pgfsetfillcolor{examplefill} + \pgfsetfillcolor{yellow!80!black} \pgfusepath{fill,stroke} \end{pgfpicture} \end{codeexample} @@ -189,7 +189,7 @@ can also be used to start a new part of a path. \end{command} -There exist two commands to draw only part of a cubic Bézier curve: +There exist two commands to draw only part of a cubic B\'ezier curve: \begin{command}{\pgfpathcurvebetweentime\marg{time $t_1$}\marg{time $t_2$}\marg{point p}\marg{point $s_1$}\marg{point $s_2$}\marg{point q}} @@ -257,7 +257,7 @@ circles to a path are described. \begin{command}{\pgfpatharc\marg{start angle}\marg{end angle}{\ttfamily\char`\{}\meta{radius}\opt{| and |\meta{y-radius}}{\ttfamily\char`\}}} This command appends a part of a circle (or an ellipse) to the current - path. Imaging the curve between \meta{start angle} and \meta{end + path. Imagine the curve between \meta{start angle} and \meta{end angle} on a circle of radius \meta{radius} (if $\meta{start angle} < \meta{end angle}$, the curve goes around the circle counterclockwise, otherwise clockwise). This curve is now moved such @@ -398,7 +398,7 @@ circles to a path are described. are numerically very unstable. In particular, the arc will not always really end at the \meta{target coordinate}, but may be off by up to several points. A more precise positioning is currently - infeasible due to \TeX's numerical weaknesses. The only case that + infeasible due to \TeX's numerical weaknesses. The only case it works quite nicely is when the resulting angle is a multiple of~$90^\circ$. \end{command} @@ -406,7 +406,7 @@ circles to a path are described. \begin{command}{\pgfpatharctoprecomputed\marg{center point}\marg{start angle}\marg{end angle}\marg{end point}\\\marg{x-radius}\marg{y-radius}\marg{ratio x-radius/y-radius}\marg{ratio y-radius/x-radius}} A specialized arc operation which is fast and numerically stable, provided a lot of information is given in advance. - In contrast to |\pgfpatharc|, it explicitly interpolates start- and end points. + In contrast to |\pgfpatharc|, it explicitly interpolates start and end points. In contrast to |\pgfpatharcto|, this routine is numerically stable and quite fast since it relies on a lot of available information. \begin{codeexample}[] @@ -438,8 +438,9 @@ circles to a path are described. \end{codeexample} \begin{command}{\pgfpatharctomaxstepsize} - The quality of arc approximation taken by |\pgfpatharctoprecomputed| by means of Bezier splines is % TODOsp: Bezier --> Bézier? - controlled by a mesh width, which is initially + The quality of arc approximation taken by + |\pgfpatharctoprecomputed| by means of B\'ezier splines is + controlled by a mesh width, which is initially |\def\pgfpatharctoprecomputed{45}|. @@ -539,15 +540,15 @@ start a new part of the path. \subsection{The Grid Path Operation} -\begin{command}{\pgfpathgrid\oarg{options}\marg{lower left}\marg{upper right}} +\begin{command}{\pgfpathgrid\oarg{options}\marg{first corner}\marg{second corner}} Appends a grid to the current path. That is, a (possibly large) number of parts are added to the path, each part consisting of a single horizontal or vertical straight line segment. Conceptually, the origin is part of the grid and the grid is clipped - to the rectangle specified by the \meta{lower left} and - the \meta{upper right} corner. However, no clipping occurs (this - command just adds parts to the current path). Rather, the points + to the rectangle specified by the \meta{first corner} and + the \meta{second corner}. However, no clipping occurs (this + command just adds parts to the current path) and the points where the lines enter and leave the ``clipping area'' are computed and used to add simple lines to the current path. @@ -575,7 +576,7 @@ start a new part of the path. \end{pgfpicture} \end{codeexample} The command will apply coordinate transformations and update the - bounding boxes tightly. As for ellipses, the transformations are + bounding boxes. As for ellipses, the transformations are applied to the ``conceptually finished'' grid. \begin{codeexample}[] \begin{pgfpicture} @@ -592,14 +593,14 @@ start a new part of the path. \begin{command}{\pgfpathparabola\marg{bend vector}\marg{end vector}} This command appends two half-parabolas to the current path. The first starts at the current point and ends at the current point plus - \meta{bend vector}. At his point, it has its bend. The second half - parabola starts at that bend point and end at point that is given by + \meta{bend vector}. At this point, it has its bend. The second half + parabola starts at that bend point and ends at point that is given by the bend plus \meta{end vector}. If you set \meta{end vector} to the null vector, you append only a half parabola that goes from the current point to the bend; by setting \meta{bend vector} to the null vector, you append only a - half parabola that goes to current point plus \meta{end vector} and + half parabola that goes through the current point and \meta{end vector} and has its bend at the current point. It is not possible to use this command to draw a part of a parabola @@ -672,7 +673,7 @@ cosine curves in intervals that are multiples of $\pi/2$. \pgfpathcosine{\pgfpoint{1cm}{-1cm}} \pgfpathsine{\pgfpoint{1cm}{-1cm}} \pgfpathcosine{\pgfpoint{1cm}{1cm}} - \pgfsetfillcolor{examplefill} + \pgfsetfillcolor{yellow!80!black} \pgfusepath{fill,stroke} \end{pgfpicture} \end{codeexample} @@ -693,7 +694,7 @@ documented in Section~\ref{section-plots}. \subsection{Rounded Corners} Normally, when you connect two straight line segments or when you -connect two curves that end and start ``at different angles'' you get +connect two curves that end and start ``at different angles,'' you get ``sharp corners'' between the lines or curves. In some cases it is desirable to produce ``rounded corners'' instead. Thus, the lines or curves should be shortened a bit and then connected by arcs. @@ -841,7 +842,7 @@ are (globally) updated. To facilitate this, you can use the following command: \begin{command}{\pgf@protocolsizes\marg{x-dimension}\marg{y-dimension}} - Updates all of the above dimension in such a way that the point + Updates all of the above dimensions in such a way that the point specified by the two arguments is inside both bounding boxes. For the picture's bounding box this updating occurs only if |\ifpgf@relevantforpicturesize| is true, see below. |