% !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.3}
\def\TPdate{16 septembre 2024}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{amsmath,amssymb}
\usepackage{tikz3d-fr}
\usepackage{awesomebox}
\usepackage{fontawesome5}
\usepackage{footnote}
\makesavenoteenv{tabular}
\usepackage{enumitem}
\usepackage{tabularray}
\UseTblrLibrary{diagbox}
\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}
	
	\def\listecouleursdes{red!25,blue!25,yellow!25,orange!25,green!25}\TirageAleaDesTriDim[EspaceH=-2mm]{5}
	\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

\pagebreak

\part{Historique}

\verb|v0.1.3|~:~~~~Affichage de dés en 3d (avec aléatoire possible)

\verb|v0.1.2|~:~~~~Option pour l'épaisseur des traits + \textsf{[line join=round]} pour les cubes

\verb|v0.1.1|~:~~~~Tracé des segments individuels avec l'option \textsf{[line cap=round]}

\verb|v0.1.0|~:~~~~Version initiale

\pagebreak

\part{Introduction}

\section{Le package tikz3d-fr}

\subsection{Introduction}

\begin{noteblock}
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 :

\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 ;
	\item des commandes pour représenter des dés en perspective (avec aléatoire possible).
\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é.
\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}, \texttt{tikz-3dplot} et \texttt{randomlist}  ;
	\item la librairie \texttt{\textit{tikz}.calc}.
\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} disponibles 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}
La commande \textit{simplifiée} et \textit{francisée} 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}[épaisseur traits]
	\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}

Le dernier argument, optionnel et entre \texttt{[...]} permet de spécifier une dimension pour les tracés (\texttt{0.2pt} par défaut).

\medskip

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 }[0.4pt]
	\PlaqueVide[2]
	%plaque n°2
	\PlaquePetitsCubes[cyan/red]{ 111- / -211  }[0.4pt]
	\PlaqueVide[2]
	%plaque n°3 (devant)
	\PlaquePetitsCubes{ 1111 / ---1 }[0.4pt]
\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 }[1pt]
	\PlaquePetitsCubes[cyan/red]{ 111 / -21 }[1pt]
	\PlaquePetitsCubes[cyan/red/green]{ 3-2 }[1pt]
\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}[epaisseur traits]
\end{EmpilementCubes}
\end{PresCodeTex}

\begin{PresCodeTex}{listing only}
%création autonome
\BlocPetitsCubes[couleur]{grille des hauteurs}[epaisseur traits]
\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}

Le dernier argument, optionnel et entre \texttt{[...]} permet de spécifier une dimension pour les tracés (\texttt{0.2pt} par défaut).
\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}[0.8pt]
\end{EmpilementCubes}
\end{PresCode}

\newpage

\part{Dés à jouer, en 3D}

\section{Fonctionnement global}

\begin{tipblock}
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.

\smallskip

La commande peut être autonome pour afficher dé par dé, mais elle peut être également à intégrer dans un environnement \texttt{tikzpicture}.
\end{tipblock}

\begin{importantblock}
Par défaut, les dés ont une hauteur proche de 1~cm (sans la perspective).

\smallskip

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).

\smallskip

Il est également possible de spécifier un \textit{angle de vue}, droite ou gauche.
\end{importantblock}


\begin{PresCodeTex}{listing only}
%affichage indépendant
\DeTriDim[clés]{numéro(s)}
\end{PresCodeTex}

\begin{PresCodeTex}{listing only}
%affichage dans un environnement
\begin{tikzpicture}
	\DeTriDim*[clés]{numéro(s)}
\end{tikzpicture}
\end{PresCodeTex}

\begin{PresCodeTex}{listing only}
%tirages aléatoires
\TirageAleaDesTriDim[clés]{tirages}
\end{PresCodeTex}

\begin{PresCode}{}
\DeTriDim{6/2}~\DeTriDim{1/5}~\DeTriDim{6/4}~\DeTriDim{3/2}
\end{PresCode}

\begin{PresCode}{}
\begin{tikzpicture}
	%\tdplotsetmaincoords{70}{110}
	\DeTriDim*[Echelle=2]{6/2}
	\DeTriDim*[Echelle=2,Origine={(2,-0.2)}]{6/5}
	\DeTriDim*[Echelle=2,Origine={(4,-0.4)},]{6/3}
	\DeTriDim*[Echelle=2,Origine={(6,-0.6)},Hasard]{}
\end{tikzpicture}
\end{PresCode}

\begin{PresCode}{}
\TirageAleaDesTriDim[Vue=G,Yams,Echelle=3,Couleurs={red!25,blue!25,yellow!25}]{3}
\end{PresCode}

\section{Influence des paramètres}

\subsection{Clés et options}

\begin{tipblock}
Quelques \Cle{clés} sont disponibles pour cette commande (elles ne sont pas toutes utilisées par les toutes les commandes) :

\begin{itemize}
	\item \Cle{Echelle} : échelle pour modifier la taille ;\hfill{}défaut \Cle{1}
	\item \Cle{Couleur} : couleur (individuelle) ;\hfill{}défaut \Cle{lightgray!25}
	\item \Cle{CouleurPoints} : couleurs des points ;\hfill{}défaut \Cle{black}
	\item \Cle{Phi} : angle $\phi$ de la perpective ;\hfill{}défaut \Cle{110}
	\item \Cle{Theta} : angle $\theta$ de la perpective ;\hfill{}défaut \Cle{70}
	\item \Cle{Vue} : vue de la perspective (\texttt{D/G}) ;\hfill{}défaut \Cle{D}
	\item \Cle{Hasard} : booléen pour un tirage aléatoire ;\hfill{}défaut \Cle{false}
	\item \Cle{Origine} : origine du dé pour la version \texttt{tikzpicture} ;
	\item en ce qui concerne les clés spécifiques au tirage :
	\begin{itemize}
		\item \Cle{EspaceH} : espace horizontal entre les dés ;\hfill{}défaut \Cle{0mm}
		\item \Cle{Couleurs} : liste des couleurs pour les dés ;\hfill{}défaut \Cle{lightgray!25}
		\item \Cle{Yams} : booléen pour forcer un affichage en ligne.\hfill{}défaut \Cle{false}
	\end{itemize}
\end{itemize}

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).
\end{tipblock}

\subsection{Exemples}

\begin{PresCode}{}
\TirageAleaDesTriDim[EspaceH=-2mm]{5}

\TirageAleaDesTriDim[EspaceH=1mm,Echelle=2,Couleurs=darkgray,CouleurPoints=white]{5}
\end{PresCode}

\begin{PresCode}{}
\def\listecouleursdes{red!25,blue!25,yellow!25,orange!25,green!25}

\TirageAleaDesTriDim[Yams,Couleurs=brown!10]{10}

\TirageAleaDesTriDim[Yams,Echelle=2,Couleurs=\listecouleursdes,CouleurPoints=magenta]{5}

\TirageAleaDesTriDim[Vue=G,Yams,Echelle=3,Couleurs=\listecouleursdes]{3}
\end{PresCode}

\subsection{Angles de rotation}

\begin{cautionblock}
Les paramètres $\theta$ et $\phi$ peuvent être modifiés, en fonction du rendu souhaité.

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}.
\end{cautionblock}

\begin{tipblock}
Vue \texttt{D} :

\begin{tblr}{hlines,vlines,colspec={*{5}{Q[m,c]}}}
	\diagbox{$\phi$}{$\theta$} & 60 & \textbf{70} & 80 & 85 \\
	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>{} \\
	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>{} \\
	\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>{} \\
	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>{} \\
\end{tblr}
\end{tipblock}

\begin{tipblock}
Vue \texttt{G} :

\begin{tblr}{hlines,vlines,colspec={*{5}{Q[m,c]}}}
	\diagbox{$\phi$}{$\theta$} & 60 & \textbf{70} & 80 & 85 \\
	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>{} \\
	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>{} \\
	\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>{} \\
	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>{} \\
\end{tblr}
\end{tipblock}


\end{document}