diff options
author | Norbert Preining <norbert@preining.info> | 2020-03-09 03:01:39 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2020-03-09 03:01:39 +0000 |
commit | 0561778af6f8fde0a3a1c334e2aab9a4f1142d6e (patch) | |
tree | c19fe45e4101aed56e7fb3602174c6a5e335d7d1 /macros/latex/contrib/tkz/tkz-base/doc/latex/TKZdoc-base-BB.tex | |
parent | a8880a5ee484845d9a526c5ca8d21d31214af22b (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.tex | 77 |
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} |