summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-paths.tex
diff options
context:
space:
mode:
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.tex61
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.