summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-point.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-point.tex')
-rw-r--r--macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-point.tex57
1 files changed, 32 insertions, 25 deletions
diff --git a/macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-point.tex b/macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-point.tex
index 03a6721bd2..b0fa58e01f 100644
--- a/macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-point.tex
+++ b/macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-point.tex
@@ -6,7 +6,7 @@ The new macro is \tkzNameMacro{tkzDefPoint}, it allows to use \TIKZ-specific opt
\subsection{Defining a point in Cartesian coordinates: \tkzcname{tkzDefPoint}} \hypertarget{tdp}{}
-\begin{NewMacroBox}{tkzDefPoint}{\oarg{local options}\parg{x,y}\var{name} ou \parg{a:r}\var{name}}%
+\begin{NewMacroBox}{tkzDefPoint}{\oarg{local options}\parg{x,y}\var{name} or \parg{a:r}\var{name}}%
\begin{tabular}{lll}%
arguments & default & definition \\
\midrule
@@ -45,7 +45,7 @@ options & default & definition \\
\end{tkzexample}
\subsection{Placing a label with the library \tkzname{quotes}}
-I prefer not to mix operations and use \tkzcname{tkzLabelPoint} to place labels. See section The Syntax Quotes.
+I prefer not to mix operations and use \tkzcname{tkzLabelPoint} to place labels. See the section "The Quotes Syntax" in the \TIKZ\ manual.
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[trim left=-1cm]
@@ -62,7 +62,7 @@ I prefer not to mix operations and use \tkzcname{tkzLabelPoint} to place labels.
\subsubsection{Rotation with \tkzname{shift} and \tkzname{scope}}
-Preferable to rotate is to use an environment \tkzNameEnv{scope}.
+Preferable to rotate is to use a \tkzNameEnv{scope} environment.
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[scale=.75,rotate=90]
@@ -97,8 +97,8 @@ Here we must follow the syntax of \tkzNamePack{xfp}. It is always possible to go
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Scope et \tkzcname{tkzDefPoint} }
-First, we can use the \tkzNameEnv{scope} de \TIKZ\
+\subsubsection{Scope and \tkzcname{tkzDefPoint}}
+First, we can use the \tkzNameEnv{scope} of \TIKZ.
In the following example, we have a way to define an isosceles triangle.
\begin{tkzexample}[latex=7cm,small]
@@ -120,7 +120,7 @@ In the following example, we have a way to define an isosceles triangle.
\subsection{Definition of points in Cartesian coordinates: \tkzcname{tkzDefPoints}} \hypertarget{tdps}{}
\begin{NewMacroBox}{tkzDefPoints}{\oarg{local options}\var{$x_1/y_1/n_1,x_2/y_2/n_2$, ...}}%
-$x_1$ et $y_1$ are the coordinates of a referenced point $n_1$
+$x_1$ and $y_1$ are the coordinates of a referenced point $n_1$
\begin{tabular}{lll}%
\toprule
@@ -173,7 +173,7 @@ This macro allows you to place one point relative to another. This is equivalent
\end{tkzexample}
\subsection{Point relative to another: \tkzcname{tkzDefShiftPointCoord}}
-\begin{NewMacroBox}{tkzDefShiftPointCoord}{\oarg{a,b}\parg{x,y}\var{name} ou \parg{a:r}\var{name}}%
+\begin{NewMacroBox}{tkzDefShiftPointCoord}{\oarg{a,b}\parg{x,y}\var{name} or \parg{a:r}\var{name}}%
{This involves performing a $(a,b)$ vector translation at the defined point relative to the origin.}
\medskip
@@ -247,7 +247,7 @@ arguments & default & definition \\
\toprule
options & default & definition \\
\midrule
-\TOline{shape} {circle}{Possible \tkzname{cross} ou \tkzname{cross out}}
+\TOline{shape} {circle}{Possible \tkzname{cross} or \tkzname{cross out}}
\TOline{size} {2 pt} {disk size}
\TOline{color} {black}{the default color can be changed}
\bottomrule
@@ -266,7 +266,7 @@ options & default & definition \\
\end{tkzexample}
\subsubsection{Changing the style}
-The default definition in the file \tkzname{tkz-base.cfg}
+The default definition is in the file \tkzname{tkz-base.cfg}
\begin{tkzltxexample}[small]
\tikzset{point style/.style={draw = \tkz@euc@pointcolor,
@@ -369,7 +369,7 @@ options & default & definition\\
\end{tabular}
\medskip
-Optionally, we can use any style of Tikz, especially placement with above, right, dots...
+Optionally, we can use any style of \TIKZ, especially placement with above, right, dots...
\end{NewMacroBox}
\subsubsection{Example with \tkzcname{tkzLabelPoint}}
@@ -407,7 +407,7 @@ It is possible to place several labels quickly when the point references are ide
\begin{tabular}{lll}
arguments & example & result \\
\midrule
-\TAline{list of points}{\tkzcname{tkzLabelPoint(A,B,C)}}{Display of $A$, $B$ and $C$}
+\TAline{list of points}{\tkzcname{tkzLabelPoints(A,B,C)}}{Display of $A$, $B$ and $C$}
\bottomrule
\end{tabular}
@@ -429,17 +429,25 @@ This macro reduces the number of lines of code, but it is not obvious that all p
% tkzAutoLabelPoints
%<--------------------------------------------------------------------------->
\subsection{Automatic position of labels \tkzcname{tkzAutoLabelPoints}}
-The label of a point is placed in a direction defined by a center and a point \tkzname{center}. The distance to the point is determined by a percentage of the distance between the center and the point. This percentage is given by \tkzname{dist}.
+The label of a point is placed in a direction defined by a \tkzname{center} and a point . The distance to the point is determined by a percentage of the distance between the center and the point. This percentage is given by \tkzname{dist}.
\begin{NewMacroBox}{tkzLabelPoints}{\oarg{local options}\parg{$A_1,A_2,...$}}%
\begin{tabular}{lll}
arguments & example & result \\
\midrule
\TAline{list of points}{\tkzcname{tkzLabelPoint(A,B,C)}}{Display of $A$, $B$ and $C$}
\end{tabular}
+
+\medskip
+\begin{tabular}{lll}
+options & default & definition \\
+\midrule
+\TOline{center}{no default}{you need to deisgn a center}
+\TOline{dist}{0.15}{percentage change in the distance between the center and the points}
+\end{tabular}
\end{NewMacroBox}
-\subsubsection{Example with \tkzcname{tkzAutoLabelPoints}}
-Here the points are positioned relative to the center of gravity of $A,B,C \text{et} O$.
+\subsubsection{Example 1 with \tkzcname{tkzAutoLabelPoints}}
+Here the points are positioned relative to the center of gravity of $A,B,C \ \text{et}\ O$.
\begin{tkzexample}[latex=5cm,small]
\begin{tikzpicture}[scale=1.25]
\tkzDefPoint(2,1){O}
@@ -459,7 +467,7 @@ Here the points are positioned relative to the center of gravity of $A,B,C \text
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Example with \tkzcname{tkzAutoLabelPoints}}
+\subsubsection{Example 2 with \tkzcname{tkzAutoLabelPoints}}
This time the reference is $O$ and the distance is by default $0.15$.
\begin{tkzexample}[latex=5cm,small]
\begin{tikzpicture}[scale=1.25]
@@ -486,8 +494,8 @@ options & default & definition \\
\midrule
\TOline{shape}{circle}{possible: circle, cross, cross out}
\TOline{size}{current }{the size of the point is size * line width }
-\TOline{color}{current}{example \tkzcname{tkzLabelPoint(A,B,C)}}
-\TOline{fill}{current!50}{example \tkzcname{tkzLabelPoint(A,B,C)}}
+\TOline{color}{current}{}
+\TOline{fill}{current!50}{}
\end{tabular}
\end{NewMacroBox}
@@ -505,7 +513,7 @@ This is a macro for choosing a \hypertarget{setupoint}{style} for points.
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Example with \tkzcname{tkzSetUpPoint}}
+\subsubsection{Second example with \tkzcname{tkzSetUpPoint}}
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}
\tkzInit[ymin=-0.5,ymax=3,xmin=-0.5,xmax=7]
@@ -558,8 +566,11 @@ argument & example & explanation \\
option & default & explication \\
\midrule
\TOline{xlabel}{empty}{label abscissa}
-\TOline{xstyle}{empty}{style for the abscissa label node}
-\TOline{noxdraw}{false}{boolean so as not to draw an arrow to $(x'x)$}
+\TOline{xstyle}{empty}{style for the abscissa label node example |text=red|}
+\TOline{noxdraw}{false}{boolean for not draw an arrow to the X-axis $(x'x)$}
+\TOline{ylabel}{empty}{idem}
+\TOline{ystyle}{empty}{idem}
+\TOline{noydraw}{false}{idem}
\end{tabular}
\end{NewMacroBox}
@@ -585,8 +596,6 @@ Here are some of the main styles:
\end{tkzltxexample}
\subsubsection{Example with \tkzcname{tkzPointShowCoord}}
-Without the options, you only get the arrows.
-
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[scale=1.5]
@@ -603,8 +612,6 @@ Without the options, you only get the arrows.
\end{tkzexample}
\subsubsection{Example with \tkzcname{tkzPointShowCoord} and \tkzname{xstep}}
-Without the options, you only get the arrows.
-
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[xscale=3,yscale=2]
@@ -621,7 +628,7 @@ Without the options, you only get the arrows.
\subsection{\tkzcname{tkzDefSetOfPoints}} % (fold)
It was already possible to create a scatter plot with the macro \tkzcname{tkzDefPoints}, but this requires making a reference (a name) to each point, which is sometimes tedious. The macro \tkzcname{tkzSetOfPoints} allows to define points \tkzname{tkzPt1}, \tkzname{tkzPt2}, etc.
-This is frequently referred to as \hypertarget{label_tkzDefSetOfPoints}{« scatter plot"}. The difference from the macro \tkzcname{tkzDefPoints} is that the reference to the points is given by a prefix (default tkzPt) and the point number.
+This is frequently referred to as \hypertarget{label_tkzDefSetOfPoints}{ "scatter plot"}. The difference from the macro \tkzcname{tkzDefPoints} is that the reference to the points is given by a prefix (default \tkzname{tkzPt}) and the point number.
The points are not drawn.
\begin{NewMacroBox}{tkzDefSetOfPoints}{\oarg{local options}\var{$x_1/y_1,x_2/y_2,\ldots,x_n/y_n$}}%