diff options
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.tex | 197 |
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} |