summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-BB.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2020-03-09 03:01:39 +0000
committerNorbert Preining <norbert@preining.info>2020-03-09 03:01:39 +0000
commit0561778af6f8fde0a3a1c334e2aab9a4f1142d6e (patch)
treec19fe45e4101aed56e7fb3602174c6a5e335d7d1 /macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-BB.tex
parenta8880a5ee484845d9a526c5ca8d21d31214af22b (diff)
CTAN sync 202003090301
Diffstat (limited to 'macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-BB.tex')
-rw-r--r--macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-BB.tex77
1 files changed, 40 insertions, 37 deletions
diff --git a/macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-BB.tex b/macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-BB.tex
index 74950a060f..6af88de598 100644
--- a/macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-BB.tex
+++ b/macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-BB.tex
@@ -1,22 +1,21 @@
-\section{Gestion de la bounding box}
-La bounding box initiale après usage de la macro \tkzcname{tkzInit} est définie par le rectangle basé sur les points $(0,0)$ et $(10,10)$. La macro \tkzcname{tkzInit} permet de modifier cette bounding box initiale en utilisant les arguments (\tkzname{xmin}, \tkzname{xmax}, \tkzname{ymin}, et \tkzname{ymax}). Bien sûr tout tracé extérieur modifie la bounding box. \TIKZ tient à jour cette bounding box. Il est possible d'influer sur ce comportement soit directement avec des commandes ou des options de \TIKZ comme une commande comme \tkzcname{useasboundingbox} ou l'option \tkzname{use as bounding box}. Une conséquence possible est de réserver une boite pour une figure mais la figure peut déborder de la boite et se repandre au-dessus du texte principal.
-La commande suivante \tkzcname{pgfresetboundingbox} permet d'effacer une bounding box et d'en établir une nouvelle.
+\section{Bounding box management}
+The initial bounding box after using the macro \tkzcname{tkzInit} is defined by the rectangle based on the points $(0,0)$ and $(10,10)$. The \tkzcname{tkzInit} macro allows this initial bounding box to be modified using the arguments (\tkzname{xmin}, \tkzname{xmax}, \tkzname{ymin}, and \tkzname{ymax}). Of course any external trace modifies the bounding box. \TIKZ\ maintains that bounding box. It is possible to influence this behavior either directly with commands or options in \TIKZ\ such as a command like \tkzcname{useasboundingbox} or the option \tkzname{use as bounding box}. A possible consequence is to reserve a box for a figure but the figure may overflow the box and spread over the main text.
+The following command \tkzcname{pgfresetboundingbox} clears a bounding box and establishes a new one.
%Enfin Il est parfois utile de contenir une figure dans une b
-
%current bounding box or current path bounding box remember picture et overlay
%<--------------------------------------------------------------------------->
% tkzShowBB
%<--------------------------------------------------------------------------->
\subsection{tkzShowBB}
-La macro la plus simple.
-\begin{NewMacroBox}{tkzShowBB}{\oarg{local options}}
-Cette macro permet de visualiser la bounding box. Un cadre rectangulaire entoure celle-ci. Cette macro accepte les options de \TIKZ.
+The simplest macro.
+\begin{NewMacroBox}{tkzShowBB}{\oarg{local options}}%
+This macro displays the bounding box. A rectangular frame surrounds the bounding box. This macro accepts \TIKZ\ options.
\end{NewMacroBox}
-\subsubsection{Exemple 2 avec \tkzcname{tkzShowBB}}
+\subsubsection{Example with \tkzcname{tkzShowBB}}
\begin{tkzexample}[latex=8cm,small]
\begin{tikzpicture}[scale=.5]
\tkzInit[ymax=5,xmax=8]
@@ -35,10 +34,10 @@ Cette macro permet de visualiser la bounding box. Un cadre rectangulaire entoure
%<--------------------------------------------------------------------------->
\subsection{tkzClipBB}
\begin{NewMacroBox}{tkzClipBB}{}%
-Il s'agit de limiter les futures constructions à la bounding box actuelle.
+The idea is to limit future constructions to the current bounding box.
\end{NewMacroBox}
-\subsubsection{Exemple avec \tkzcname{tkzClipBB} et les bissectrices}
+\subsubsection{Example with \tkzcname{tkzClipBB} and the bisectors}
\begin{tkzexample}[latex=6cm,small]
\begin{tikzpicture}
@@ -60,11 +59,11 @@ Il s'agit de limiter les futures constructions à la bounding box actuelle.
% tkzSetBB
%<--------------------------------------------------------------------------->
\subsection{tkzSetBB}
-\begin{NewMacroBox}{tkzSetBB}{\parg{$x_A~;~y_A$} \parg{$x_B~;~y_B$} ou bien {\parg{$A$} \parg{$B$}}}
-{Cette macro permet de définir le rectangle ayant pour coordonnées $(x_A~;~y_A$) et $(x_B~;~y_B)$ comme la nouvelle bounding box.}
+\begin{NewMacroBox}{tkzSetBB}{\parg{$x_A~;~y_A$} \parg{$x_B~;~y_B$} ou bien {\parg{$A$} \parg{$B$}}}%
+This macro defines the rectangle with coordinates $(x_A~;~y_A$) and $(x_B~;~y_B)$ as the new bounding box.
\end{NewMacroBox}
-\subsubsection{Exemple avec \tkzcname{tkzShowBB}}
+\subsubsection{Example with \tkzcname{tkzShowBB}}
\begin{tkzexample}[latex=8cm,small]
above\\
left
@@ -82,12 +81,12 @@ left
% tkzSaveBB
%<--------------------------------------------------------------------------->
\subsection{tkzSaveBB}{}
-\begin{NewMacroBox}{tkzSaveBB}{}
-Cette macro permet de sauvegarder la bounding box, autrement dit elle enregistre les coordonnées de deux points qui définissent un rectangle.
+\begin{NewMacroBox}{tkzSaveBB}{}%
+This macro saves the bounding box, i.e. it stores the coordinates of two points that define a rectangle.
\end{NewMacroBox}
\begin{tkzexample}[latex=7cm,small]
-Une figure au-dessus du texte\\
+A figure above the text.
\begin{tikzpicture}
\begin{scope}
\tkzSetBB(0,0)(6,2) \tkzShowBB[fill=blue!20]
@@ -107,9 +106,9 @@ Une figure au-dessus du texte\\
%<--------------------------------------------------------------------------->
\subsection{tkzRestoreBB}
\begin{NewMacroBox}{tkzRestoreBB}{}
-Cette macro récupère la sauvegarde de la bounding box. Comme vous le constater, la figure déborde de la boîte. La bounding box a été réduite.
+This macro retrieves the bounding box backup. As you can see, the figure overflows the box. The bounding box has been reduced.
\end{NewMacroBox}
-\subsubsection{Exemple d'utilisation de \tkzcname{tkzRestoreBB}}
+\subsubsection{Example of the use of \tkzcname{tkzRestoreBB}}
\begin{tkzexample}[latex=8cm,small]
\vspace{ 2cm}
Start\\
@@ -133,23 +132,23 @@ End
%<--------------------------------------------------------------------------->
\subsection{tkzClip}
\begin{NewMacroBox}{tkzClip}{\oarg{local options}}
-Le rôle de cette macro est de rendre invisible ce qui est hors du rectangle défini par $(xmin~;~ymin)$ et $(xmax~;~ymax)$.
+The role of this macro is to make invisible what is outside the rectangle defined by $(xmin~;~ymin)$ and $(xmax~;~ymax)$.
\medskip
\begin{tabular}{lll}
\hline
-options & défaut & définition \\
+options & default & definition \\
\midrule
-\TOline{space} {1} {valeur ajoutée à droite, à gauche, en bas et en haut du background}
+\TOline{space} {1} {added value on the right, left, bottom and top of the background}
\bottomrule
\end{tabular}
\medskip
-{Le rôle de l'option \tkzname{space} est d'agrandir la partie visible du dessin. Cette partie devient le rectangle définit par $(xmin-space~;~ymin-space)$ et $(xmax+space~;~ymax+space)$. \tkzname{space} peut être négatif! L'unité est le cm et ne doit pas être indiquée. }
+The role of the \tkzname{space} option is to enlarge the visible part of the drawing. This part becomes the rectangle defined by $(xmin-space~;~ymin-space)$ and $(xmax+space~;~ymax+space)$. \tkzname{space} can be negative! The unit is cm and should not be specified.
\end{NewMacroBox}
-\subsubsection{Premier exemple avec \tkzcname{tkzClip}} \hypertarget{clip}{}
+\subsubsection{First example with \tkzcname{tkzClip}} \hypertarget{clip}{}
\begin{tkzexample}[latex=8cm,small]
\begin{tikzpicture}
@@ -160,6 +159,7 @@ options & défaut & définition \\
\end{tikzpicture}
\end{tkzexample}
+\subsubsection{Second example with \tkzcname{tkzClip}}
\begin{tkzexample}[latex=8cm,small]
\begin{tikzpicture}
\tkzInit[xmax=3, ymax=3]
@@ -170,17 +170,10 @@ options & défaut & définition \\
\end{tikzpicture}
\end{tkzexample}
%<--------------------------------------------------------------------------->
-Il est possible d'ajouter un peu d'espace \tkzcname{tkzClip[space]}
+It is possible to add a bit of space \tkzcname{tkzClip[space]}.
\subsubsection{\tkzcname{tkzClip} et l'option \tkzname{space}}
-Les dimensions pour définir le rectangle clippé sont \tkzname{xmin-1}, \tkzname{ymin-1}, \tkzname{xmax+1} et \tkzname{ymax+1}.
-\begin{tkzexample}[latex=8cm,small]
-\begin{tikzpicture}
- \tkzInit[xmax=3, ymax=3]
- \tkzGrid \tkzAxeXY
- \draw[red] (-0.5,-0.5)--(3.5,3.5);
-\end{tikzpicture}
-\end{tkzexample}
+The dimensions to define the clipped rectangle are \tkzname{xmin-1}, \tkzname{ymin-1}, \tkzname{xmax+1} and \tkzname{ymax+1}.
\begin{tkzexample}[latex=8cm,small]
\begin{tikzpicture}
@@ -191,8 +184,18 @@ Les dimensions pour définir le rectangle clippé sont \tkzname{xmin-1}, \tkznam
\end{tikzpicture}
\end{tkzexample}
-\subsection{style tkzreverseclip}
+\subsection{Reverse clip: tkzreverseclip}
+The next example uses
+
+\begin{tkzltxexample}[]
+ \def\tkzClipOutPolygon(#1,#2){\clip[tkzreserveclip] (#1)
+ \foreach \pt in {#2}{--(\pt)}--cycle;
+ }
+ \tikzset{tkzreverseclip/.style={insert path={%
+ (\tkz@xa,\tkz@ya) rectangle (\tkz@xb,\tkz@yb)}}}
+ \end{tkzltxexample}
+\subsubsection{Example with \tkzcname{tkzClipOutPolygon}}
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}[scale=.5]
\tkzInit[xmin=-5,xmax=5,ymin=-5,ymax=5]
@@ -215,11 +218,11 @@ Les dimensions pour définir le rectangle clippé sont \tkzname{xmin-1}, \tkznam
\end{tkzexample}
-\subsection{option tikz : trim left or right}
-voir le \tkzimp{pgfmanual}
+\subsection{Options from \TIKZ: trim left or right}
+See the \tkzimp{pgfmanual}
-\subsection{Commandes de TikZ \tkzcname{pgfinterruptboundingbox} et \tkzcname{endpgfinterruptboundingbox}}
-Cette commande interrompt temporairement le calcul de la boîte et configure une nouvelle boîte
+\subsection{TikZ Controls \tkzcname{pgfinterruptboundingbox} and \tkzcname{endpgfinterruptboundingbox}}
+This command temporarily interrupts the calculation of the box and configures a new box.
\begin{tkzexample}[latex=8cm,small]
\begin{tikzpicture}