summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-tools.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-tools.tex')
-rw-r--r--Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-tools.tex197
1 files changed, 89 insertions, 108 deletions
diff --git a/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-tools.tex b/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-tools.tex
index 6a92b89bf2b..3ddc5fb111c 100644
--- a/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-tools.tex
+++ b/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-tools.tex
@@ -1,24 +1,23 @@
-\section{Outils divers}
+\section{Miscellaneous tools}
-\subsection{Dupliquer un segment}
+\subsection{Duplicate a segment}
-Il s'agit de construire un segment sur une demi-droite donnée de même longueur qu'un segment donné.
+This involves constructing a segment on a given half-line of the same length as a given segment.
-\begin{NewMacroBox}{tkzDuplicateSegment}{\parg{pt1,pt2}\parg{pt3,pt4}\marg{pt5}}
-Il s'agit de créer un segment sur une demi-droite donnée de même longueur qu'un segment donné . Il s'agit en fait de la définition d'un point.
+\begin{NewMacroBox}{tkzDuplicateSegment}{\parg{pt1,pt2}\parg{pt3,pt4}\marg{pt5}}%
+This involves creating a segment on a given half-line of the same length as a given segment . It is in fact the definition of a point.
\medskip
-
-\begin{tabular}{lll}
+\begin{tabular}{lll}%
\toprule
-arguments & exemple & explication \\
+arguments & example & explanation \\
\midrule
\TAline{(pt1,pt2)(pt3,pt4)\{pt5\}} {\tkzcname{tkzDuplicateLen}(A,B)(E,F)\{C\}}{AC=EF et $C \in [AB)$} \\
\bottomrule
\end{tabular}
\medskip
-La macro \tkzcname{tkzDuplicateLength} est identique à celle-ci.
+The macro \tkzcname{tkzDuplicateLength} is identical to this one.
\end{NewMacroBox}
\begin{tkzexample}[latex=6cm,small]
@@ -34,8 +33,7 @@ La macro \tkzcname{tkzDuplicateLength} est identique à celle-ci.
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Proportion d'or avec \tkzcname{tkzDuplicateSegment}}
-
+\subsubsection{Gold proportion with \tkzcname{tkzDuplicateSegment}}
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[rotate=-90,scale=.75]
\tkzInit[xmax=10,ymax=10]
@@ -59,24 +57,23 @@ La macro \tkzcname{tkzDuplicateLength} est identique à celle-ci.
% <-------------------------------------------------------------------->
% About Angles
% <-------------------------------------------------------------------->
- \subsection{Déterminer une pente}
-Il s'agit de déterminer si elle existe, la pente d'une droite définie par deux points. Aucune vérification de l'existence n'est faite.
+\subsection{Determining a slope}
+It is a question of determining whether it exists, the slope of a straight line defined by two points. No verification of the existence is made.
-\begin{NewMacroBox}{tkzFindSlope}{\parg{pt1,pt2}\marg{name of macro}}
-Le résultat est stocké dans une macro.
+\begin{NewMacroBox}{tkzFindSlope}{\parg{pt1,pt2}\marg{name of macro}}%
+The result is stored in a macro.
\medskip
-
\begin{tabular}{lll}
\toprule
-arguments & exemple & explication \\
+arguments & example & explication \\
\midrule
-\TAline{(pt1,pt2){pt3}} {\tkzcname{tkzFindSlope}(A,B)\{slope\}}{\tkzcname{slope} donnera le résultat de $\frac{y_B-y_A}{x_B-x_A}$} \\
+\TAline{(pt1,pt2){pt3}} {\tkzcname{tkzFindSlope}(A,B)\{slope\}}{\tkzcname{slope} will give the result of $\frac{y_B-y_A}{x_B-x_A}$} \\
\bottomrule
\end{tabular}
\medskip
-\tkzHandBomb\ Attention à ne pas avoir $x_B=x_A$
+\tkzHandBomb\ Careful not to have $x_B=x_A$
\end{NewMacroBox}
@@ -92,37 +89,36 @@ arguments & exemple & explication \\
\tkzFindSlope(A,D){SAD}
\pgfkeys{/pgf/number format/.cd,fixed,precision=2}
\tkzText[fill=Gold!50,draw=brown](1,4)%
- {La pente de (AB) est : $\pgfmathprintnumber{\SAB}$}
+ {La pente de (AB) est: $\pgfmathprintnumber{\SAB}$}
\tkzText[fill=Gold!50,draw=brown](1,3.5)%
- {La pente de (AC) est : $\pgfmathprintnumber{\SAC}$}
+ {La pente de (AC) est: $\pgfmathprintnumber{\SAC}$}
\tkzText[fill=Gold!50,draw=brown](1,3)%
- {La pente de (AD) est : $\pgfmathprintnumber{\SAD}$}
+ {La pente de (AD) est: $\pgfmathprintnumber{\SAD}$}
\end{tikzpicture}
\end{tkzexample}
-\subsection{Angle formé par une droite avec l'axe horizontal}
-Beaucoup plus intéressante que la précédente. Le résultat est compris entre -180 degrés et +180 degrés.
+\subsection{Angle formed by a straight line with the horizontal axis}
+Much more interesting than the last one. The result is between -180 degrees and +180 degrees.
-\begin{NewMacroBox}{tkzFindSlopeAngle}{\parg{pt1,pt2}}
-Le résultat est stocké dans une macro \tkzcname{tkzAngleResult}.
+\begin{NewMacroBox}{tkzFindSlopeAngle}{\parg{pt1,pt2}}%
+The result is stored in a macro \tkzcname{tkzAngleResult}.
\medskip
-
\begin{tabular}{lll}
\toprule
-arguments & exemple & explication \\
+arguments & example & explication \\
\midrule
-\TAline{(pt1,pt2)} {\tkzcname{tkzFindSlopeAngle}(A,B)}{\tkzcname{tkzGetAngle} peut récupèrer le résultat}
+\TAline{(pt1,pt2)} {\tkzcname{tkzFindSlopeAngle}(A,B)}{\tkzcname{tkzGetAngle} can retrieve the result}
\bottomrule
\end{tabular}
\medskip
-{Si la récupération n'est pas nécessaire, il est possible d'utiliser \tkzcname{tkzAngleResult}}
+{If recovery is not necessary, it is possible to use \tkzcname{tkzAngleResult}}
\end{NewMacroBox}
-\subsubsection{Exemple d'utilisation de \tkzcname{tkzFindSlopeAngle}}
-Voici une autre version de la construction d'une médiatrice
+\subsubsection{Example of use of \tkzcname{tkzFindSlopeAngle}}
+Here is another version of the construction of a mediator
\begin{tkzexample}[latex=6cm,small]
\begin{tikzpicture}
@@ -142,26 +138,25 @@ Voici une autre version de la construction d'une médiatrice
\end{tikzpicture}
\end{tkzexample}
-\subsection{Récupérer un angle}
-Dans l'exemple précédent, j'ai utilisé la macro \tkzcname{tkzGetAngle} qui permet de récupérer un angle.
+\subsection{from an angle}
+In the previous example, I used the macro \tkzcname{tkzGetAngle} to retrieve an angle.
-\begin{NewMacroBox}{tkzGetAngle}{\marg{name of macro}}
-Cette macro récupère \tkzcname{tkzAngleResult} et stocke le résultat dans une nouvelle macro.
+\begin{NewMacroBox}{tkzGetAngle}{\marg{name of macro}}%
+This macro retrieves \tkzcname{tkzAngleResult} and stores the result in a new macro.
\medskip
-\begin{tabular}{lll}
+\begin{tabular}{lll}%
\toprule
-arguments & exemple & explication \\
+arguments & example & explication \\
\midrule
-\TAline{name of macro} {\tkzcname{tkzGetAngle}\{ang\}}{\tkzcname{ang} contient la valeur de l'angle.}
+\TAline{name of macro} {\tkzcname{tkzGetAngle}\{ang\}}{\tkzcname{ang} contains the value of the angle. }
\end{tabular}
\end{NewMacroBox}
-\subsection{Exemple d'utilisation de \tkzcname{tkzGetAngle}}
-
- Il s'agit ici que $(AB)$ soit la bissectrice de $\widehat{CAD}$, tel que la pente $AD$ soit nulle. On récupère la pente de $(AB)$ puis on effectue deux rotations.
+\subsection{Example of the use of \tkzcname{tkzGetAngle}}
+ The point here is that $(AB)$ is the bisector of $\widehat{CAD}$, such that the $AD$ slope is zero. We recover the slope of $(AB)$ and then rotate twice.
\begin{tkzexample}[vbox,small]
\begin{tikzpicture}
@@ -182,28 +177,24 @@ arguments & exemple & explication \\
\end{tikzpicture}
\end{tkzexample}
-\subsection{Angle formé par trois points}
-
-
-\begin{NewMacroBox}{tkzFindAngle}{\parg{pt1,pt2,pt3}}
-Le résultat est stocké dans une macro \tkzcname{tkzAngleResult}.
+\subsection{Angle formed by three points}
+\begin{NewMacroBox}{tkzFindAngle}{\parg{pt1,pt2,pt3}}%
+The result is stored in a macro \tkzcname{tkzAngleResult}.
\medskip
-
\begin{tabular}{lll}
\toprule
-arguments & exemple & explication \\
+arguments & example & explication \\
\midrule
-\TAline{(pt1,pt2,pt3)} {\tkzcname{tkzFindAngle}(A,B,C)}{\tkzcname{tkzAngleResult} donne l'angle ($\overrightarrow{BA},\overrightarrow{BC}$)}
+\TAline{(pt1,pt2,pt3)} {\tkzcname{tkzFindAngle}(A,B,C)}{\tkzcname{tkzAngleResult} gives the angle ($\overrightarrow{BA},\overrightarrow{BC}$)}
\bottomrule
\end{tabular}
\medskip
-Le résultat est compris entre -180 degrés et +180 degrés. pt2 est le sommet et \tkzcname{tkzGetAngle} peut récupérer l'angle.
+The result is between -180 degrees and +180 degrees. pt2 is the vertex and \tkzcname{tkzGetAngle} can retrieve the angle.
\end{NewMacroBox}
-\subsection{Exemple d'utilisation de \tkzcname{tkzFindAngle} }
-
+\subsection{Example of use of \tkzcname{tkzFindAngle} }
\begin{tkzexample}[vbox,small]
\begin{tikzpicture}
\tkzInit[xmin=-1,ymin=-1,xmax=7,ymax=7]
@@ -227,38 +218,33 @@ Le résultat est compris entre -180 degrés et +180 degrés. pt2 est le sommet e
\end{tikzpicture}
\end{tkzexample}
-\subsection{Longueur d'un segment \tkzcname{tkzCalcLength}}
-Il existe dans \TIKZ\ une option \tkzname{veclen}. Cette option
- permet de calculer AB si A et B sont deux points.
+\subsection{\tkzcname{tkzCalcLength}}
+There's an option in \TIKZ\ name in \tkzname{veclen}. This option
+ is used to calculate AB if A and B are two points.
-Le seul problème pour moi est que la version de \TIKZ\ n'est pas assez précise dans certains cas particuliers. Ma version utilise le package \tkzNamePack{xfp} et est plus lente, mais plus précise
-
-\begin{NewMacroBox}{tkzCalcLength}{\oarg{local options}\parg{pt1,pt2}\marg{name of macro}}
-Le résultat est stocké dans une macro.
-
-\medskip
-\begin{tabular}{lll}
-\toprule
-arguments & exemple & explication \\
+The only problem for me is that the version of \TIKZ\ is not accurate enough in some cases. My version uses the \tkzNamePack{xfp} package and is slower, but more accurate.
+ \hypertarget{tpsc}{}
+\begin{NewMacroBox}{tkzCalcLength}{\oarg{local options}\parg{pt1,pt2}\marg{name of macro}}%
+\begin{tabular}{lll}%
+arguments & example & explication \\
\midrule
\TAline{(pt1,pt2)\{name of macro\}} {\tkzcname{tkzCalcLength}(A,B)\{dAB\}}{\tkzcname{dAB} donne $AB$ en pt}
\bottomrule
\end{tabular}
\medskip
-
Une seule option
-\begin{tabular}{lll}
-
-\toprule
- options & défaut & exemple \\
+\begin{tabular}{lll}%
+ options & default & example \\
\midrule
-\TOline{cm} {false}{\tkzcname{tkzCalcLength}[cm](A,B)\{dAB\} \tkzcname{dAB} donne AB en cm}
+\TOline{cm} {false}{\tkzcname{tkzCalcLength}[cm](A,B)\{dAB\} \tkzcname{dAB} gives AB en cm}
\end{tabular}
+
+The result is stored in a macro.
\end{NewMacroBox}
-\subsubsection{Construction d'un carré au compas}
+\subsubsection{Compass square construction}
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[scale=1]
@@ -278,60 +264,57 @@ Une seule option
\end{tikzpicture}
\end{tkzexample}
-\subsection{Transformation de pt en cm ou de cm en pt}
-Pas sûr que cela soit nécessaire et il ne s'agit que d'une division par 28,45274 et d'un multiplication par ce même nombre. Les macros sont :
+\subsection{Transformation from pt to cm or cm to pt}
+Not sure if this is necessary and it is only a division by 28.45274 and a multiplication by the same number. The macros are:
-\begin{NewMacroBox}{tkzpttocm}{\parg{nombre}\marg{name of macro}}
-Le résultat est stocké dans une macro.
+\begin{NewMacroBox}{tkzpttocm}{\parg{nombre}\marg{name of macro}}%
+The result is stored in a macro.
\medskip
-
-\begin{tabular}{lll}
+\begin{tabular}{lll}%
\toprule
-arguments & exemple & explication \\
+arguments & example & explication \\
\midrule
\TAline{(nombre){name of macro}} {\tkzcname{tkzpttocm}(120)\{len\}}{\tkzcname{len} donne un nombre de tkzname{cm}}
\bottomrule
\end{tabular}
\medskip
-Il faudra utiliser \tkzcname{len} accompagné de \tkzname{cm}
+You'll have to use \tkzcname{len} along with \tkzname{cm}.
\end{NewMacroBox}
-\subsection{changement d'unité}
-\begin{NewMacroBox}{tkzcmtopt}{\parg{nombre}\marg{name of macro}}
-Le résultat est stocké dans une macro.
+\subsection{Change of unit}
+\begin{NewMacroBox}{tkzcmtopt}{\parg{nombre}\marg{name of macro}}%
+The result is stored in a macro.
\medskip
-
\begin{tabular}{lll}
\toprule
-arguments & exemple & explication \\
+arguments & example & explication \\
\midrule
\TAline{(nombre)\{name of macro\}}{\tkzcname{tkzcmtopt}(5)\{len\}}{\tkzcname{len} longueur en \tkzname{pts}}
\bottomrule
\end{tabular}
\medskip
-\noindent{Le résultat s'utilise avec \tkzcname{len}\tkzname{pt}}
+\noindent{The result can be used with \tkzcname{len}\tkzname{pt}}
\end{NewMacroBox}
-\subsubsection{Exemple}
-La macro \tkzcname{tkzDefCircle[radius](A,B)} définit le rayon que l'on récupère avec \tkzcname{tkzGetLength}, mais ce résultat est en \tkzname{pt}.
+\subsubsection{Example}
+The macro \tkzcname{tkzDefCircle[radius](A,B)} defines the radius that we retrieve with \tkzcname{tkzGetLength}, but this result is in \tkzname{pt}.
\begin{tkzexample}[latex=6cm,small]
\begin{tikzpicture}[scale=.5]
- \tkzDefPoint(0,0){A}
- \tkzDefPoint(3,-4){B}
- \tkzDefCircle[through](A,B)
- \tkzGetLength{rABpt}
- \tkzpttocm(\rABpt){rABcm}
- \tkzDrawCircle(A,B)
- \tkzDrawPoints(A,B)
- \tkzLabelPoints(A,B)
- \tkzDrawSegment[dashed](A,B)
- \tkzLabelSegment(A,B){%
- $\pgfmathprintnumber{\rABcm}$}
+ \tkzDefPoint(0,0){A}
+ \tkzDefPoint(3,-4){B}
+ \tkzDefCircle[through](A,B)
+ \tkzGetLength{rABpt}
+ \tkzpttocm(\rABpt){rABcm}
+ \tkzDrawCircle(A,B)
+ \tkzDrawPoints(A,B)
+ \tkzLabelPoints(A,B)
+ \tkzDrawSegment[dashed](A,B)
+ \tkzLabelSegment(A,B){$\pgfmathprintnumber{\rABcm}$}
\end{tikzpicture}
\end{tkzexample}
@@ -342,24 +325,22 @@ La macro \tkzcname{tkzDefCircle[radius](A,B)} définit le rayon que l'on réc
% en cm
% tkzGetPointCoord avec [#1] cm ou bien pt ?? todo
%<--------------------------------------------------------------------------–>
-\begin{NewMacroBox}{tkzGetPointCoord}{\parg{$A$}\marg{name of macro}}
-Stocke dans deux macros les coordonnées d'un point
+\begin{NewMacroBox}{tkzGetPointCoord}{\parg{$A$}\marg{name of macro}}%
+Stores in two macros the coordinates of a point
\medskip
\begin{tabular}{lll}
\toprule
-arguments & exemple & explication \\
+arguments & example & explanation \\
\midrule
-\TAline{(point)\{name of macro\}} {\tkzcname{tkzGetPointCoord}(A)\{A\}}{\tkzcname{Ax} et \tkzcname{Ay} donnent les coordonnées de $A$}
-
+\TAline{(point)\{name of macro\}} {\tkzcname{tkzGetPointCoord}(A)\{A\}}{\tkzcname{Ax} and \tkzcname{Ay} give the coordinates of $A$}
\end{tabular}
\medskip
-Si le nom de la macro est \tkzname{p}, alors \tkzcname{px} et \tkzcname{py} donnent les coordonnées du point choisi avec le cm comme.
+If the name of the macro is \tkzname{p}, then \tkzcname{px} and \tkzcname{py} give the coordinates of the chosen point with the cm as.
\end{NewMacroBox}
-\subsubsection{Transfert de coordonnées avec \tkzcname{tkzGetPointCoord}}
-
+\subsubsection{Coordinate transfer with \tkzcname{tkzGetPointCoord}}
\begin{tkzexample}[width=8cm,small]
\begin{tikzpicture}
\tkzInit[xmax=5,ymax=3]
@@ -375,7 +356,7 @@ Si le nom de la macro est \tkzname{p}, alors \tkzcname{px} et \tkzcname{py} donn
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Somme de vecteurs avec \tkzcname{tkzGetPointCoord}}
+\subsubsection{Sum of vectors with \tkzcname{tkzGetPointCoord}}
\begin{tkzexample}[width=6cm,small]
\begin{tikzpicture}[>=latex]
\tkzDefPoint(1,4){a}