Debian Codegraph @

texmf-dist/doc/latex/tikz3d-fr/tikz3d-fr-doc.tex

raw
1 % !TeX TXS-program:compile = txs:///arara
2 % arara: pdflatex: {shell: yes, synctex: no, interaction: batchmode}
3 % arara: pdflatex: {shell: yes, synctex: no, interaction: batchmode} if found('log', '(undefined references|Please rerun|Rerun to get)')
4
5 \documentclass[french,a4paper,11pt]{article}
6 \usepackage[margin=2cm,includefoot]{geometry}
7 \def\TPversion{0.1.5}
8 \def\TPdate{22 mai 2025}
9 \usepackage[utf8]{inputenc}
10 \usepackage[T1]{fontenc}
11 \usepackage{amsmath,amssymb}
12 \usepackage{tikz3d-fr}
13 \usepackage{awesomebox}
14 \usepackage{fontawesome5}
15 \usepackage{footnote}
16 \makesavenoteenv{tabular}
17 \usepackage{enumitem}
18 \usepackage{tabularray}
19 \UseTblrLibrary{diagbox}
20 \usepackage{fancyvrb}
21 \usepackage{fancyhdr}
22 \fancyhf{}
23 \renewcommand{\headrulewidth}{0pt}
24 \lfoot{\sffamily\small [tikz3d-fr]}
25 \cfoot{\sffamily\small - \thepage{} -}
26 \rfoot{\hyperlink{matoc}{\small\faArrowAltCircleUp[regular]}}
27
28 %\usepackage{hvlogos}
29 \usepackage{hologo}
30 \providecommand\tikzlogo{Ti\textit{k}Z}
31 \providecommand\TeXLive{\TeX{}Live\xspace}
32 \providecommand\PSTricks{\textsf{PSTricks}\xspace}
33 \let\pstricks\PSTricks
34 \let\TikZ\tikzlogo
35 \newcommand\TableauDocumentation{%
36 \begin{tblr}{width=\linewidth,colspec={X[c]X[c]X[c]X[c]X[c]X[c]},cells={font=\sffamily}}
37 {\LARGE \LaTeX} & & & & &\\
38 & {\LARGE \hologo{pdfLaTeX}} & & & & \\
39 & & {\LARGE \hologo{LuaLaTeX}} & & & \\
40 & & & {\LARGE \TikZ} & & \\
41 & & & & {\LARGE \TeXLive} & \\
42 & & & & & {\LARGE \hologo{MiKTeX}} \\
43 \end{tblr}
44 }
45
46 \usepackage{hyperref}
47 \urlstyle{same}
48 \hypersetup{pdfborder=0 0 0}
49 \setlength{\parindent}{0pt}
50 \definecolor{LightGray}{gray}{0.9}
51
52 \usepackage{babel}
53 \AddThinSpaceBeforeFootnotes
54 \FrenchFootnotes
55
56 \usepackage[most]{tcolorbox}
57 \usetikzlibrary{calc}
58 \usepackage{minted2}
59 \tcbuselibrary{minted}
60 \NewTCBListing{PresCodeTex}{ O{cyan} m }{%
61 enhanced,width=0.93\linewidth,flush right,boxrule=0.75pt,colframe=#1!85!black,%
62 sharp corners,top=0mm,bottom=0mm,left=0.4em,right=5mm,%
63 before skip=\baselineskip,after skip=\baselineskip,%
64 colback=white,
65 fontupper=\footnotesize,fontlower=\footnotesize,%
66 watermark text={\faCode},watermark opacity=0.25,watermark zoom=0.50,%
67 title={{\scriptsize\faCode} Code \LaTeX},
68 lefttitle=0.4em,
69 fonttitle=\bfseries\footnotesize\sffamily,colbacktitle=darkgray!50!#1,%
70 listing engine=minted,minted style=colorful,minted language=tex,
71 minted options={tabsize=4,fontsize=\footnotesize,autogobble,breaklines=true},
72 #2,%
73 overlay={\draw[#1!85!black] ($(frame.north west)+(-0.035\linewidth,-0.025\linewidth)$) node[scale=1.66] {\faCode} ;}
74 }
75
76 \NewTCBListing{PresCode}{ O{cyan} m }{%
77 enhanced,width=0.93\linewidth,flush right,boxrule=0.75pt,colframe=#1!85!black,%
78 sharp corners,top=0mm,bottom=0mm,left=0.4em,right=5mm,%
79 before skip=\baselineskip,after skip=\baselineskip,%
80 colback=white,
81 fontupper=\footnotesize,fontlower=\footnotesize,%
82 watermark text={\faCogs},watermark opacity=0.25,watermark zoom=0.50,%
83 title={{\scriptsize\faCogs} Code \LaTeX{} et sortie \LaTeX},
84 lefttitle=0.4em,
85 fonttitle=\bfseries\footnotesize\sffamily,colbacktitle=darkgray!50!#1,%
86 listing engine=minted,minted style=colorful,minted language=tex,
87 minted options={tabsize=4,fontsize=\footnotesize,autogobble,breaklines=true},
88 #2,%
89 overlay={%
90 \draw[#1!85!black] ($(frame.north west)+(-0.035\linewidth,-0.025\linewidth)$) node[scale=1.66] {\faCode} ;
91 \draw[#1!85!black] ($(segmentation.west)+(-0.035\linewidth,-0.025\linewidth)$) node[scale=1.66] {\faFilePdf} ;
92
93 }
94 }
95
96 \NewTCBListing{PresCodeSortie}{ O{cyan} m }{%
97 enhanced,width=0.93\linewidth,flush right,boxrule=0.75pt,colframe=#1!85!black,%
98 sharp corners,top=0mm,bottom=0mm,left=0.4em,right=5mm,%
99 before skip=\baselineskip,after skip=\baselineskip,%
100 colback=white,
101 fontupper=\footnotesize,fontlower=\footnotesize,%
102 watermark text={\faFilePdf},watermark opacity=0.25,watermark zoom=0.50,%
103 title={{\scriptsize\faFilePdf} Sortie \LaTeX},
104 lefttitle=0.4em,
105 fonttitle=\bfseries\footnotesize\sffamily,colbacktitle=darkgray!50!#1,%
106 listing engine=minted,minted style=colorful,minted language=tex,
107 minted options={tabsize=4,fontsize=\footnotesize,autogobble,breaklines=true},
108 #2,%
109 overlay={\draw[#1!85!black] ($(frame.north west)+(-0.035\linewidth,-0.025\linewidth)$) node[scale=1.66] {\faFilePdf} ;}
110 }
111
112 \NewTCBListing{PresentationCode}{ O{blue} m }{%
113 sharp corners=downhill,enhanced,arc=12pt,skin=bicolor,%
114 colback=#1!1!white,colframe=#1!75!black,colbacklower=white,%
115 attach boxed title to top right={yshift=-\tcboxedtitleheight},title=Code \LaTeX,%
116 boxed title style={%
117 colframe=#1!75!black,colback=#1!15!white,%
118 ,sharp corners=downhill,arc=12pt,%
119 },%
120 top=\baselineskip,%
121 fonttitle=\color{#1!90!black}\itshape\ttfamily\footnotesize,%
122 listing engine=minted,minted style=colorful,
123 minted language=tex,minted options={tabsize=4,fontsize=\small,autogobble},
124 #2
125 }
126
127 \tcbset{vignettes/.style={%
128 nobeforeafter,box align=base,boxsep=0pt,enhanced,sharp corners=all,rounded corners=southeast,%
129 boxrule=0.75pt,left=7pt,right=1pt,top=0pt,bottom=0.25pt,%
130 }
131 }
132
133 \tcbset{vignetteMaJ/.style={%
134 fontupper={\vphantom{pf}\footnotesize\ttfamily},
135 vignettes,colframe=ForestGreen!50!black,coltitle=white,colback=purple!25,%
136 overlay={\begin{tcbclipinterior}%
137 \fill[fill=purple!75]($(interior.south west)$) rectangle node[rotate=90]{\tiny \sffamily{\textcolor{Black}{\scalebox{0.85}[0.75]{\textbf{MàJ}}}}} ($(interior.north west)+(5pt,0pt)$);%
138 \end{tcbclipinterior}}
139 }
140 }
141
142 \newcommand\Cle[1]{{\bfseries\sffamily\textlangle #1\textrangle}}
143 \newcommand\cmaj[1]{\tcbox[vignetteMaJ]{#1}\xspace}
144
145 \begin{document}
146
147 \setlength{\aweboxleftmargin}{0.07\linewidth}
148 \setlength{\aweboxcontentwidth}{0.93\linewidth}
149 \setlength{\aweboxvskip}{8pt}
150
151 \pagestyle{fancy}
152
153 \thispagestyle{empty}
154
155 \vspace{2cm}
156
157 \begin{center}
158 \begin{minipage}{0.75\linewidth}
159 \begin{tcolorbox}[colframe=yellow,colback=yellow!15]
160 \begin{center}
161 \begin{tabular}{c}
162 {\Huge \texttt{tikz3d-fr}}\\
163 \\
164 {\LARGE Quelques commandes (fr) pour} \\
165 \\
166 {\LARGE un peu de 3D avec \TikZ.} \\
167 \end{tabular}
168
169 \bigskip
170
171 {\small \texttt{Version \TPversion{} -- \TPdate}}
172 \end{center}
173 \end{tcolorbox}
174 \end{minipage}
175 \end{center}
176
177 \begin{center}
178 \begin{tabular}{c}
179 \texttt{Cédric Pierquet}\\
180 {\ttfamily c pierquet -- at -- outlook . fr}\\
181 \texttt{\url{https://forge.apps.education.fr/pierquetcedric/packages-latex}}
182 \end{tabular}
183 \end{center}
184
185 \vspace{0.25cm}
186
187 {$\blacktriangleright$~~Un environnement avec déclaration des unités.}
188
189 \smallskip
190
191 {$\blacktriangleright$~~Une commande pour afficher un pavé, avec personnalisations.}
192
193 \smallskip
194
195 {$\blacktriangleright$~~Deux commandes pour afficher des empilements de \og petits cubes \fg.}
196
197 \vspace{1cm}
198
199 \begin{center}
200 \begin{tcolorbox}[enhanced,colframe=cyan,colback=cyan!2,center,width=0.95\linewidth,drop fuzzy shadow=lightgray]
201 \begin{EnvTikzEspace}
202 \PaveTikzTriDim[Cube,Largeur=2.5,AffLabel,Couleur=blue!50!black,CouleurSommets=red]
203 \end{EnvTikzEspace}
204
205 \vspace*{-2cm}
206
207 \hfill\BlocPetitsCubes[violet]{1,2,3,4,5 / 0,2,1,1,3 / 0,2,1,1,2 / 1,1,1,1,1}\hfill~
208
209 \vspace*{-2cm}
210
211 \def\listecouleursdes{red!25,blue!25,yellow!25,orange!25,green!25}\TirageAleaDesTriDim[EspaceH=-2mm]{5}
212 \hfill
213 \begin{EmpilementCubes}
214 \PlaquePetitsCubes[cyan/red/green/yellow]{ 3111-1-4 / 233123 / 2-1112 }
215 \PlaquePetitsCubes[cyan/red]{ 111 / -21 }
216 \PlaquePetitsCubes[cyan/red/green]{ 3-2 }
217 \end{EmpilementCubes}
218 \end{tcolorbox}
219 \end{center}
220
221 \vspace{0.5cm}
222
223 %\hfill{}\textit{Merci à Denis Bitouzé et à Gilles Le Bourhis pour leurs retours et idées !}
224
225 \smallskip
226
227 \vfill
228
229 \hrule
230
231 \medskip
232
233 \TableauDocumentation
234
235 \medskip
236
237 \hrule
238
239 \medskip
240
241 \newpage
242
243 \phantomsection
244 \hypertarget{matoc}{}
245
246 \tableofcontents
247
248 \pagebreak
249
250 \part{Historique}
251
252 \verb|v0.1.5|~:~~~~Bugfix
253
254 \verb|v0.1.4|~:~~~~Bugfix
255
256 \verb|v0.1.3|~:~~~~Affichage de dés en 3d (avec aléatoire possible)
257
258 \verb|v0.1.2|~:~~~~Option pour l'épaisseur des traits + \textsf{[line join=round]} pour les cubes
259
260 \verb|v0.1.1|~:~~~~Tracé des segments individuels avec l'option \textsf{[line cap=round]}
261
262 \verb|v0.1.0|~:~~~~Version initiale
263
264 \pagebreak
265
266 \part{Introduction}
267
268 \section{Le package tikz3d-fr}
269
270 \subsection{Introduction}
271
272 \begin{noteblock}
273 Le package propose des commandes basiques -- et francisées -- pour travailler sur des figures simples en 3D, à l'aide de \TikZ{} en utilisant des coordonnées tridimensionnelles :
274
275 \begin{itemize}
276 \item un environnement avec gestion des unités $x/y/z$ ;
277 \item une commande pour tracer et personnaliser un cube ;
278 \item des commandes pour créer/afficher/nommer des points de l'espace ;
279 \item des commandes pour tracer un ou plusieurs segments ;
280 \item des commandes et un environnement pour travailler sur des \textit{empilements} de cubes ;
281 \item des commandes pour représenter des dés en perspective (avec aléatoire possible).
282 \end{itemize}
283 \vspace*{-\baselineskip}\leavevmode
284 \end{noteblock}
285
286 \begin{importantblock}
287 Il existe d'autres solutions pour travailler avec de la 3D en \LaTeX, comme par exemple les packages \textsf{ProfCollege}\footnotemark\footnotetext{\url{https://www.ctan.org/pkg/profcollege}} (de Christophe Poulain, qui utilise \hologo{MetaPost}, et qui est certainement beaucoup plus performant) ou \textsf{pst-ob3d}\footnotemark\footnotetext{\url{https://www.ctan.org/pkg/pst-ob3d}} (de Herbert Voß et Denis Girou, qui utilise \pstricks).
288
289 \smallskip
290
291 L'idée est de proposer une utilisation des capacités (natives) 3D de \TikZ, en proposant des commandes \textit{simplifiées} et \textit{francisées} pour des figures simples (tétraèdres, cubes, pyramides, pavés) utilisées fréquemment dans des exercices de géométrie dans l'espace dans l'enseignement secondaires en France.
292 \end{importantblock}
293
294 \subsection{Chargement du package, packages utilisés}
295
296 \begin{importantblock}
297 Le package se charge, de manière classique, dans le préambule.
298
299 Il n'existe pas d'option pour le package, et \texttt{xcolor} n'est pas chargé.
300 \end{importantblock}
301
302 \begin{PresCodeTex}{listing only}
303 \usepackage{tikz3d-fr}
304 \end{PresCodeTex}
305
306 \begin{noteblock}
307 \textsf{tikz3d-fr} charge les packages suivantes :
308
309 \begin{itemize}
310 \item \texttt{tikz}, \texttt{xstring}, \texttt{xintexpr}, \texttt{simplekv} et \texttt{xinttools} et \texttt{listofitems}, \texttt{tikz-3dplot} et \texttt{randomlist} ;
311 \item la librairie \texttt{\textit{tikz}.calc}.
312 \end{itemize}
313
314 Il est compatible avec les compilations usuelles en \textsf{latex}, \textsf{pdflatex}, \textsf{lualatex} ou \textsf{xelatex}.
315 \end{noteblock}
316
317 \vfill~
318
319 \pagebreak
320
321 \part{Environnement 3D et commandes de base}
322
323 \section{Création de l'environnement}
324
325 \subsection{Commande}
326
327 \begin{cautionblock}
328 L'environnement dédié à la création de figures en 3D avec \TikZ{} est \texttt{EnvTikzEspace}.
329
330 Il permet de définir les unités et \textit{angles} des différents axes.
331 \end{cautionblock}
332
333 \begin{PresCodeTex}{listing only}
334 \begin{EnvTikzEspace}[Clés]<options tikz>
335 %commandes
336 \end{EnvTikzEspace}
337 \end{PresCodeTex}
338
339 \subsection{Clés et options}
340
341 \begin{tipblock}
342 Le premier argument, optionnel et entre \texttt{[...]} propose les \Cle{clés} suivantes :
343
344 \begin{itemize}
345 \item \Cle{UniteX}, à donner sous la forme \Cle{\{angle\string:longueur\}} pour le vecteur de base $\vec{\imath}$ ;
346
347 \hfill{}défaut : \Cle{\{-15\string:1cm\}},%
348 \item \Cle{UniteY}, à donner sous la forme \Cle{\{angle\string:longueur\}} pour le vecteur de base $\vec{\jmath}$ ;
349
350 \hfill{}défaut : \Cle{\{20\string:0.65cm\}}
351 \item \Cle{UniteZ}, à donner sous la forme \Cle{\{angle\string:longueur\}} pour le vecteur de base $\vec{k}$ ;
352
353 \hfill{}défaut : \Cle{\{90\string:1cm\}}
354 \item Le booléen \Cle{VueClassique} pour un affichage en perspective habituelle.\hfill~défaut : \Cle{false}
355 \end{itemize}
356 \vspace*{-\baselineskip}\leavevmode
357 \end{tipblock}
358
359 \begin{tipblock}
360 Le second argument, optionnel et entre \texttt{<...>} est quant à lui relatif à des arguments à passer à l'environnement \TikZ{} créé, comme par exemple un alignement vertical, etc
361 \end{tipblock}
362
363 \begin{PresCode}{}
364 \begin{EnvTikzEspace}
365 \draw[->,>=latex] (0,0,0)--(1,0,0) node[right] {$\vec{\imath}$} ;
366 \draw[->,>=latex] (0,0,0)--(0,1,0) node[right] {$\vec{\jmath}$} ;
367 \draw[->,>=latex] (0,0,0)--(0,0,1) node[above] {$\vec{k}$} ;
368 \end{EnvTikzEspace}
369 \end{PresCode}
370
371 \begin{PresCode}{}
372 \begin{EnvTikzEspace}[UniteX={-145:1.25cm},UniteY={0:1.75cm},UniteZ={90:1.75cm}]
373 \draw[->,>=latex] (0,0,0)--(1,0,0) node[right] {$\vec{\imath}$} ;
374 \draw[->,>=latex] (0,0,0)--(0,1,0) node[right] {$\vec{\jmath}$} ;
375 \draw[->,>=latex] (0,0,0)--(0,0,1) node[above] {$\vec{k}$} ;
376 \end{EnvTikzEspace}
377 \end{PresCode}
378
379 \begin{PresCode}{}
380 \begin{EnvTikzEspace}[VueClassique]
381 \draw[->,>=latex] (0,0,0)--(1,0,0) node[right] {$\vec{\imath}$} ;
382 \draw[->,>=latex] (0,0,0)--(0,1,0) node[right] {$\vec{\jmath}$} ;
383 \draw[->,>=latex] (0,0,0)--(0,0,1) node[above] {$\vec{k}$} ;
384 \end{EnvTikzEspace}
385 \end{PresCode}
386
387 \begin{noteblock}
388 Une fois l'environnement, via son \textit{repère}, est créé, toute commande en \TikZ{} est utilisable avec les coordonnées \texttt{(x,y,z)} ou bien les \texttt{scope} avec les \texttt{canva}.
389 \end{noteblock}
390
391 \begin{PresCode}{}
392 \begin{EnvTikzEspace}[UniteX={-145:0.575cm},UniteY={0:0.7cm},UniteZ={90:0.7cm}]
393 \filldraw[red] (2,4,3) circle[radius=1pt] ; \draw[red] (0,0,0) -- (2,4,3) ;
394 \draw[thin,->,>=latex] (0,0,0)--(3,0,0) ;
395 \draw[thin,->,>=latex] (0,0,0)--(0,5,0) ;
396 \draw[thin,->,>=latex] (0,0,0)--(0,0,4) ;
397 \draw[->,>=latex] (0,0,0)--(1,0,0) ;
398 \draw[->,>=latex] (0,0,0)--(0,1,0) ;
399 \draw[->,>=latex] (0,0,0)--(0,0,1) ;
400 \draw[dashed] (0,0,3)--(2,4,3)--(2,4,0)--(0,0,0) (2,4,0)--(2,0,0) (2,4,0)--(0,4,0) ;
401 \end{EnvTikzEspace}
402 \end{PresCode}
403
404 \pagebreak
405
406 \section{Points et segments}
407
408 \subsection{Commandes}
409
410 \begin{cautionblock}
411 Les commandes \textit{simplifiées} et \textit{francisées} disponibles sont :
412
413 \begin{itemize}
414 \item \texttt{\textbackslash PlacePointEspace} pour placer un point dans l'espace ;
415 \item \texttt{\textbackslash PlacePointsEspace} pour placer des points dans l'espace ;
416 \item \texttt{\textbackslash MarquePointEspace} pour marquer (matérialiser) un point dans l'espace ;
417 \item \texttt{\textbackslash MarquePointsEspace} pour marquer (matérialiser) un point dans l'espace ;
418 \item \texttt{\textbackslash TraceSegmentEspace} pour tracer un segment dans l'espace ;
419 \item \texttt{\textbackslash TraceSegmentsEspace} pour tracer des segments dans l'espace.
420 \end{itemize}
421 \vspace*{-\baselineskip}\leavevmode
422 \end{cautionblock}
423
424 \begin{PresCodeTex}{listing only}
425 \begin{EnvTikzEspace}[Clés]<options tikz>
426 %créer/placer/nommer un point
427 \PlacePointEspace(*)[clés]{nœud}{coordonnées}<label>
428 %créer/placer/nommer plusieurs points
429 \PlacePointsEspace(*)[clés]{liste}
430 %marquer un point
431 \MarquePointEspace[clés]{point}
432 %marquer plusieurs points
433 \MarquePointsEspace[clés]{liste}
434 %tracer un segment
435 \TraceSegmentEspace[clés](point)(point)
436 %tracer plusieurs segments
437 \TraceSegmentsEspace[clés]{liste}
438 \end{EnvTikzEspace}
439 \end{PresCodeTex}
440
441 \subsection{Clés, options et arguments}
442
443 \begin{tipblock}
444 Les versions étoilées désactivent l'affichage des labels des points.
445
446 \smallskip
447
448 L'argument optionnel et entre \texttt{[...]} propose les \Cle{clés} suivantes (communes ou spécifiques) :
449
450 \begin{itemize}
451 \item \Cle{PosLabel} pour préciser la position (francisée) du label pour les points ; \hfill{}défaut : \Cle{b}
452 \item \Cle{StyleMarque} parmi \Cle{x/o} pour spécifier le style de la marque des points ;
453
454 \hfill{}défaut : \Cle{o}
455 \item \Cle{TailleMarque} pour spécifier la taille de la marque des points (disque ou croix) ;
456
457 \hfill{}défaut : \Cle{2pt}
458 \item \Cle{Couleur} pour paramétrer la couleur.\hfill{}défaut : \Cle{black}
459 \end{itemize}
460 \vspace*{-\baselineskip}\leavevmode
461 \end{tipblock}
462
463 \begin{tipblock}
464 Les positions pour les labels des points sont \textit{francisées} :
465
466 \begin{itemize}
467 \item \Cle{b} : \texttt{bas}
468 \item \Cle{h} : \texttt{haut}
469 \item \Cle{g} : \texttt{gauche}
470 \item \Cle{d} : \texttt{droite}
471 \item \Cle{hg} : \texttt{haut gauche}
472 \item \ldots
473 \end{itemize}
474 \vspace*{-\baselineskip}\leavevmode
475 \end{tipblock}
476
477 \begin{tipblock}
478 De manière un peu plus spécifique :
479
480 \begin{itemize}
481 \item le \texttt{<label>} pour la commande \texttt{\textbackslash PlacePointEspace} est optionnel, et est identique à \texttt{\{nœud\}} ;
482 \item la \texttt{\{liste\}} pour la commande \texttt{\textbackslash PlacePointsEspace} est à donner -- par exemple -- sous la forme \texttt{A/0,0,0/bg B/5,2,1/hd} ;
483 \item la \texttt{\{liste\}} pour la commande \texttt{\textbackslash TraceSegmentsEspace} est à donner -- par exemple -- sous la forme \texttt{A/B A/C A/D B/D} ;
484 \item les \texttt{[clés]} pour les segments correspondent aux options en langage \TikZ.
485 \end{itemize}
486 \vspace*{-\baselineskip}\leavevmode
487 \end{tipblock}
488
489 \begin{PresCode}{}
490 \begin{EnvTikzEspace}[VueClassique]
491 %placement des points avec labels
492 \PlacePointsEspace[Couleur=red]{A/0,0,0/bg B/4,0,0/bd C/4,4,0/hd D/0,4,0/hg E/0,0,4/bg F/4,0,4/bd G/4,4,4/hd H/0,4,4/hg}
493 %segments pointillés
494 \TraceSegmentsEspace[thick,dashed,purple]{A/D D/C D/H}
495 %segments pleins
496 \TraceSegmentsEspace[thick,blue]{A/B B/C C/G G/H H/E E/A E/F B/F F/G}
497 %Marques points
498 \MarquePointsEspace[Couleur=orange]{A,B,C,D,E,F,G,H}
499 \end{EnvTikzEspace}
500 \end{PresCode}
501
502 \pagebreak
503
504 \section{Pavés}
505
506 \subsection{Commandes}
507
508 \begin{cautionblock}
509 La commande \textit{simplifiée} et \textit{francisée} pour afficher un pavé (ou un cube !) est la commande \texttt{\textbackslash PaveTikzTriDim}.
510 \end{cautionblock}
511
512 \begin{PresCodeTex}{listing only}
513 \begin{EnvTikzEspace}[Clés]<options tikz>
514 \PaveTikzTriDim[clés]
515 \end{EnvTikzEspace}
516 \end{PresCodeTex}
517
518 \begin{PresCode}{}
519 \begin{EnvTikzEspace}[VueClassique]
520 \PaveTikzTriDim
521 \end{EnvTikzEspace}
522 \hspace{1cm}
523 \begin{EnvTikzEspace}
524 \PaveTikzTriDim
525 \end{EnvTikzEspace}
526 \end{PresCode}
527
528 \subsection{Clés et options}
529
530 \begin{tipblock}
531 Quelques \Cle{clés} sont disponibles pour cette commande :
532
533 \begin{itemize}
534 \item \Cle{Largeur} : largeur du pavé ;\hfill{}défaut \Cle{2}
535 \item \Cle{Profondeur} : profondeur du pavé ;\hfill{}défaut \Cle{1}
536 \item \Cle{Hauteur} : hauteur du pavé ;\hfill{}défaut \Cle{1.25}
537 \item \Cle{Sommets} : liste des sommets (avec délimiteur § !) ;\hfill{}défaut \Cle{A§B§C§D§E§F§G§H}
538 \item \Cle{Math} : booléen pour forcer le mode math des sommets ;\hfill{}défaut \Cle{false}
539 \item \Cle{Epaisseur} : épaisseur des arêtes (en \textit{langage simplifié} \TikZ) ;\hfill{}défaut \Cle{thick}
540 \item \Cle{AffLabel} : booléen pour afficher les noms des sommets ;\hfill{}défaut \Cle{false}
541 \item \Cle{Plein} : booléen pour ne pas afficher les arêtes \textit{invisibles} ;\hfill{}défaut \Cle{false}
542 \item \Cle{Cube} : booléen pour préciser qu'il s'agit d'un cube (seule \Cle{Largeur} est util(isé)e) ;
543
544 \hfill{}défaut \Cle{false}
545 \item \Cle{Couleur} : couleur des arêtes ; \hfill{}défaut \Cle{black}
546
547 \item \Cle{CouleurSommets} : couleur des sommets.\hfill{}défaut \Cle{black}
548 \end{itemize}
549 \vspace*{-\baselineskip}\leavevmode
550 \end{tipblock}
551
552 \pagebreak
553
554 \begin{PresCode}{}
555 \begin{EnvTikzEspace}
556 \PaveTikzTriDim[Cube,Largeur=3,Couleur=red,CouleurSommets=blue,AffLabel]
557 \end{EnvTikzEspace}
558 \end{PresCode}
559
560 \begin{PresCode}{}
561 \begin{EnvTikzEspace}[VueClassique]<scale=2>
562 \PaveTikzTriDim[Largeur=3,Profondeur=4,Hauteur=2,Plein,Couleur=gray,AffLabel, CouleurSommets=gray]
563 \end{EnvTikzEspace}
564 \end{PresCode}
565
566 \newpage
567
568 \part{Empilements de cubes}
569
570 \section{Environnement dédié}
571
572 \begin{cautionblock}
573 L'environnement dédié à la création de figures type \textit{empilement de cubes} est\ldots{} \texttt{EmpilementCubes}.
574
575 Il existe deux manières de définir les empilements :
576
577 \begin{itemize}
578 \item en travaillant par \textit{plaques} verticales de l'arrière vers l'avant ;
579 \item en travaillant par les \textit{hauteurs} des colonnes, de l'arrière vers l'avant \textbf{et} de gauche à droite.
580 \end{itemize}
581
582 L'unité de base des cubes est fixée au départ à $0{,}5$\,cm.
583 \end{cautionblock}
584
585 \begin{importantblock}
586 Les axes (et de ce fait la vue proposée !) sont fixés, non modifiables, donc cette partie est beaucoup moins performante que ce propose le package \textsf{ProfCollege} avec sa commande \texttt{\textbackslash VueCubes} !
587 \end{importantblock}
588
589 \begin{PresCodeTex}{listing only}
590 \begin{EmpilementCubes}[échelle]<options tikz>
591 %commandes
592 \end{EmpilementCubes}
593 \end{PresCodeTex}
594
595 \section{Création par \textit{plaques}}
596
597 \subsection{Commandes}
598
599 \begin{cautionblock}
600 La commande pour créer une plaque \textit{verticale} est \texttt{\textbackslash PlaquePetitsCubes}, avec la contrainte de créer la \textit{figure} de l'arrière vers l'avant.
601
602 Il existe également la commande \texttt{\textbackslash PlaqueVide} pour \textit{passer} une ligne.
603 \end{cautionblock}
604
605 \begin{PresCodeTex}{listing only}
606 \begin{EmpilementCubes}[échelle]<options tikz>
607 \PlaquePetitsCubes[couleur(s)]{empilement}[épaisseur traits]
608 \PlaqueVide[nb]
609 \end{EmpilementCubes}
610 \end{PresCodeTex}
611
612 \begin{importantblock}
613 Les plaques créées sont affichées l'une \textit{devant} l'autre, et elles sont -- par défaut -- collées les unes aux autres.
614 \end{importantblock}
615
616 \subsection{Options et arguments}
617
618 \begin{tipblock}
619 Le premier argument, optionnel et entre \texttt{[...]} permet de spécifier une couleur (\texttt{cyan} par défaut) ou une liste de couleurs qui seront utilisées pour la création des plaques :
620
621 \begin{itemize}
622 \item soit une couleur unique, qui sera \textit{codée} par \texttt{1} pour la création des cubes ;
623 \item soit plusieurs couleurs, sous la forme \texttt{couleur1/couleur2/couleur3/...} qui seront codées par \texttt{1}, \texttt{2}, \ldots{} pour la création des cubes.
624 \end{itemize}
625
626 Le second argument, obligatoire et entre \texttt{\{...\}} est quant à lui la liste, des lignes à construire, avec comme ordres :
627
628 \begin{itemize}
629 \item du bas vers le haut (caractère de séparation \texttt{/}) ;
630 \item de la gauche vers la droite (caractère de séparation \texttt{,}) ;
631 \item un \texttt{-} code un \textit{trou}, et un numéro code une couleur (comme définie(s) précédemment).
632 \end{itemize}
633
634 Le dernier argument, optionnel et entre \texttt{[...]} permet de spécifier une dimension pour les tracés (\texttt{0.2pt} par défaut).
635
636 \medskip
637
638 Cette manière permet de créer des plaques avec couleurs \textit{individuelles} et des \textit{trous} éventuels.
639 \end{tipblock}
640
641 \begin{PresCode}{}
642 \begin{EmpilementCubes}
643 %plaque
644 %de bas en haut : couleurs VBRB-B-J / RVVBRV / J-BBBR
645 \PlaquePetitsCubes[cyan/red/green/yellow]{ 3121-1-4 / 233123 / 4-1112 }
646 \end{EmpilementCubes}
647 \end{PresCode}
648
649 \begin{PresCode}{}
650 \begin{EmpilementCubes}
651 %plaque n°1 (fond)
652 \PlaquePetitsCubes{ 1111 / 1111 }[0.4pt]
653 \PlaqueVide[2]
654 %plaque n°2
655 \PlaquePetitsCubes[cyan/red]{ 111- / -211 }[0.4pt]
656 \PlaqueVide[2]
657 %plaque n°3 (devant)
658 \PlaquePetitsCubes{ 1111 / ---1 }[0.4pt]
659 \end{EmpilementCubes}
660 \end{PresCode}
661
662 \begin{PresCode}{}
663 \begin{EmpilementCubes}
664 %plaque n°1 (fond)
665 \PlaquePetitsCubes{ 1111 / 1111 }
666 %plaque n°2
667 \PlaquePetitsCubes[cyan/red]{ 111- / -211 }
668 %plaque n°3 (devant)
669 \PlaquePetitsCubes{ 1111 / ---1 }
670 \end{EmpilementCubes}
671 \end{PresCode}
672
673
674 \begin{PresCode}{}
675 \begin{EmpilementCubes}[1.75]
676 \PlaquePetitsCubes[cyan/red/green/yellow]{ 3111-1-4 / 233123 / 2-1112 }[1pt]
677 \PlaquePetitsCubes[cyan/red]{ 111 / -21 }[1pt]
678 \PlaquePetitsCubes[cyan/red/green]{ 3-2 }[1pt]
679 \end{EmpilementCubes}
680 \end{PresCode}
681
682 \pagebreak
683
684 \section{Création par \textit{hauteurs}}
685
686 \subsection{Commande}
687
688 \begin{tipblock}
689 L'idée, reprise du package \textsf{ProfCollege}\footnotemark\footnotetext{\url{https://www.ctan.org/pkg/profcollege}} permet d'afficher une empilement de cubes (monochromes, et sans trou) en précisant -- grâce à un système de \textit{grille} -- les hauteurs des colonnes.
690
691 La commande qui permet de réaliser cet empilement est \texttt{\textbackslash BlocPetitsCubes}.
692 \end{tipblock}
693
694 \begin{PresCodeTex}{listing only}
695 %création dans un environnement dédié
696 \begin{EmpilementCubes}[échelle]<options tikz>
697 \BlocPetitsCubes*[couleur]{grille des hauteurs}[epaisseur traits]
698 \end{EmpilementCubes}
699 \end{PresCodeTex}
700
701 \begin{PresCodeTex}{listing only}
702 %création autonome
703 \BlocPetitsCubes[couleur]{grille des hauteurs}[epaisseur traits]
704 \end{PresCodeTex}
705
706 \begin{cautionblock}
707 Le support de la grille des hauteurs est donc à donner sous forme \textit{rectangulaire}, en respectant un nombre \textit{homogène} de colonnes par ligne !
708 \end{cautionblock}
709
710 \begin{importantblock}
711 Voici une grille permettant d’anticiper la création d'un assemblage (en spécifiant les hauteurs) :
712
713 \begin{center}
714 \begin{EnvTikzEspace}[UniteX={-22:1cm},UniteY={22:1cm}]
715 \foreach \x in {0,...,4} {\draw[semithick] (\x,-0.2,0)--++(0,5.4,0) ;}
716 \foreach \y in {0,...,5} {\draw[semithick] (-0.2,\y,0)--++(4.4,0,0) ;}
717 \foreach \y/\n in {0.5/1,1.5/2,2.5/3,3.5/4,4.5/5}
718 {\draw (0.5,\y,0) node[font=\small\sffamily] {\n} ;}
719 \foreach \y/\n in {0.5/0,1.5/2,2.5/1,3.5/1,4.5/3}
720 {\draw (1.5,\y,0) node[font=\small\sffamily] {\n} ;}
721 \foreach \y/\n in {0.5/0,1.5/2,2.5/1,3.5/1,4.5/2}
722 {\draw (2.5,\y,0) node[font=\small\sffamily] {\n} ;}
723 \foreach \y/\n in {0.5/1,1.5/1,2.5/1,3.5/1,4.5/1}
724 {\draw (3.5,\y,0) node[font=\small\sffamily] {\n} ;}
725 \end{EnvTikzEspace}
726 \end{center}
727 \end{importantblock}
728
729 \subsection{Options et arguments}
730
731 \begin{tipblock}
732 Le premier argument, optionnel et entre \texttt{[...]} permet de spécifier une couleur (\texttt{cyan} par défaut).
733
734 Le second argument, obligatoire et entre \texttt{\{...\}} est quant à lui la liste des hauteurs, comme présentée précédemment :
735
736 \begin{itemize}
737 \item le caractère de séparation des \textit{plaques} est le \texttt{/} ;
738 \item pour chaque plaque, le caractère de séparation des colonnes est le \texttt{,}.
739 \end{itemize}
740
741 Le dernier argument, optionnel et entre \texttt{[...]} permet de spécifier une dimension pour les tracés (\texttt{0.2pt} par défaut).
742 \end{tipblock}
743
744 \begin{importantblock}
745 Par exemple, la \textit{grille} associée à l'empilement précédent est :
746
747 \smallskip
748
749 \hfill\texttt{1,2,3,4,5 / 0,2,1,1,3 / 0,2,1,1,2 / 1,1,1,1,1}\hfill~
750 \end{importantblock}
751
752 \vfill~
753
754 \begin{PresCode}{}
755 \begin{EmpilementCubes}
756 \BlocPetitsCubes*{1,2,3,4,5}
757 \end{EmpilementCubes}
758 \end{PresCode}
759
760 \begin{PresCode}{}
761 %commande autonome, taille par défaut
762 \BlocPetitsCubes{1,2,3,4,5 / 0,2,1,1,3 / 0,2,1,1,2 / 1,1,1,1,1}
763 \end{PresCode}
764
765 \begin{PresCode}{}
766 \begin{EmpilementCubes}[2]
767 \BlocPetitsCubes*[violet]{1,2,3,4,5 / 0,2,1,1,3 / 0,2,1,1,2 / 1,1,1,1,1}[0.8pt]
768 \end{EmpilementCubes}
769 \end{PresCode}
770
771 \newpage
772
773 \part{Dés à jouer, en 3D}
774
775 \section{Fonctionnement global}
776
777 \begin{tipblock}
778 L'idée est de proposer des commandes pour travailler avec des dés, en 3D, avec possibilité de les \textit{lancer} de manière aléatoire.
779
780 \smallskip
781
782 La commande peut être autonome pour afficher dé par dé, mais elle peut être également à intégrer dans un environnement \texttt{tikzpicture}.
783 \end{tipblock}
784
785 \begin{importantblock}
786 Par défaut, les dés ont une hauteur proche de 1~cm (sans la perspective).
787
788 \smallskip
789
790 L'orientation est \textit{globalement} fixée, mais il est possible (dans une certaine mesure) de pivoter les dés (suivants les angles $\theta$ et $\phi$ des coordonnées sphériques).
791
792 \smallskip
793
794 Il est également possible de spécifier un \textit{angle de vue}, droite ou gauche.
795 \end{importantblock}
796
797
798 \begin{PresCodeTex}{listing only}
799 %affichage indépendant
800 \DeTriDim[clés]{numéro(s)}
801 \end{PresCodeTex}
802
803 \begin{PresCodeTex}{listing only}
804 %affichage dans un environnement
805 \begin{tikzpicture}
806 \DeTriDim*[clés]{numéro(s)}
807 \end{tikzpicture}
808 \end{PresCodeTex}
809
810 \begin{PresCodeTex}{listing only}
811 %tirages aléatoires
812 \TirageAleaDesTriDim[clés]{tirages}
813 \end{PresCodeTex}
814
815 \begin{PresCode}{}
816 \DeTriDim{6/2}~\DeTriDim{1/5}~\DeTriDim{6/4}~\DeTriDim{3/2}
817 \end{PresCode}
818
819 \begin{PresCode}{}
820 \begin{tikzpicture}
821 %\tdplotsetmaincoords{70}{110}
822 \DeTriDim*[Echelle=2]{6/2}
823 \DeTriDim*[Echelle=2,Origine={(2,-0.2)}]{6/5}
824 \DeTriDim*[Echelle=2,Origine={(4,-0.4)},]{6/3}
825 \DeTriDim*[Echelle=2,Origine={(6,-0.6)},Hasard]{}
826 \end{tikzpicture}
827 \end{PresCode}
828
829 \begin{PresCode}{}
830 \TirageAleaDesTriDim[Vue=G,Yams,Echelle=3,Couleurs={red!25,blue!25,yellow!25}]{3}
831 \end{PresCode}
832
833 \section{Influence des paramètres}
834
835 \subsection{Clés et options}
836
837 \begin{tipblock}
838 Quelques \Cle{clés} sont disponibles pour cette commande (elles ne sont pas toutes utilisées par les toutes les commandes) :
839
840 \begin{itemize}
841 \item \Cle{Echelle} : échelle pour modifier la taille ;\hfill{}défaut \Cle{1}
842 \item \Cle{Couleur} : couleur (individuelle) ;\hfill{}défaut \Cle{lightgray!25}
843 \item \Cle{CouleurPoints} : couleurs des points ;\hfill{}défaut \Cle{black}
844 \item \Cle{Phi} : angle $\phi$ de la perpective ;\hfill{}défaut \Cle{110}
845 \item \Cle{Theta} : angle $\theta$ de la perpective ;\hfill{}défaut \Cle{70}
846 \item \Cle{Vue} : vue de la perspective (\texttt{D/G}) ;\hfill{}défaut \Cle{D}
847 \item \Cle{Hasard} : booléen pour un tirage aléatoire ;\hfill{}défaut \Cle{false}
848 \item \Cle{Origine} : origine du dé pour la version \texttt{tikzpicture} ;
849 \item en ce qui concerne les clés spécifiques au tirage :
850 \begin{itemize}
851 \item \Cle{EspaceH} : espace horizontal entre les dés ;\hfill{}défaut \Cle{0mm}
852 \item \Cle{Couleurs} : liste des couleurs pour les dés ;\hfill{}défaut \Cle{lightgray!25}
853 \item \Cle{Yams} : booléen pour forcer un affichage en ligne.\hfill{}défaut \Cle{false}
854 \end{itemize}
855 \end{itemize}
856
857 Hormis dans le cas où \texttt{Harsard=true}, l'argument obligatoire, pour l'affichage unique, est à donner sous la forme \texttt{face de devant/face du dessus} (l'autre face visible est déterminée automatiquement).
858 \end{tipblock}
859
860 \subsection{Exemples}
861
862 \begin{PresCode}{}
863 \TirageAleaDesTriDim[EspaceH=-2mm]{5}
864
865 \TirageAleaDesTriDim[EspaceH=1mm,Echelle=2,Couleurs=darkgray,CouleurPoints=white]{5}
866 \end{PresCode}
867
868 \begin{PresCode}{}
869 \def\listecouleursdes{red!25,blue!25,yellow!25,orange!25,green!25}
870
871 \TirageAleaDesTriDim[Yams,Couleurs=brown!10]{10}
872
873 \TirageAleaDesTriDim[Yams,Echelle=2,Couleurs=\listecouleursdes,CouleurPoints=magenta]{5}
874
875 \TirageAleaDesTriDim[Vue=G,Yams,Echelle=3,Couleurs=\listecouleursdes]{3}
876 \end{PresCode}
877
878 \subsection{Angles de rotation}
879
880 \begin{cautionblock}
881 Les paramètres $\theta$ et $\phi$ peuvent être modifiés, en fonction du rendu souhaité.
882
883 Mais comme toutes les faces ne sont pas traitées (du fait de la perspective), il est conseillé de rester dans une \textit{fenêtre classique}.
884 \end{cautionblock}
885
886 \begin{tipblock}
887 Vue \texttt{D} :
888
889 \begin{tblr}{hlines,vlines,colspec={*{5}{Q[m,c]}}}
890 \diagbox{$\phi$}{$\theta$} & 60 & \textbf{70} & 80 & 85 \\
891 95 & \DeTriDim[Hasard,Theta=60,Phi=95]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=70,Phi=95]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=80,Phi=95]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=85,Phi=95]<baseline=0pt>{} \\
892 100 & \DeTriDim[Hasard,Theta=60,Phi=100]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=70,Phi=100]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=80,Phi=100]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=85,Phi=100]<baseline=0pt>{} \\
893 \textbf{110} & \DeTriDim[Hasard,Theta=60,Phi=95]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=70,Phi=110,Couleur=red!25]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=80,Phi=110]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=85,Phi=110]<baseline=0pt>{} \\
894 120 & \DeTriDim[Hasard,Theta=60,Phi=120]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=70,Phi=120]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=80,Phi=120]<baseline=0pt>{} & \DeTriDim[Hasard,Theta=85,Phi=120]<baseline=0pt>{} \\
895 \end{tblr}
896 \end{tipblock}
897
898 \begin{tipblock}
899 Vue \texttt{G} :
900
901 \begin{tblr}{hlines,vlines,colspec={*{5}{Q[m,c]}}}
902 \diagbox{$\phi$}{$\theta$} & 60 & \textbf{70} & 80 & 85 \\
903 95 & \DeTriDim[Vue=G,Hasard,Theta=60,Phi=95]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=70,Phi=95]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=80,Phi=95]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=85,Phi=95]<baseline=0pt>{} \\
904 100 & \DeTriDim[Vue=G,Hasard,Theta=60,Phi=100]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=70,Phi=100]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=80,Phi=100]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=85,Phi=100]<baseline=0pt>{} \\
905 \textbf{110} & \DeTriDim[Vue=G,Hasard,Theta=60,Phi=95]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=70,Phi=110,Couleur=red!25]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=80,Phi=110]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=85,Phi=110]<baseline=0pt>{} \\
906 120 & \DeTriDim[Vue=G,Hasard,Theta=60,Phi=120]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=70,Phi=120]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=80,Phi=120]<baseline=0pt>{} & \DeTriDim[Vue=G,Hasard,Theta=85,Phi=120]<baseline=0pt>{} \\
907 \end{tblr}
908 \end{tipblock}
909
910
911 \end{document}