summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-point.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-point.tex')
-rw-r--r--Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-point.tex367
1 files changed, 170 insertions, 197 deletions
diff --git a/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-point.tex b/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-point.tex
index 13d1dfdba8d..03a6721bd21 100644
--- a/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-point.tex
+++ b/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-point.tex
@@ -1,40 +1,38 @@
-\section{Les points}
+\section{The points}
-J'ai fait une distinction entre le point utilisé en géométrie euclidienne et le point pour représenter un élément d'un nuage statistique. Dans le premier cas, j'utilise comme objet un \tkzname{node}, ce qui se traduit par le fait que la représentation du point ne peut être modifiée par un \tkzname{scale}; dans le second cas, j'utilise comme objet un \tkzname{plot mark}. Ce dernier peut être mis à l'échelle et posséder des formes plus variées que le node.
+I made a distinction between the point used in Euclidean geometry and the point used to represent an element of a statistical cloud. In the first case, I use as object a \tkzname{node}, which means that the representation of the point cannot be modified by a \tkzname{scale}; in the second case, I use as object a \tkzname{plot mark}. The latter can be scaled and have more varied forms than the node.
-La nouvelle macro est \tkzNameMacro{tkzDefPoint}, celle-ci permet d'utiliser des options propres à \TIKZ\ comme shift et les valeurs sont traitées avec tkz-base. De plus, si des calculs sont nécessaires alors c'est le package \tkzNamePack{xfp} qui s'en charge. On peut utiliser les coordonnées cartésiennes ou polaires.
+The new macro is \tkzNameMacro{tkzDefPoint}, it allows to use \TIKZ-specific options as a shift and the values are processed with tkz-base. Moreover, if calculations are needed then the \tkzNamePack{xfp} package takes care of them. You can use Cartesian or polar coordinates.
-\subsection{Définition d'un point en coordonnées cartésiennes : \tkzcname{tkzDefPoint}} \hypertarget{tdp}{}
+\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{tabular}{lll}
-\toprule
-arguments & défaut & définition \\
+\begin{NewMacroBox}{tkzDefPoint}{\oarg{local options}\parg{x,y}\var{name} ou \parg{a:r}\var{name}}%
+\begin{tabular}{lll}%
+arguments & default & definition \\
\midrule
-\TAline{x,y}{no default}{x et y sont deux dimensions, par défaut en cm.}
-\TAline{a:r}{no default}{a est un angle en degré, r une dimension}
+\TAline{x,y}{no default}{$x$ and $y$ are two dimensions, by default in cm.}
+\TAline{a:r}{no default}{$a$ is an angle in degrees, $r$ is a dimension}
\bottomrule
\end{tabular}
\medskip
-\noindent{Les arguments obligatoires de cette macro sont deux dimensions exprimées avec des décimaux, dans le premier cas ce sont deux mesures de longueur, dans le second ce sont une mesure de longueur et la mesure d'un angle en degré}
+\noindent{The mandatory arguments of this macro are two dimensions expressed with decimals, in the first case they are two measures of length, in the second case they are a measure of length and the measure of an angle in degrees}.
\medskip
-\begin{tabular}{lll}
+\begin{tabular}{lll}%
\toprule
-options & défaut & définition \\
+options & default & definition \\
\midrule
-\TOline{shift} {(0,0)} {espacement entre deux valeurs}
+\TOline{shift} {(0,0)} {value spacing}
\bottomrule
\end{tabular}
\medskip
-\noindent{Toutes les options de \TIKZ\ que l'on peut appliquer à \tkzname{coordinate}, sont applicables (enfin je l'espère!) comme par exemple l'option \tkzname{label} définit avec la librairie \tkzname{quotes}.}
+\noindent{All the options of \TIKZ\ that we can apply to \tkzname{coordinate}, are applicable (well I hope!) as for example the option \tkzname{label} defined with the library \tkzname{quotes}.}
\end{NewMacroBox}
-\subsubsection{Utilisation de \tkzname{shift}}
-\tkzname{shift} permet de placer les points par rapport à un autre.
+\subsubsection{Use of \tkzname{shift}}
+\tkzname{shift} allows the points to be placed in relation to each other.
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[trim left=-1cm]
@@ -46,8 +44,8 @@ options & défaut & définition \\
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Placer un label avec la librairie \tkzname{quotes} }
-Je préfère ne pas mélanger les opérations et utiliser \tkzcname{tkzLabelPoint} pour placer les labels. voir la section 17.10.4 The Quotes Syntax.
+\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.
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[trim left=-1cm]
@@ -63,8 +61,8 @@ Je préfère ne pas mélanger les opérations et utiliser \tkzcname{tkzLabelPoin
\end{tkzexample}
-\subsubsection{Rotation avec \tkzname{shift} et \tkzname{scope} }
-Préférable pour effectuer une rotation, est d'utiliser un environnement \tkzNameEnv{scope}.
+\subsubsection{Rotation with \tkzname{shift} and \tkzname{scope}}
+Preferable to rotate is to use an environment \tkzNameEnv{scope}.
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[scale=.75,rotate=90]
@@ -79,8 +77,8 @@ Préférable pour effectuer une rotation, est d'utiliser un environnement \tkzN
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Formules et coordonnées}
-Il faut ici respecter la syntaxe de \tkzNamePack{xfp}. Il est toujours possible de passer par \tkzNamePack{pgfmath} mais dans ce cas, il faut calculer les coordonnées avant d'utiliser la macro \tkzcname{tkzDefPoint}.
+\subsubsection{Forms and coordinates}
+Here we must follow the syntax of \tkzNamePack{xfp}. It is always possible to go through \tkzNamePack{pgfmath} but in this case, the coordinates must be calculated before using the macro \tkzcname{tkzDefPoint}.
\begin{tkzexample}[latex=6cm,small]
\begin{tikzpicture}[scale=.75]
@@ -100,8 +98,8 @@ Il faut ici respecter la syntaxe de \tkzNamePack{xfp}. Il est toujours possible
\end{tkzexample}
\subsubsection{Scope et \tkzcname{tkzDefPoint} }
-On peut tout d'abord utiliser l'environnement \tkzNameEnv{scope} de \TIKZ\
-Dans l'exemple suivant, nous avons un moyen de définir un triangle isocèle.
+First, we can use the \tkzNameEnv{scope} de \TIKZ\
+In the following example, we have a way to define an isosceles triangle.
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[scale=1]
@@ -119,52 +117,47 @@ Dans l'exemple suivant, nous avons un moyen de définir un triangle isocèle.
\end{tikzpicture}
\end{tkzexample}
%<--------------------------------------------------------------------------->
-\subsection{Définition de points en coordonnées cartésiennes : \tkzcname{tkzDefPoints}} \hypertarget{tdps}{}
+\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$ sont les coordonnées d'un point référencé $n_1$
+\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$
-\begin{tabular}{lll}
+\begin{tabular}{lll}%
\toprule
-arguments & exemple & \\
+arguments & example & \\
\midrule
\TAline{$x_i/y_i/n_i$}{\tkzcname{tkzDefPoints\{0/0/O,2/2/A\}}}{}
\end{tabular}
\end{NewMacroBox}
+\subsubsection{Definition of points}
\begin{tkzexample}[latex=6cm,small]
\begin{tikzpicture}[scale=1]
- \tkzDefPoints{% x y name
- 0 /0 /A,
- 2 /0 /B,
- 2 /2 /C,
- 0 /2 /D}
+ \tkzDefPoints{0/0/A,2/0/B,2/2/C,0/2/D}
\tkzDrawSegments(D,A A,B B,C C,D)
- % or with tkz-euclide
- % \tkzDrawPolygon(A,...,D)
+ %with tkz-euclide \tkzDrawPolygon(A,...,D)
\tkzDrawPoints(A,B,C,D)
\end{tikzpicture}
\end{tkzexample}
-\newpage
%<--------------------------------------------------------------------------->
-\subsection{Point relativement à un autre : \tkzcname{tkzDefShiftPoint}}
+\subsection{Point relative to another: \tkzcname{tkzDefShiftPoint}}
\hypertarget{tdsp}{}
-\begin{NewMacroBox}{tkzDefShiftPoint}{\oarg{Point}\parg{x,y}\var{name} ou \parg{a:r}\var{name}}
-\begin{tabular}{lll}
-arguments & défaut & définition \\
+\begin{NewMacroBox}{tkzDefShiftPoint}{\oarg{Point}\parg{x,y}\var{name} ou \parg{a:r}\var{name}}%
+\begin{tabular}{lll}%
+arguments & default & definition \\
\midrule
-\TAline{(x,y)}{no default}{x et y sont deux dimensions, par défaut en cm.}
-\TAline{(a:r)}{no default}{a est un angle en degré, r une dimension}
+\TAline{(x,y)}{no default}{$x$ and $y$ are two dimensions, by default in cm.}
+\TAline{(a:r)}{no default}{$a$ is an angle in degrees, $r$ is a dimension}
\TAline{point} {no default} {\tkzcname{tkzDefShiftPoint}[A](0:4)\{B\}}
\bottomrule
\end{tabular}
-\emph{Pas d'option. Le nom du point est obligatoire.}
+No options. The name of the point is mandatory.
\end{NewMacroBox}
-\subsubsection{Exemple avec \tkzcname{tkzDefShiftPoint}}
-Cette macro permet de placer un point relativement à un autre. Cela revient à une translation. Voici comment construire un triangle isocèle de sommet principal A et d'angle au sommet de $30$ degrés.
+\subsubsection{Example with \tkzcname{tkzDefShiftPoint}}
+This macro allows you to place one point relative to another. This is equivalent to a translation. Here is how to construct an isosceles triangle with main vertex $A$ and angle at vertex of $30^\circ$.
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[rotate=-30]
@@ -179,36 +172,34 @@ Cette macro permet de placer un point relativement à un autre. Cela revient à
\end{tikzpicture}
\end{tkzexample}
-\subsection{Point relativement à un autre : \tkzcname{tkzDefShiftPointCoord}}
-
-\begin{NewMacroBox}{tkzDefShiftPointCoord}{\oarg{a,b}\parg{x,y}\var{name} ou \parg{a:r}\var{name}}
-{Il s'agit d'effectuer une translation de vecteur $(a,b)$ au point défini par rapport à l'oigine.}
+\subsection{Point relative to another: \tkzcname{tkzDefShiftPointCoord}}
+\begin{NewMacroBox}{tkzDefShiftPointCoord}{\oarg{a,b}\parg{x,y}\var{name} ou \parg{a:r}\var{name}}%
+{This involves performing a $(a,b)$ vector translation at the defined point relative to the origin.}
\medskip
-\begin{tabular}{lll}
+\begin{tabular}{lll}%
\toprule
-arguments & défaut & définition \\
+arguments & default & definition \\
\midrule
-\TAline{(x,y)}{no default}{x et y sont deux dimensions, par défaut en cm.}
-\TAline{(a:r)}{no default}{a est un angle en degré, r une dimension}
+\TAline{(x,y)}{no default}{$x$ and $y$ are two dimensions, by default in cm.}
+\TAline{(a:r)}{no default}{$a$ is an angle in degrees, $r$ is a dimension}
\bottomrule
\end{tabular}
\medskip
-\begin{tabular}{lll}
-\toprule
-options & défaut & exemple \\
+\begin{tabular}{lll}%
+options & default & example \\
\midrule
\TOline{a,b} {no default} {\tkzcname{tkzDefShiftPointCoord}[2,3](0:4)\{B\}}
\bottomrule
\end{tabular}
-L'option est obligatoire
+The option is mandatory
\end{NewMacroBox}
-\subsubsection{Triangle équilatéral avec \tkzcname{tkzDefShiftPointCoord}}
-Voyons comment obtenir un triangle équilatéral (il y a beaucoup plus simple)
+\subsubsection{Equilateral triangle with \tkzcname{tkzDefShiftPointCoord}}
+Let's see how to get an equilateral triangle (there is much simpler)
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[scale=1]
@@ -223,8 +214,8 @@ Voyons comment obtenir un triangle équilatéral (il y a beaucoup plus simple)
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Triangle isocèle avec \tkzcname{tkzDefShiftPointCoord}}
-Voyons comment obtenir un triangle isocèle dont l'angle principal est de 30 degrés. La rotation est possible. $AB=AC=5$ et $\widehat{BAC}$
+\subsubsection{Isosceles triangle with \tkzcname{tkzDefShiftPointCoord}}
+Let's see how to obtain an isosceles triangle with a principal angle of 30 degrees. Rotation is possible. $AB=AC=5$ and $\widehat{BAC}$
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[rotate=15]
@@ -238,38 +229,35 @@ Voyons comment obtenir un triangle isocèle dont l'angle principal est de 30 deg
\end{tikzpicture}
\end{tkzexample}
-
%<--------------------------------------------------------------------------->
-\subsection{Tracer des points \tkzcname{tkzDrawPoint}} \hypertarget{tdrp}{}
-
-\begin{NewMacroBox}{tkzDrawPoint}{\oarg{local options}\parg{point}}
-\begin{tabular}{lll}
-arguments & défaut & définition \\
+\subsection{Drawing a point \tkzcname{tkzDrawPoint}} \hypertarget{tdrp}{}
+\begin{NewMacroBox}{tkzDrawPoint}{\oarg{local options}\parg{point}}%
+\begin{tabular}{lll}%
+arguments & default & definition \\
\midrule
-\TAline{point} {no default} {un nom ou une référence est demandé}
+\TAline{point} {no default} {a name or reference is requested}
\bottomrule
\end{tabular}
\medskip
-\noindent{L'argument est obligatoire, mais il n'est pas nécessaire (bien que recommandé) d'utiliser une référence; un couple de coordonnées place entre accolades est acceptée. Le disque prend la couleur du cercle, mais 50\% plus claire. Il est possible de tout modifier. Le point est un node et donc il est invariant si le dessin est modifié par une mise à l'échelle.}
+\noindent{The argument is mandatory, but it is not necessary (although recommended) to use a reference; a pair of coordinates placed between braces is accepted. The disk takes the color of the circle, but 50\% lighter. It is possible to modify everything. The point is a node and is therefore invariant if the drawing is modified by scaling..}
\medskip
-\begin{tabular}{lll}
+\begin{tabular}{lll}%
\toprule
-options & défaut & définition \\
+options & default & definition \\
\midrule
\TOline{shape} {circle}{Possible \tkzname{cross} ou \tkzname{cross out}}
-\TOline{size} {2 pt} {taille du disque}
-\TOline{color} {black}{la couleur par défaut peut être changée}
+\TOline{size} {2 pt} {disk size}
+\TOline{color} {black}{the default color can be changed}
\bottomrule
\end{tabular}
\medskip
-\noindent{On peut créer d'autres formes comme \tkzname{cross}}
+\noindent{We can create other forms such as \tkzname{cross}}
\end{NewMacroBox}
-\subsubsection{Style des points par défaut}
-
+\subsubsection{Default stitch style}
\begin{tkzexample}[latex=5cm,small]
\begin{tikzpicture}
\tkzDefPoint(1,3){A}
@@ -277,8 +265,8 @@ options & défaut & définition \\
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Modification du style}
-La définition par défaut dans le fichier \tkzname{tkz-base.cfg}
+\subsubsection{Changing the style}
+The default definition in the file \tkzname{tkz-base.cfg}
\begin{tkzltxexample}[small]
\tikzset{point style/.style={draw = \tkz@euc@pointcolor,
@@ -305,8 +293,8 @@ La définition par défaut dans le fichier \tkzname{tkz-base.cfg}
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Exemple de tracés de points}
-Il faut remarquer que \tkzname{scale} ne touche pas à la forme des points. Ce qui est normal. La plupart du temps, on se contente d'une seule forme de points que l'on pourra définir dès le début, soit avec une macro, soit en modifiant un fichier de configuration.
+\subsubsection{Example of point plots}
+Note that \tkzname{scale} does not affect the shape of the dots. Which is normal. Most of the time, we are satisfied with a single point shape that we can define from the beginning, either with a macro or by modifying a configuration file.
\begin{tkzexample}[latex=5cm,small]
\begin{tikzpicture}[scale=.5]
@@ -320,25 +308,23 @@ Il faut remarquer que \tkzname{scale} ne touche pas à la forme des points. Ce q
\end{tikzpicture}
\end{tkzexample}
-Il est possible de tracer plusieurs points en une seule fois, mais cette macro est un peu plus lente que la précédente. De plus on doit se contenter des mêmes options pour tous les points.
+It is possible to draw several points at once, but this macro is a little slower than the previous one. Moreover, we have to make do with the same options for all the points.
-\newpage
-\subsection{Tracer des points \tkzcname{tkzDrawPoints}}
+\subsection{Drawing points \tkzcname{tkzDrawPoints}}
\hypertarget{tdrps}{}
-\begin{NewMacroBox}{tkzDrawPoints}{\oarg{local options}\parg{liste}}
-\begin{tabular}{lll}
-arguments & défaut & définition \\
+\begin{NewMacroBox}{tkzDrawPoints}{\oarg{local options}\parg{liste}}%
+\begin{tabular}{lll}%
+arguments & default & definition \\
\midrule
-\TAline{liste de points}{no default}{exemple \tkzcname{tkzDrawPoints(A,B,C)}}
+\TAline{points list}{no default}{example \tkzcname{tkzDrawPoints(A,B,C)}}
\bottomrule
\end{tabular}
\medskip
-\emph{Attention au « s » final, un oubli entraîne des erreurs en cascade si vous tentez de tracer des points multiples. Les options sont les mêmes que pour la macro précédente. }
+Warning at the final "s", an oversight leads to cascading errors if you attempt to plot multiple points. The options are the same as for the previous macro.
\end{NewMacroBox}
-\subsubsection{Exemple avec \tkzcname{tkzDefPoint} et \tkzcname{tkzDrawPoints} }
-
+\subsubsection{Example with \tkzcname{tkzDefPoint} and \tkzcname{tkzDrawPoints} }
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[scale=.5]
\tkzDefPoint(1,3){A}
@@ -348,8 +334,7 @@ arguments & défaut & définition \\
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Exemple plus complexe }
-
+\subsubsection{More complex example }
\begin{tkzexample}[latex=7cm]
\begin{tikzpicture}[scale=.5]
\tkzDefPoint(2,3){A} \tkzDefPoint(5,-1){B}
@@ -367,29 +352,27 @@ arguments & défaut & définition \\
\end{tikzpicture}
\end{tkzexample}
-\newpage
%<--------------------------------------------------------------------------->
-\subsection{Ajouter un label à un point \tkzcname{tkzLabelPoint}}
+\subsection{Add a label to a point \tkzcname{tkzLabelPoint}}
\hypertarget{tlp}{}
-\emph{Il est possible d'ajouter plusieurs labels à un même point en utilisant plusieurs fois cette macro.}
+It is possible to add several labels at the same point by using this macro several times.
-\begin{NewMacroBox}{tkzLabelPoint}{\oarg{local options}\parg{point}\var{label}}
-\begin{tabular}{lll}
-arguments & exemple & \\
+\begin{NewMacroBox}{tkzLabelPoint}{\oarg{local options}\parg{point}\var{label}}%
+\begin{tabular}{lll}%
+arguments & example & \\
\midrule
\TAline{point}{\tkzcname{tkzLabelPoint(A)\{\$A\_1\$\}}}{}
-options & défaut & définition\\
+options & default & definition\\
\midrule
-\TOline{TikZ options}{}{couleur,position etc.}
+\TOline{TikZ options}{}{colour, position etc.}
\bottomrule
\end{tabular}
\medskip
-{En option, on peut utiliser tous les styles de \TIKZ\ , en particulier le placement avec \tkzname{above}, \tkzname{right}, \dots}
+Optionally, we can use any style of Tikz, especially placement with above, right, dots...
\end{NewMacroBox}
-\subsubsection{Exemple avec \tkzcname{tkzLabelPoint}}
-
+\subsubsection{Example with \tkzcname{tkzLabelPoint}}
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}
\tkzDefPoint(0,0){A}
@@ -403,8 +386,8 @@ options & défaut & définition\\
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{label et référence}
- La référence d'un point est l'objet qui permet d'utiliser le point, le label est le nom du point qui sera affiché.
+\subsubsection{Label and reference}
+ The reference of a point is the object that allows to use the point, the label is the name of the point that will be displayed.
\begin{tkzexample}[latex=8cm,small]
\begin{tikzpicture}
@@ -416,23 +399,23 @@ options & défaut & définition\\
\end{tikzpicture}
\end{tkzexample}
%<--------------------------------------------------------------------------->
-\subsection{Ajouter des labels aux points \tkzcname{tkzLabelPoints}}
-Il est possible de placer plusieurs labels rapidement quand les références des points sont identiques aux labels et quand les labels sont placés de la même manière par rapport aux points. Par défaut, c'est \tkzname{below right} qui a été choisi.
+\subsection{Add labels to points \tkzcname{tkzLabelPoints}}
+It is possible to place several labels quickly when the point references are identical to the labels and when the labels are placed in the same way in relation to the points. By default, \tkzname{below right} is chosen.
\hypertarget{tlps}{}
-\begin{NewMacroBox}{tkzLabelPoints}{\oarg{local options}\parg{$A_1,A_2,...$}}
+\begin{NewMacroBox}{tkzLabelPoints}{\oarg{local options}\parg{$A_1,A_2,...$}}%
\begin{tabular}{lll}
-arguments & exemple & résultat \\
+arguments & example & result \\
\midrule
-\TAline{list of points}{\tkzcname{tkzLabelPoint(A,B,C)}}{Affichage de A, B et C}
+\TAline{list of points}{\tkzcname{tkzLabelPoint(A,B,C)}}{Display of $A$, $B$ and $C$}
\bottomrule
\end{tabular}
\medskip
- \emph{Cette macro diminue le nombre de lignes de codes, mais il n'est pas évident que tous les points aient besoin du même positionnement des labels.}
+This macro reduces the number of lines of code, but it is not obvious that all points need the same label positioning.
\end{NewMacroBox}
-\subsubsection{Exemple avec \tkzcname{tkzLabelPoints}}
+\subsubsection{Example with \tkzcname{tkzLabelPoints}}
\begin{tkzexample}[latex = 7cm,small]
\begin{tikzpicture}
\tkzDefPoint(2,3){A}
@@ -445,19 +428,18 @@ arguments & exemple & résultat \\
%<--------------------------------------------------------------------------->
% tkzAutoLabelPoints
%<--------------------------------------------------------------------------->
-\subsection{Position automatique des labels \tkzcname{tkzAutoLabelPoints}}
-Le label d'un point est placé suivant une direction définie par un centre et un point \tkzname{center}. La distance au point est déterminé par un pourcentage de la distance entre le centre et le point. Ce pourcentage est donné par \tkzname{dist}.
-\begin{NewMacroBox}{tkzLabelPoints}{\oarg{local options}\parg{$A_1,A_2,...$}}
+\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}.
+\begin{NewMacroBox}{tkzLabelPoints}{\oarg{local options}\parg{$A_1,A_2,...$}}%
\begin{tabular}{lll}
-arguments & exemple & résultat \\
+arguments & example & result \\
\midrule
-\TAline{list of points}{\tkzcname{tkzLabelPoint(A,B,C)}}{Affichage de A, B et C}
-\bottomrule
+\TAline{list of points}{\tkzcname{tkzLabelPoint(A,B,C)}}{Display of $A$, $B$ and $C$}
\end{tabular}
\end{NewMacroBox}
-\subsubsection{Exemple avec \tkzcname{tkzAutoLabelPoints}}
-Ici les points sont positionnés par rapport au centre de gravité de $A,B,C \text{et} O$
+\subsubsection{Example 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}
@@ -477,55 +459,53 @@ Ici les points sont positionnés par rapport au centre de gravité de $A,B,C \te
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Exemple avec \tkzcname{tkzAutoLabelPoints}}
-Cette fois la référence est $O$ et la distance est par défaut de $0.15$
+\subsubsection{Example 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]
- \tkzDefPoint(2,1){O}
- \tkzDefRandPointOn[circle=center O radius 1.5cm]
- \tkzGetPoint{A}
- \tkzDrawCircle(O,A)
- \tkzDefPointBy[rotation=center O angle 100](A)
- \tkzGetPoint{C}
- \tkzDefPointBy[rotation=center O angle 78](A)
- \tkzGetPoint{B}
- \tkzDrawPoints(O,A,B,C)
- \tkzDrawSegments(C,B B,A A,O O,C)
- \tkzAutoLabelPoints[center=O,red](A,B,C)
+ \tkzDefPoint(2,1){O}
+ \tkzDefRandPointOn[circle=center O radius 1.5cm]
+ \tkzGetPoint{A}
+ \tkzDrawCircle(O,A)
+ \tkzDefPointBy[rotation=center O angle 100](A)
+ \tkzGetPoint{C}
+ \tkzDefPointBy[rotation=center O angle 78](A)
+ \tkzGetPoint{B}
+ \tkzDrawPoints(O,A,B,C)
+ \tkzDrawSegments(C,B B,A A,O O,C)
+ \tkzAutoLabelPoints[center=O,red](A,B,C)
\end{tikzpicture}
\end{tkzexample}
%<--------------------------------------------------------------------------->
-\subsection{Style des points avec \tkzcname{tkzSetUpPoint}}
- Il est important de comprendre que la taille d'un point dépend de la taille d'une ligne.
-\begin{NewMacroBox}{tkzSetUpPoint}{\oarg{local options}}
+\subsection{Point style with \tkzcname{tkzSetUpPoint}}
+ It is important to understand that the size of a dot depends on the size of a line.
+\begin{NewMacroBox}{tkzSetUpPoint}{\oarg{local options}}%
\begin{tabular}{lll}
-options & défaut & définition \\
+options & default & definition \\
\midrule
-\TOline{shape}{circle}{possible : circle, cross, cross out}
-\TOline{size}{current }{ la taille du point est size * line width }
-\TOline{color}{current}{exemple \tkzcname{tkzLabelPoint(A,B,C)}}
-\TOline{fill}{current!50}{exemple \tkzcname{tkzLabelPoint(A,B,C)}} \bottomrule
+\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)}}
\end{tabular}
-
\end{NewMacroBox}
-Il s'agit d'une macro permettant de choisir un \hypertarget{setupoint}{style} pour les points. La macro \tkzcname{tkzDrawSegments} est décrite \hyperlink{segs}{ici}.
-
-\subsubsection{Exemple simple avec \tkzcname{tkzSetUpPoint}}
+This is a macro for choosing a \hypertarget{setupoint}{style} for points.
+\subsubsection{Simple example with \tkzcname{tkzSetUpPoint}}
\begin{tkzexample}[latex=6cm,small]
- \begin{tikzpicture}
- \tkzSetUpPoint[shape = cross out,
- color=blue]
- \tkzInit[xmax=100,xstep=20,ymax=.5]
- \tkzDefPoint(20,1){A}
- \tkzDefPoint(80,0){B}
- \tkzDrawLine(A,B)
- \tkzDrawPoints(A,B)
+\begin{tikzpicture}
+ \tkzSetUpPoint[shape = cross out,
+ color=blue]
+ \tkzInit[xmax=100,xstep=20,ymax=.5]
+ \tkzDefPoint(20,1){A}
+ \tkzDefPoint(80,0){B}
+ \tkzDrawLine(A,B)
+ \tkzDrawPoints(A,B)
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Exemple avec \tkzcname{tkzSetUpPoint}}
+\subsubsection{Example with \tkzcname{tkzSetUpPoint}}
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}
\tkzInit[ymin=-0.5,ymax=3,xmin=-0.5,xmax=7]
@@ -540,8 +520,8 @@ Il s'agit d'une macro permettant de choisir un \hypertarget{setupoint}{style} po
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Utilisation de\tkzcname{tkzSetUpPoint} dans un groupe}
-Seuls les points du groupe sont affectés par les modifications.
+\subsubsection{Using \tkzcname{tkzSetUpPoint} in a group}
+Only the points in the group are affected by the changes.
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}
@@ -562,32 +542,29 @@ Seuls les points du groupe sont affectés par les modifications.
\end{tikzpicture}
\end{tkzexample}
%<--------------------------------------------------------------------------->
-\subsection{Montrer les coordonnées des points \tkzcname{tkzPointShowCoord}}
-Cette macro permet d'afficher les coordonnées d'un point et de tracer des flèches pour préciser l'abscisse et l'ordonnée. Le point est donné par sa référence (son nom). Il est possible de donner un couple de coordonnées.
-
- \begin{NewMacroBox}{tkzPointShowCoord}{\oarg{local options}\parg{point}}
+\subsection{Show point coordinates}
+This macro allows you to display the coordinates of a point and to draw arrows to specify the abscissa and ordinate. The point is given by its reference (its name). It is possible to give a couple of coordinates.
\hypertarget{tpsc}{}
-\begin{tabular}{lll}
-\toprule
-argument & exemple & explication \\
+\begin{NewMacroBox}{tkzPointShowCoord}{\oarg{local options}\parg{point}}%
+\begin{tabular}{lll}%
+argument & example & explanation \\
\midrule
-\TAline{\parg{ref}}{\tkzcname{tkzPointShowCoord}(A)}{ Montre les coordonnées du point A}
+\TAline{\parg{ref}}{\tkzcname{tkzPointShowCoord}(A)}{shows the coordinates of point $A$}
\bottomrule
- \end{tabular}
+\end{tabular}
- \medskip
-\begin{tabular}{lll}
-%\toprule
-option & défaut & explication \\
+\medskip
+\begin{tabular}{lll}%
+option & default & explication \\
\midrule
-\TOline{xlabel}{empty}{label pour l'abscisse}
-\TOline{xstyle}{empty}{style pour le node du label de l'abscisse}
-\TOline{noxdraw}{false}{booléen pour ne pas tracer de flèche vers $(x'x)$}
+\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)$}
\end{tabular}
- \end{NewMacroBox}
-
-\subsubsection{styles par défaut}
+\end{NewMacroBox}
+\subsubsection{Default styles}
+Here are some of the main styles:
\begin{tkzltxexample}[small]
\tikzset{arrow coord style/.style={dashed,
\tkz@euc@linecolor,
@@ -607,8 +584,8 @@ option & défaut & explication \\
left=3pt}}
\end{tkzltxexample}
-\subsubsection{Exemple avec \tkzcname{tkzPointShowCoord}}
-Sans les options, on n'obtient que les flèches.
+\subsubsection{Example with \tkzcname{tkzPointShowCoord}}
+Without the options, you only get the arrows.
\begin{tkzexample}[latex=7cm,small]
@@ -625,8 +602,8 @@ Sans les options, on n'obtient que les flèches.
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Exemple avec \tkzcname{tkzPointShowCoord} et \tkzname{xstep}}
-Sans les options, on n'obtient que les flèches.
+\subsubsection{Example with \tkzcname{tkzPointShowCoord} and \tkzname{xstep}}
+Without the options, you only get the arrows.
\begin{tkzexample}[latex=7cm,small]
@@ -642,32 +619,28 @@ Sans les options, on n'obtient que les flèches.
\subsection{\tkzcname{tkzDefSetOfPoints}} % (fold)
-\noindent\space : Il était déjà possible de créer un nuage de points avec la macro \tkzcname{tkzDefPoints}, mais cela impose de donner une référence (un nom) à chaque point, ce qui est parfois fastidieux. La macro \tkzcname{tkzSetOfPoints} permet de définir des points \tkzname{tkzPt1}, \tkzname{tkzPt2},etc.
-
-C'est ce qu'on appelle fréquemment \hypertarget{label_tkzDefSetOfPoints}{« nuage de points»}. La différence par rapport à la macro \tkzcname{tkzDefPoints}, c'est que la référence aux points est donnée par un préfixe (par défaut tkzPt) et le numéro du point.
-Les points ne sont pas tracés.
-
-\begin{NewMacroBox}{tkzDefSetOfPoints}{\oarg{local options}\var{$x_1/y_1,x_2/y_2,\ldots,x_n/y_n$}}
+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.
-\begin{tabular}{lll}
+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.
+The points are not drawn.
-arguments & défaut & définition \\
+\begin{NewMacroBox}{tkzDefSetOfPoints}{\oarg{local options}\var{$x_1/y_1,x_2/y_2,\ldots,x_n/y_n$}}%
+\begin{tabular}{lll}%
+arguments & default & definition \\
\midrule
-\TAline{$x_n/y_n$}{no default}{Liste de couples $x_n/y_n$ séparés par des virgules}
+\TAline{$x_n/y_n$}{no default}{List of couples $x_n/y_n$ separated by commas}
\bottomrule
\end{tabular}
\medskip
-\begin{tabular}{lll}
-
-options & défaut & définition \\
+\begin{tabular}{lll}%
+options & default & definition \\
\midrule
-\TOline{prefix} {tkzPt} {préfixe pour les noms des points}
+\TOline{prefix} {tkzPt} {prefix for point names}
\end{tabular}
\end{NewMacroBox}
-\subsubsection{Création d'un nuage avec \tkzcname{tkzDefSetOfPoints}}
-
+\subsubsection{Creating a scatter plot with \tkzcname{tkzDefSetOfPoints}}
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}
\tkzInit[ymax=4,xmax=5]