summaryrefslogtreecommitdiff
path: root/graphics/pgf/contrib/tikz3d-fr/doc
diff options
context:
space:
mode:
Diffstat (limited to 'graphics/pgf/contrib/tikz3d-fr/doc')
-rw-r--r--graphics/pgf/contrib/tikz3d-fr/doc/tikz3d-fr-doc.pdfbin0 -> 603790 bytes
-rw-r--r--graphics/pgf/contrib/tikz3d-fr/doc/tikz3d-fr-doc.tex752
2 files changed, 752 insertions, 0 deletions
diff --git a/graphics/pgf/contrib/tikz3d-fr/doc/tikz3d-fr-doc.pdf b/graphics/pgf/contrib/tikz3d-fr/doc/tikz3d-fr-doc.pdf
new file mode 100644
index 0000000000..9566efab5b
--- /dev/null
+++ b/graphics/pgf/contrib/tikz3d-fr/doc/tikz3d-fr-doc.pdf
Binary files differ
diff --git a/graphics/pgf/contrib/tikz3d-fr/doc/tikz3d-fr-doc.tex b/graphics/pgf/contrib/tikz3d-fr/doc/tikz3d-fr-doc.tex
new file mode 100644
index 0000000000..548d68c219
--- /dev/null
+++ b/graphics/pgf/contrib/tikz3d-fr/doc/tikz3d-fr-doc.tex
@@ -0,0 +1,752 @@
+% !TeX TXS-program:compile = txs:///arara
+% arara: pdflatex: {shell: yes, synctex: no, interaction: batchmode}
+% arara: pdflatex: {shell: yes, synctex: no, interaction: batchmode} if found('log', '(undefined references|Please rerun|Rerun to get)')
+
+\documentclass[french,a4paper,11pt]{article}
+\usepackage[margin=2cm,includefoot]{geometry}
+\def\TPversion{0.1.0}
+\def\TPdate{02 Mai 2023}
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage{amsmath,amssymb}
+\usepackage{tikz3d-fr}
+\usepackage{awesomebox}
+\usepackage{fontawesome5}
+\usepackage{footnote}
+\makesavenoteenv{tabular}
+\usepackage{enumitem}
+\usepackage{tabularray}
+\usepackage{fancyvrb}
+\usepackage{fancyhdr}
+\fancyhf{}
+\renewcommand{\headrulewidth}{0pt}
+\lfoot{\sffamily\small [tikz3d-fr]}
+\cfoot{\sffamily\small - \thepage{} -}
+\rfoot{\hyperlink{matoc}{\small\faArrowAltCircleUp[regular]}}
+
+%\usepackage{hvlogos}
+\usepackage{hologo}
+\providecommand\tikzlogo{Ti\textit{k}Z}
+\providecommand\TeXLive{\TeX{}Live\xspace}
+\providecommand\PSTricks{\textsf{PSTricks}\xspace}
+\let\pstricks\PSTricks
+\let\TikZ\tikzlogo
+\newcommand\TableauDocumentation{%
+ \begin{tblr}{width=\linewidth,colspec={X[c]X[c]X[c]X[c]X[c]X[c]},cells={font=\sffamily}}
+ {\LARGE \LaTeX} & & & & &\\
+ & {\LARGE \hologo{pdfLaTeX}} & & & & \\
+ & & {\LARGE \hologo{LuaLaTeX}} & & & \\
+ & & & {\LARGE \TikZ} & & \\
+ & & & & {\LARGE \TeXLive} & \\
+ & & & & & {\LARGE \hologo{MiKTeX}} \\
+ \end{tblr}
+}
+
+\usepackage{hyperref}
+\urlstyle{same}
+\hypersetup{pdfborder=0 0 0}
+\setlength{\parindent}{0pt}
+\definecolor{LightGray}{gray}{0.9}
+
+\usepackage{babel}
+\AddThinSpaceBeforeFootnotes
+\FrenchFootnotes
+
+\usepackage[most]{tcolorbox}
+\usetikzlibrary{calc}
+\tcbuselibrary{minted}
+\NewTCBListing{PresCodeTex}{ O{cyan} m }{%
+ enhanced,width=0.93\linewidth,flush right,boxrule=0.75pt,colframe=#1!85!black,%
+ sharp corners,top=0mm,bottom=0mm,left=0.4em,right=5mm,%
+ before skip=\baselineskip,after skip=\baselineskip,%
+ colback=white,
+ fontupper=\footnotesize,fontlower=\footnotesize,%
+ watermark text={\faCode},watermark opacity=0.25,watermark zoom=0.50,%
+ title={{\scriptsize\faCode} Code \LaTeX},
+ lefttitle=0.4em,
+ fonttitle=\bfseries\footnotesize\sffamily,colbacktitle=darkgray!50!#1,%
+ listing engine=minted,minted style=colorful,minted language=tex,
+ minted options={tabsize=4,fontsize=\footnotesize,autogobble,breaklines=true},
+ #2,%
+ overlay={\draw[#1!85!black] ($(frame.north west)+(-0.035\linewidth,-0.025\linewidth)$) node[scale=1.66] {\faCode} ;}
+}
+
+\NewTCBListing{PresCode}{ O{cyan} m }{%
+ enhanced,width=0.93\linewidth,flush right,boxrule=0.75pt,colframe=#1!85!black,%
+ sharp corners,top=0mm,bottom=0mm,left=0.4em,right=5mm,%
+ before skip=\baselineskip,after skip=\baselineskip,%
+ colback=white,
+ fontupper=\footnotesize,fontlower=\footnotesize,%
+ watermark text={\faCogs},watermark opacity=0.25,watermark zoom=0.50,%
+ title={{\scriptsize\faCogs} Code \LaTeX{} et sortie \LaTeX},
+ lefttitle=0.4em,
+ fonttitle=\bfseries\footnotesize\sffamily,colbacktitle=darkgray!50!#1,%
+ listing engine=minted,minted style=colorful,minted language=tex,
+ minted options={tabsize=4,fontsize=\footnotesize,autogobble,breaklines=true},
+ #2,%
+ overlay={%
+ \draw[#1!85!black] ($(frame.north west)+(-0.035\linewidth,-0.025\linewidth)$) node[scale=1.66] {\faCode} ;
+ \draw[#1!85!black] ($(segmentation.west)+(-0.035\linewidth,-0.025\linewidth)$) node[scale=1.66] {\faFilePdf} ;
+
+ }
+}
+
+\NewTCBListing{PresCodeSortie}{ O{cyan} m }{%
+ enhanced,width=0.93\linewidth,flush right,boxrule=0.75pt,colframe=#1!85!black,%
+ sharp corners,top=0mm,bottom=0mm,left=0.4em,right=5mm,%
+ before skip=\baselineskip,after skip=\baselineskip,%
+ colback=white,
+ fontupper=\footnotesize,fontlower=\footnotesize,%
+ watermark text={\faFilePdf},watermark opacity=0.25,watermark zoom=0.50,%
+ title={{\scriptsize\faFilePdf} Sortie \LaTeX},
+ lefttitle=0.4em,
+ fonttitle=\bfseries\footnotesize\sffamily,colbacktitle=darkgray!50!#1,%
+ listing engine=minted,minted style=colorful,minted language=tex,
+ minted options={tabsize=4,fontsize=\footnotesize,autogobble,breaklines=true},
+ #2,%
+ overlay={\draw[#1!85!black] ($(frame.north west)+(-0.035\linewidth,-0.025\linewidth)$) node[scale=1.66] {\faFilePdf} ;}
+}
+
+\NewTCBListing{PresentationCode}{ O{blue} m }{%
+ sharp corners=downhill,enhanced,arc=12pt,skin=bicolor,%
+ colback=#1!1!white,colframe=#1!75!black,colbacklower=white,%
+ attach boxed title to top right={yshift=-\tcboxedtitleheight},title=Code \LaTeX,%
+ boxed title style={%
+ colframe=#1!75!black,colback=#1!15!white,%
+ ,sharp corners=downhill,arc=12pt,%
+ },%
+ top=\baselineskip,%
+ fonttitle=\color{#1!90!black}\itshape\ttfamily\footnotesize,%
+ listing engine=minted,minted style=colorful,
+ minted language=tex,minted options={tabsize=4,fontsize=\small,autogobble},
+ #2
+}
+
+\tcbset{vignettes/.style={%
+ nobeforeafter,box align=base,boxsep=0pt,enhanced,sharp corners=all,rounded corners=southeast,%
+ boxrule=0.75pt,left=7pt,right=1pt,top=0pt,bottom=0.25pt,%
+ }
+}
+
+\tcbset{vignetteMaJ/.style={%
+ fontupper={\vphantom{pf}\footnotesize\ttfamily},
+ vignettes,colframe=ForestGreen!50!black,coltitle=white,colback=purple!25,%
+ overlay={\begin{tcbclipinterior}%
+ \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)$);%
+ \end{tcbclipinterior}}
+ }
+}
+
+\newcommand\Cle[1]{{\bfseries\sffamily\textlangle #1\textrangle}}
+\newcommand\cmaj[1]{\tcbox[vignetteMaJ]{#1}\xspace}
+
+\begin{document}
+
+\setlength{\aweboxleftmargin}{0.07\linewidth}
+\setlength{\aweboxcontentwidth}{0.93\linewidth}
+\setlength{\aweboxvskip}{8pt}
+
+\pagestyle{fancy}
+
+\thispagestyle{empty}
+
+\vspace{2cm}
+
+\begin{center}
+ \begin{minipage}{0.75\linewidth}
+ \begin{tcolorbox}[colframe=yellow,colback=yellow!15]
+ \begin{center}
+ \begin{tabular}{c}
+ {\Huge \texttt{tikz3d-fr}}\\
+ \\
+ {\LARGE Quelques commandes (fr) pour} \\
+ \\
+ {\LARGE un peu de 3D avec \TikZ.} \\
+ \end{tabular}
+
+ \bigskip
+
+ {\small \texttt{Version \TPversion{} -- \TPdate}}
+ \end{center}
+ \end{tcolorbox}
+\end{minipage}
+\end{center}
+
+\begin{center}
+ \begin{tabular}{c}
+ \texttt{Cédric Pierquet}\\
+ {\ttfamily c pierquet -- at -- outlook . fr}\\
+ \texttt{\url{https://github.com/cpierquet/tikz3dfr}}
+\end{tabular}
+\end{center}
+
+\vspace{0.25cm}
+
+{$\blacktriangleright$~~Un environnement avec déclaration des unités.}
+
+\smallskip
+
+{$\blacktriangleright$~~Une commande pour afficher un pavé, avec personnalisations.}
+
+\smallskip
+
+{$\blacktriangleright$~~Deux commandes pour afficher des empilements de \og petits cubes \fg.}
+
+\vspace{1cm}
+
+\begin{center}
+ \begin{tcolorbox}[enhanced,colframe=cyan,colback=cyan!2,center,width=0.95\linewidth,drop fuzzy shadow=lightgray]
+ \begin{EnvTikzEspace}
+ \PaveTikzTriDim[Cube,Largeur=2.5,AffLabel,Couleur=blue!50!black,CouleurSommets=red]
+ \end{EnvTikzEspace}
+
+ \vspace*{-2cm}
+
+ \hfill\BlocPetitsCubes[violet]{1,2,3,4,5 / 0,2,1,1,3 / 0,2,1,1,2 / 1,1,1,1,1}\hfill~
+
+ \vspace*{-2cm}
+
+ \hfill
+ \begin{EmpilementCubes}
+ \PlaquePetitsCubes[cyan/red/green/yellow]{ 3111-1-4 / 233123 / 2-1112 }
+ \PlaquePetitsCubes[cyan/red]{ 111 / -21 }
+ \PlaquePetitsCubes[cyan/red/green]{ 3-2 }
+ \end{EmpilementCubes}
+ \end{tcolorbox}
+\end{center}
+
+\vspace{0.5cm}
+
+%\hfill{}\textit{Merci à Denis Bitouzé et à Gilles Le Bourhis pour leurs retours et idées !}
+
+\smallskip
+
+\vfill
+
+\hrule
+
+\medskip
+
+\TableauDocumentation
+
+\medskip
+
+\hrule
+
+\medskip
+
+\newpage
+
+\phantomsection
+\hypertarget{matoc}{}
+
+\tableofcontents
+
+\vfill
+
+\part{Historique}
+
+\verb|v0.1.0|~:~~~~Version initiale.
+
+\newpage
+
+\part{Introduction}
+
+\section{Le package tikz3d-fr}
+
+\subsection{Introduction}
+
+\begin{noteblock}
+Le package propose des commandes basiques -- francisées -- pour travailler sur des figures simples en 3D, à l'aide de \TikZ{} en utilisant des coordonnées tridimensionnelles :
+
+\begin{itemize}
+ \item un environnement avec gestion des unités $x/y/z$ ;
+ \item une commande pour tracer et personnaliser un cube ;
+ \item des commandes pour créer/afficher/nommer des points de l'espace ;
+ \item des commandes pour tracer un ou plusieurs segments ;
+ \item des commandes et un environnement pour travailler sur des \textit{empilements} de cubes.
+\end{itemize}
+\vspace*{-\baselineskip}\leavevmode
+\end{noteblock}
+
+\begin{importantblock}
+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).
+
+\smallskip
+
+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.
+\end{importantblock}
+
+\subsection{Chargement du package, packages utilisés}
+
+\begin{importantblock}
+Le package se charge, de manière classique, dans le préambule.
+
+Il n'existe pas d'option pour le package, et \texttt{xcolor} n'est pas chargé avec des options spécifiques.
+\end{importantblock}
+
+\begin{PresCodeTex}{listing only}
+\usepackage{tikz3d-fr}
+\end{PresCodeTex}
+
+\begin{noteblock}
+\textsf{tikz3d-fr} charge les packages suivantes :
+
+\begin{itemize}
+ \item \texttt{tikz}, \texttt{xstring}, \texttt{xintexpr}, \texttt{simplekv} et \texttt{xinttools} et \texttt{listofitems} ;
+ \item les librairies \texttt{\textit{tikz}.calc} et \texttt{\textit{tikz}.babel}.
+\end{itemize}
+
+Il est compatible avec les compilations usuelles en \textsf{latex}, \textsf{pdflatex}, \textsf{lualatex} ou \textsf{xelatex}.
+\end{noteblock}
+
+\vfill~
+
+\pagebreak
+
+\part{Environnement 3D et commandes de base}
+
+\section{Création de l'environnement}
+
+\subsection{Commande}
+
+\begin{cautionblock}
+L'environnement dédié à la création de figures en 3D avec \TikZ{} est \texttt{EnvTikzEspace}.
+
+Il permet de définir les unités et \textit{angles} des différents axes.
+\end{cautionblock}
+
+\begin{PresCodeTex}{listing only}
+\begin{EnvTikzEspace}[Clés]<options tikz>
+ %commandes
+\end{EnvTikzEspace}
+\end{PresCodeTex}
+
+\subsection{Clés et options}
+
+\begin{tipblock}
+Le premier argument, optionnel et entre \texttt{[...]} propose les \Cle{clés} suivantes :
+
+\begin{itemize}
+ \item \Cle{UniteX}, à donner sous la forme \Cle{\{angle\string:longueur\}} pour le vecteur de base $\vec{\imath}$ ;
+
+ \hfill{}défaut : \Cle{\{-15\string:1cm\}},%
+ \item \Cle{UniteY}, à donner sous la forme \Cle{\{angle\string:longueur\}} pour le vecteur de base $\vec{\jmath}$ ;
+
+ \hfill{}défaut : \Cle{\{20\string:0.65cm\}}
+ \item \Cle{UniteZ}, à donner sous la forme \Cle{\{angle\string:longueur\}} pour le vecteur de base $\vec{k}$ ;
+
+ \hfill{}défaut : \Cle{\{90\string:1cm\}}
+ \item Le booléen \Cle{VueClassique} pour un affichage en perspective habituelle.\hfill~défaut : \Cle{false}
+\end{itemize}
+\vspace*{-\baselineskip}\leavevmode
+\end{tipblock}
+
+\begin{tipblock}
+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
+\end{tipblock}
+
+\begin{PresCode}{}
+\begin{EnvTikzEspace}
+ \draw[->,>=latex] (0,0,0)--(1,0,0) node[right] {$\vec{\imath}$} ;
+ \draw[->,>=latex] (0,0,0)--(0,1,0) node[right] {$\vec{\jmath}$} ;
+ \draw[->,>=latex] (0,0,0)--(0,0,1) node[above] {$\vec{k}$} ;
+\end{EnvTikzEspace}
+\end{PresCode}
+
+\begin{PresCode}{}
+\begin{EnvTikzEspace}[UniteX={-145:1.25cm},UniteY={0:1.75cm},UniteZ={90:1.75cm}]
+ \draw[->,>=latex] (0,0,0)--(1,0,0) node[right] {$\vec{\imath}$} ;
+ \draw[->,>=latex] (0,0,0)--(0,1,0) node[right] {$\vec{\jmath}$} ;
+ \draw[->,>=latex] (0,0,0)--(0,0,1) node[above] {$\vec{k}$} ;
+\end{EnvTikzEspace}
+\end{PresCode}
+
+\begin{PresCode}{}
+\begin{EnvTikzEspace}[VueClassique]
+ \draw[->,>=latex] (0,0,0)--(1,0,0) node[right] {$\vec{\imath}$} ;
+ \draw[->,>=latex] (0,0,0)--(0,1,0) node[right] {$\vec{\jmath}$} ;
+ \draw[->,>=latex] (0,0,0)--(0,0,1) node[above] {$\vec{k}$} ;
+\end{EnvTikzEspace}
+\end{PresCode}
+
+\begin{noteblock}
+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}.
+\end{noteblock}
+
+\begin{PresCode}{}
+\begin{EnvTikzEspace}[UniteX={-145:0.575cm},UniteY={0:0.7cm},UniteZ={90:0.7cm}]
+ \filldraw[red] (2,4,3) circle[radius=1pt] ; \draw[red] (0,0,0) -- (2,4,3) ;
+ \draw[thin,->,>=latex] (0,0,0)--(3,0,0) ;
+ \draw[thin,->,>=latex] (0,0,0)--(0,5,0) ;
+ \draw[thin,->,>=latex] (0,0,0)--(0,0,4) ;
+ \draw[->,>=latex] (0,0,0)--(1,0,0) ;
+ \draw[->,>=latex] (0,0,0)--(0,1,0) ;
+ \draw[->,>=latex] (0,0,0)--(0,0,1) ;
+ \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) ;
+\end{EnvTikzEspace}
+\end{PresCode}
+
+\pagebreak
+
+\section{Points et segments}
+
+\subsection{Commandes}
+
+\begin{cautionblock}
+Les commandes \textit{simplifiées} et \textit{francisées} disponible sont :
+
+\begin{itemize}
+ \item \texttt{\textbackslash PlacePointEspace} pour placer un point dans l'espace ;
+ \item \texttt{\textbackslash PlacePointsEspace} pour placer des points dans l'espace ;
+ \item \texttt{\textbackslash MarquePointEspace} pour marquer (matérialiser) un point dans l'espace ;
+ \item \texttt{\textbackslash MarquePointsEspace} pour marquer (matérialiser) un point dans l'espace ;
+ \item \texttt{\textbackslash TraceSegmentEspace} pour tracer un segment dans l'espace ;
+ \item \texttt{\textbackslash TraceSegmentsEspace} pour tracer des segments dans l'espace.
+\end{itemize}
+\vspace*{-\baselineskip}\leavevmode
+\end{cautionblock}
+
+\begin{PresCodeTex}{listing only}
+\begin{EnvTikzEspace}[Clés]<options tikz>
+ %créer/placer/nommer un point
+ \PlacePointEspace(*)[clés]{nœud}{coordonnées}<label>
+ %créer/placer/nommer plusieurs points
+ \PlacePointsEspace(*)[clés]{liste}
+ %marquer un point
+ \MarquePointEspace[clés]{point}
+ %marquer plusieurs points
+ \MarquePointsEspace[clés]{liste}
+ %tracer un segment
+ \TraceSegmentEspace[clés](point)(point)
+ %tracer plusieurs segments
+ \TraceSegmentsEspace[clés]{liste}
+\end{EnvTikzEspace}
+\end{PresCodeTex}
+
+\subsection{Clés, options et arguments}
+
+\begin{tipblock}
+Les versions étoilées désactivent l'affichage des labels des points.
+
+\smallskip
+
+L'argument optionnel et entre \texttt{[...]} propose les \Cle{clés} suivantes (communes ou spécifiques) :
+
+\begin{itemize}
+ \item \Cle{PosLabel} pour préciser la position (francisée) du label pour les points ; \hfill{}défaut : \Cle{b}
+ \item \Cle{StyleMarque} parmi \Cle{x/o} pour spécifier le style de la marque des points ;
+
+ \hfill{}défaut : \Cle{o}
+ \item \Cle{TailleMarque} pour spécifier la taille de la marque des points (disque ou croix) ;
+
+ \hfill{}défaut : \Cle{2pt}
+ \item \Cle{Couleur} pour paramétrer la couleur.\hfill{}défaut : \Cle{black}
+\end{itemize}
+\vspace*{-\baselineskip}\leavevmode
+\end{tipblock}
+
+\begin{tipblock}
+Les positions pour les labels des points sont \textit{francisées} :
+
+\begin{itemize}
+ \item \Cle{b} : \texttt{bas}
+ \item \Cle{h} : \texttt{haut}
+ \item \Cle{g} : \texttt{gauche}
+ \item \Cle{d} : \texttt{droite}
+ \item \Cle{hg} : \texttt{haut gauche}
+ \item \ldots
+\end{itemize}
+\vspace*{-\baselineskip}\leavevmode
+\end{tipblock}
+
+\begin{tipblock}
+De manière un peu plus spécifique :
+
+\begin{itemize}
+ \item le \texttt{<label>} pour la commande \texttt{\textbackslash PlacePointEspace} est optionnel, et est identique à \texttt{\{nœud\}} ;
+ \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} ;
+ \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} ;
+ \item les \texttt{[clés]} pour les segments correspondent aux options en langage \TikZ.
+\end{itemize}
+\vspace*{-\baselineskip}\leavevmode
+\end{tipblock}
+
+\begin{PresCode}{}
+\begin{EnvTikzEspace}[VueClassique]
+ %placement des points avec labels
+ \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}
+ %segments pointillés
+ \TraceSegmentsEspace[thick,dashed,purple]{A/D D/C D/H}
+ %segments pleins
+ \TraceSegmentsEspace[thick,blue]{A/B B/C C/G G/H H/E E/A E/F B/F F/G}
+ %Marques points
+ \MarquePointsEspace[Couleur=orange]{A,B,C,D,E,F,G,H}
+\end{EnvTikzEspace}
+\end{PresCode}
+
+\pagebreak
+
+\section{Pavés}
+
+\subsection{Commandes}
+
+\begin{cautionblock}
+Les commandes \textit{simplifiée} et \textit{francisé} pour afficher un pavé (ou un cube !) est la commande \texttt{\textbackslash PaveTikzTriDim}.
+\end{cautionblock}
+
+\begin{PresCodeTex}{listing only}
+\begin{EnvTikzEspace}[Clés]<options tikz>
+ \PaveTikzTriDim[clés]
+\end{EnvTikzEspace}
+\end{PresCodeTex}
+
+\begin{PresCode}{}
+\begin{EnvTikzEspace}[VueClassique]
+ \PaveTikzTriDim
+\end{EnvTikzEspace}
+\hspace{1cm}
+\begin{EnvTikzEspace}
+ \PaveTikzTriDim
+\end{EnvTikzEspace}
+\end{PresCode}
+
+\subsection{Clés et options}
+
+\begin{tipblock}
+Quelques \Cle{clés} sont disponibles pour cette commande :
+
+\begin{itemize}
+ \item \Cle{Largeur} : largeur du pavé ;\hfill{}défaut \Cle{2}
+ \item \Cle{Profondeur} : profondeur du pavé ;\hfill{}défaut \Cle{1}
+ \item \Cle{Hauteur} : hauteur du pavé ;\hfill{}défaut \Cle{1.25}
+ \item \Cle{Sommets} : liste des sommets (avec délimiteur § !) ;\hfill{}défaut \Cle{A§B§C§D§E§F§G§H}
+ \item \Cle{Math} : booléen pour forcer le mode math des sommets ;\hfill{}défaut \Cle{false}
+ \item \Cle{Epaisseur} : épaisseur des arêtes (en \textit{langage simplifié} \TikZ) ;\hfill{}défaut \Cle{thick}
+ \item \Cle{AffLabel} : booléen pour afficher les noms des sommets ;\hfill{}défaut \Cle{false}
+ \item \Cle{Plein} : booléen pour ne pas afficher les arêtes \textit{invisibles} ;\hfill{}défaut \Cle{false}
+ \item \Cle{Cube} : booléen pour préciser qu'il s'agit d'un cube (seule \Cle{Largeur} est util(isé)e) ;
+
+ \hfill{}défaut \Cle{false}
+ \item \Cle{Couleur} : couleur des arêtes ; \hfill{}défaut \Cle{black}
+
+ \item \Cle{CouleurSommets} : couleur des sommets.\hfill{}défaut \Cle{black}
+\end{itemize}
+\vspace*{-\baselineskip}\leavevmode
+\end{tipblock}
+
+\pagebreak
+
+\begin{PresCode}{}
+\begin{EnvTikzEspace}
+ \PaveTikzTriDim[Cube,Largeur=3,Couleur=red,CouleurSommets=blue,AffLabel]
+\end{EnvTikzEspace}
+\end{PresCode}
+
+\begin{PresCode}{}
+\begin{EnvTikzEspace}[VueClassique]<scale=2>
+ \PaveTikzTriDim[Largeur=3,Profondeur=4,Hauteur=2,Plein,Couleur=gray,AffLabel, CouleurSommets=gray]
+\end{EnvTikzEspace}
+\end{PresCode}
+
+\newpage
+
+\part{Empilements de cubes}
+
+\section{Environnement dédié}
+
+\begin{cautionblock}
+L'environnement dédié à la création de figures type \textit{empilement de cubes} est\ldots{} \texttt{EmpilementCubes}.
+
+Il existe deux manières de définir les empilements :
+
+\begin{itemize}
+ \item en travaillant par \textit{plaques} verticales de l'arrière vers l'avant ;
+ \item en travaillant par les \textit{hauteurs} des colonnes, de l'arrière vers l'avant \textbf{et} de gauche à droite.
+\end{itemize}
+
+L'unité de base des cubes est fixée au départ à $0{,}5$\,cm.
+\end{cautionblock}
+
+\begin{importantblock}
+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} !
+\end{importantblock}
+
+\begin{PresCodeTex}{listing only}
+\begin{EmpilementCubes}[échelle]<options tikz>
+ %commandes
+\end{EmpilementCubes}
+\end{PresCodeTex}
+
+\section{Création par \textit{plaques}}
+
+\subsection{Commandes}
+
+\begin{cautionblock}
+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.
+
+Il existe également la commande \texttt{\textbackslash PlaqueVide} pour \textit{passer} une ligne.
+\end{cautionblock}
+
+\begin{PresCodeTex}{listing only}
+\begin{EmpilementCubes}[échelle]<options tikz>
+ \PlaquePetitsCubes[couleur(s)]{empilement}
+ \PlaqueVide[nb]
+\end{EmpilementCubes}
+\end{PresCodeTex}
+
+\begin{importantblock}
+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.
+\end{importantblock}
+
+\subsection{Options et arguments}
+
+\begin{tipblock}
+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 :
+
+\begin{itemize}
+ \item soit une couleur unique, qui sera \textit{codée} par \texttt{1} pour la création des cubes ;
+ \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.
+\end{itemize}
+
+Le second argument, obligatoire et entre \texttt{\{...\}} est quant à lui la liste, des lignes à construire, avec comme ordres :
+
+\begin{itemize}
+ \item du bas vers le haut (caractère de séparation \texttt{/}) ;
+ \item de la gauche vers la droite (caractère de séparation \texttt{,}) ;
+ \item un \texttt{-} code un \textit{trou}, et un numéro code une couleur (comme définie(s) précédemment).
+\end{itemize}
+
+Cette manière permet de créer des plaques avec couleurs \textit{individuelles} et des \textit{trous} éventuels.
+\end{tipblock}
+
+\begin{PresCode}{}
+\begin{EmpilementCubes}
+ %plaque
+ %de bas en haut : couleurs VBRB-B-J / RVVBRV / J-BBBR
+ \PlaquePetitsCubes[cyan/red/green/yellow]{ 3121-1-4 / 233123 / 4-1112 }
+\end{EmpilementCubes}
+\end{PresCode}
+
+\begin{PresCode}{}
+\begin{EmpilementCubes}
+ %plaque n°1 (fond)
+ \PlaquePetitsCubes{ 1111 / 1111 }
+ \PlaqueVide[2]
+ %plaque n°2
+ \PlaquePetitsCubes[cyan/red]{ 111- / -211 }
+ \PlaqueVide[2]
+ %plaque n°3 (devant)
+ \PlaquePetitsCubes{ 1111 / ---1 }
+\end{EmpilementCubes}
+\end{PresCode}
+
+\begin{PresCode}{}
+\begin{EmpilementCubes}
+ %plaque n°1 (fond)
+ \PlaquePetitsCubes{ 1111 / 1111 }
+ %plaque n°2
+ \PlaquePetitsCubes[cyan/red]{ 111- / -211 }
+ %plaque n°3 (devant)
+ \PlaquePetitsCubes{ 1111 / ---1 }
+\end{EmpilementCubes}
+\end{PresCode}
+
+
+\begin{PresCode}{}
+\begin{EmpilementCubes}[1.75]
+ \PlaquePetitsCubes[cyan/red/green/yellow]{ 3111-1-4 / 233123 / 2-1112 }
+ \PlaquePetitsCubes[cyan/red]{ 111 / -21 }
+ \PlaquePetitsCubes[cyan/red/green]{ 3-2 }
+\end{EmpilementCubes}
+\end{PresCode}
+
+\pagebreak
+
+\section{Création par \textit{hauteurs}}
+
+\subsection{Commande}
+
+\begin{tipblock}
+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.
+
+La commande qui permet de réaliser cet empilement est \texttt{\textbackslash BlocPetitsCubes}.
+\end{tipblock}
+
+\begin{PresCodeTex}{listing only}
+%création dans un environnement dédié
+\begin{EmpilementCubes}[échelle]<options tikz>
+ \BlocPetitsCubes*[couleur]{grille des hauteurs}
+\end{EmpilementCubes}
+\end{PresCodeTex}
+
+\begin{PresCodeTex}{listing only}
+%création autonome
+\BlocPetitsCubes[couleur]{grille des hauteurs}
+\end{PresCodeTex}
+
+\begin{cautionblock}
+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 !
+\end{cautionblock}
+
+\begin{importantblock}
+Voici une grille permettant d’anticiper la création d'un assemblage (en spécifiant les hauteurs) :
+
+\begin{center}
+ \begin{EnvTikzEspace}[UniteX={-22:1cm},UniteY={22:1cm}]
+ \foreach \x in {0,...,4} {\draw[semithick] (\x,-0.2,0)--++(0,5.4,0) ;}
+ \foreach \y in {0,...,5} {\draw[semithick] (-0.2,\y,0)--++(4.4,0,0) ;}
+ \foreach \y/\n in {0.5/1,1.5/2,2.5/3,3.5/4,4.5/5}
+ {\draw (0.5,\y,0) node[font=\small\sffamily] {\n} ;}
+ \foreach \y/\n in {0.5/0,1.5/2,2.5/1,3.5/1,4.5/3}
+ {\draw (1.5,\y,0) node[font=\small\sffamily] {\n} ;}
+ \foreach \y/\n in {0.5/0,1.5/2,2.5/1,3.5/1,4.5/2}
+ {\draw (2.5,\y,0) node[font=\small\sffamily] {\n} ;}
+ \foreach \y/\n in {0.5/1,1.5/1,2.5/1,3.5/1,4.5/1}
+ {\draw (3.5,\y,0) node[font=\small\sffamily] {\n} ;}
+ \end{EnvTikzEspace}
+\end{center}
+\end{importantblock}
+
+\subsection{Options et arguments}
+
+\begin{tipblock}
+Le premier argument, optionnel et entre \texttt{[...]} permet de spécifier une couleur (\texttt{cyan} par défaut).
+
+Le second argument, obligatoire et entre \texttt{\{...\}} est quant à lui la liste des hauteurs, comme présentée précédemment :
+
+\begin{itemize}
+ \item le caractère de séparation des \textit{plaques} est le \texttt{/} ;
+ \item pour chaque plaque, le caractère de séparation des colonnes est le \texttt{,}.
+\end{itemize}
+\vspace*{-\baselineskip}\leavevmode
+\end{tipblock}
+
+\begin{importantblock}
+Par exemple, la \textit{grille} associée à l'empilement précédent est :
+
+\smallskip
+
+\hfill\texttt{1,2,3,4,5 / 0,2,1,1,3 / 0,2,1,1,2 / 1,1,1,1,1}\hfill~
+\end{importantblock}
+
+\vfill~
+
+\begin{PresCode}{}
+\begin{EmpilementCubes}
+ \BlocPetitsCubes*{1,2,3,4,5}
+\end{EmpilementCubes}
+\end{PresCode}
+
+\begin{PresCode}{}
+%commande autonome, taille par défaut
+\BlocPetitsCubes{1,2,3,4,5 / 0,2,1,1,3 / 0,2,1,1,2 / 1,1,1,1,1}
+\end{PresCode}
+
+\begin{PresCode}{}
+\begin{EmpilementCubes}[2]
+ \BlocPetitsCubes*[violet]{1,2,3,4,5 / 0,2,1,1,3 / 0,2,1,1,2 / 1,1,1,1,1}
+\end{EmpilementCubes}
+\end{PresCode}
+
+\end{document} \ No newline at end of file