summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-points.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-points.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-points.tex42
1 files changed, 32 insertions, 10 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-points.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-points.tex
index 931a6a7bcf9..833118bdf57 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-points.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-points.tex
@@ -121,7 +121,7 @@ $y$-vector do not necessarily point ``horizontally'' and
\end{command}
\begin{command}{\pgfsetyvec\marg{point}}
- Works like |\pgfsetyvec|.
+ Works like |\pgfsetxvec|.
\end{command}
@@ -178,7 +178,7 @@ three dimensional graphics.
\end{command}
\begin{command}{\pgfsetzvec\marg{point}}
- Works like |\pgfsetzvec|.
+ Works like |\pgfsetxvec|.
\end{command}
Inside the $xyz$-coordinate system, you can also specify points
@@ -206,7 +206,7 @@ using spherical and cylindrical coordinates.
\begin{command}{\pgfpointspherical\marg{longitude}\marg{latitude}\marg{radius}}
This command yields a point ``on the surface of the earth''
- specified by the \meta{longitude} and the \marg{latitude}. The
+ specified by the \meta{longitude} and the \meta{latitude}. The
radius of the earth is given by \meta{radius}. The equator lies in
the $xy$-plane.
\begin{codeexample}[]
@@ -274,7 +274,7 @@ coordinates.
\begin{command}{\pgfpointnormalised\marg{point}}
- This command returns a normalized version of \meta{point}, that is,
+ This command returns a normalised version of \meta{point}, that is,
a vector of length 1pt pointing in the direction of \meta{point}. If
\meta{point} is the $0$-vector or extremely short, a vector of
length 1pt pointing upwards is returned.
@@ -304,7 +304,7 @@ coordinates.
\label{section-pointsattime}
The commands in this section allow you to specify points on a line or
-a curve. Imaging a point ``traveling'' along a curve from some point
+a curve. Imagine a point ``traveling'' along a curve from some point
$p$ to another point $q$. At time $t=0$ the point is at $p$ and at
time $t=1$ it is at $q$ and at time, say, $t=1/2$ it is ``somewhere in
the middle.'' The exact location at time $t=1/2$ will not necessarily
@@ -313,7 +313,7 @@ curve from $p$ and $q$ is equal. Rather, the exact location will
depend on the ``speed'' at which the point is traveling, which in
turn depends on the lengths of the support vectors in a complicated
manner. If you are interested in the details, please see a good book
-on Bézier curves.
+on B\'ezier curves.
@@ -336,7 +336,7 @@ on Bézier curves.
\end{command}
\begin{command}{\pgfpointlineatdistance\marg{distance}\marg{start point}\marg{end point}}
- Yields a point that is located \meta{distance} many units removed
+ Yields a point that is located \meta{distance} many units away
from the start point in the direction of the end point. In other
words, this is the point that results if we travel \meta{distance}
steps from \meta{start point} towards \meta{end point}.
@@ -354,9 +354,31 @@ on Bézier curves.
\end{codeexample}
\end{command}
+\begin{command}{\pgfpointarcaxesattime\marg{time
+ $t$}\marg{center}\marg{0-degree axis}\marg{90-degree
+ axis}\marg{start angle}\\\marg{end angle}}
+ Yields a point on the arc between \meta{start angle} and \meta{end
+ angle} on an ellipse whose center is at \meta{center} and whose
+ two principal axes are \meta{0-degree axis} and \meta{90-degree
+ axis}. For $t=0$ the point at the \meta{start angle} is returned
+ and for $t=1$ the point at the \meta{end angle}.
+
+\begin{codeexample}[]
+\begin{tikzpicture}
+ \draw[help lines] (0,0) grid (3,2);
+ \pgfpathmoveto{\pgfpoint{2cm}{1cm}}
+ \pgfpatharcaxes{0}{60}{\pgfpoint{2cm}{0cm}}{\pgfpoint{0cm}{1cm}}
+ \pgfusepath{stroke}
+ \foreach \t in {0,0.25,0.5,0.75,1}
+ {\pgftext[at=\pgfpointarcaxesattime{\t}{\pgfpoint{0cm}{1cm}}
+ {\pgfpoint{2cm}{0cm}}{\pgfpoint{0cm}{1cm}}{0}{60}]{\t}}
+\end{tikzpicture}
+\end{codeexample}
+\end{command}
+
\begin{command}{\pgfpointcurveattime\marg{time $t$}\marg{point
$p$}\marg{point $s_1$}\marg{point $s_2$}\marg{point $q$}}
- Yields a point that is on the Bézier curve from $p$ to $q$ with the
+ Yields a point that is on the B\'ezier curve from $p$ to $q$ with the
support points $s_1$ and $s_2$. The time $t$ is used to determine
the location, where $t=0$ yields $p$ and $t=1$ yields $q$.
@@ -492,7 +514,7 @@ mechanism to determine border points of shapes.
This library defines the below command and allows you to calculate
the intersections of two arbitrary paths. However, due to the low accuracy of
\TeX, the paths should not be ``too complicated''.
- In particular, you should not try to intersect paths consisting
+ In particular, you should not try to intersect paths consisting of
lots of very small segments such as plots or decorated paths.
\end{pgflibrary}
@@ -611,7 +633,7 @@ takes a coordinate as parameter will just execute this parameter and
then use the values of |\pgf@x| and |\pgf@y| as the coordinates to
which it will move the pen on the current path.
-since commands like |\pgfpointnormalised| modify other variables
+Since commands like |\pgfpointnormalised| modify other variables
besides |\pgf@x| and |\pgf@y| during the computation of the final values of
|\pgf@x| and |\pgf@y|, it is a good idea to enclose a call of a
command like |\pgfpoint| in a \TeX-scope and then make the changes of