Debian Codegraph @

texmf-dist/doc/latex/pixelarttikz/PixelArtTikz-doc-fr.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{article}
6 \usepackage[utf8]{inputenc}
7 \usepackage[T1]{fontenc}
8 %\usepackage[table,svgnames]{xcolor}
9 \usepackage{amsmath,amssymb}
10 \usepackage{PixelArtTikz}
11 \usepackage{couleurs-fr}
12 \usepackage{fontawesome5}
13 \usepackage{enumitem}
14 \usepackage{tabularray}
15 \usepackage{multicol}
16 \usepackage{fancyvrb}
17 \usepackage{fancyhdr}
18 \fancyhf{}
19 \renewcommand{\headrulewidth}{0pt}
20 \lfoot{\sffamily\small [PixelArtTikz]}
21 \cfoot{\sffamily\small - \thepage{} -}
22 \rfoot{\hyperlink{matoc}{\small\faArrowAltCircleUp[regular]}}
23
24 \usepackage{hologo}
25 \providecommand\tikzlogo{Ti\textit{k}Z}
26 \providecommand\TeXLive{\TeX{}Live\xspace}
27 \providecommand\PSTricks{\textsf{PSTricks}\xspace}
28 \let\pstricks\PSTricks
29 \let\TikZ\tikzlogo
30 \newcommand\TableauDocumentation{%
31 \begin{tblr}{width=\linewidth,colspec={X[c]X[c]X[c]X[c]X[c]X[c]},cells={font=\sffamily}}
32 {\huge \LaTeX} & & & & &\\
33 & {\huge \hologo{pdfLaTeX}} & & & & \\
34 & & {\huge \hologo{LuaLaTeX}} & & & \\
35 & & & {\huge \TikZ} & & \\
36 & & & & {\huge \TeXLive} & \\
37 & & & & & {\huge \hologo{MiKTeX}} \\
38 \end{tblr}
39 }
40
41 \usepackage{hyperref}
42 \urlstyle{same}
43 \hypersetup{pdfborder=0 0 0}
44 \usepackage[margin=1.5cm]{geometry}
45 \setlength{\parindent}{0pt}
46
47 \def\TPversion{0.20a}
48 \def\TPdate{07 décembre 2025}
49
50 \usepackage{minted2}
51 \usepackage[most]{tcolorbox}
52 \tcbuselibrary{minted}
53 \NewTCBListing{PresentationCode}{ O{blue} m }{%
54 sharp corners=downhill,enhanced,arc=12pt,skin=bicolor,%
55 colback=#1!1!white,colframe=#1!75!black,colbacklower=white,%
56 attach boxed title to top right={yshift=-\tcboxedtitleheight},title=Code \LaTeX,%
57 boxed title style={%
58 colframe=#1!75!black,colback=#1!15!white,%
59 ,sharp corners=downhill,arc=12pt,%
60 },%
61 fonttitle=\color{#1!90!black}\itshape\ttfamily\footnotesize,%
62 listing engine=minted,minted style=colorful,
63 minted language=tex,minted options={tabsize=4,fontsize=\footnotesize,autogobble},
64 #2
65 }
66
67 \usepackage[french]{babel}
68
69 \newcommand\Cle[1]{{\bfseries\sffamily\textlangle #1\textrangle}}
70
71 \begin{document}
72
73 \pagestyle{fancy}
74
75 \thispagestyle{empty}
76
77 \vspace{2cm}
78
79 \begin{center}
80 \begin{minipage}{0.75\linewidth}
81 \begin{tcolorbox}[colframe=yellow,colback=yellow!15]
82 \begin{center}
83 \begin{tabular}{c}
84 {\Huge \texttt{PixelArtTikz [fr]}}\\
85 \\
86 {\LARGE Des PixelArts, en Ti\textit{k}Z}, \\
87 \\
88 {\LARGE avec solution et couleurs.} \\
89 \end{tabular}
90
91 \medskip
92
93 {\small \texttt{Version \TPversion{} -- \TPdate}}
94 \end{center}
95 \end{tcolorbox}
96 \end{minipage}
97 \end{center}
98
99 \vspace{0.5cm}
100
101 \begin{center}
102 \begin{tabular}{c}
103 \texttt{Cédric Pierquet}\\
104 {\ttfamily c pierquet -- at -- outlook . fr}\\
105 \texttt{\url{https://github.com/cpierquet/latex-packages/tree/main/pixelarttikz}}
106 \end{tabular}
107 \end{center}
108
109 \vspace{0.25cm}
110
111 {$\blacktriangleright$~~Des commandes pour afficher des PixelArts.}
112
113 \smallskip
114
115 {$\blacktriangleright$~~Des commandes pour découper des PixelArts en plusieurs parties.}
116
117 \smallskip
118
119 {$\blacktriangleright$~~Environnement pour compléter éventuellement le PixelArt.}
120
121 \smallskip
122
123 {$\blacktriangleright$~~Des PixelArts avec anamorphose cylindrique, des \textit{mini-}PixelArts.}
124
125 \smallskip
126
127 \vspace{1cm}
128
129 \begin{center}
130 \begin{filecontents*}[overwrite]{test1.csv}
131 -,-,-,-,-,-,4,4,4,4,-,-,-,-,-,-
132 -,-,-,-,4,4,1,1,1,1,4,4,-,-,-,-
133 -,-,-,4,1,1,1,1,1,1,1,1,4,-,-,-
134 -,-,4,1,1,1,1,1,1,1,1,1,1,4,-,-
135 -,-,4,1,1,1,1,1,1,1,1,1,1,4,-,-
136 -,4,1,9,9,1,1,1,1,1,1,9,9,1,4,-
137 -,4,9,9,9,9,4,4,4,4,9,9,9,9,4,-
138 -,4,9,4,9,9,4,4,4,4,9,4,9,9,4,-
139 -,4,1,9,9,9,4,4,4,4,9,9,9,1,4,-
140 -,-,4,1,1,9,4,4,4,4,9,1,1,4,-,-
141 -,-,4,1,1,1,4,4,4,4,1,1,1,4,-,-
142 -,-,-,4,1,1,1,4,4,1,1,1,4,-,-,-
143 -,-,4,3,1,1,1,1,1,1,1,1,3,4,-,-
144 -,4,6,3,1,1,1,1,1,1,1,1,3,6,4,-
145 -,4,6,6,1,1,1,1,1,1,1,1,6,6,4,-
146 -,4,6,6,1,1,1,1,1,1,1,1,6,6,4,-
147 -,4,6,4,1,1,1,4,4,1,1,1,4,6,4,-
148 2,2,4,2,4,4,4,2,2,4,4,4,2,4,2,2
149 2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2
150 2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2
151 -,-,-,-,-,4,1,1,1,1,4,-,-,-,-,-
152 -,-,-,-,-,-,4,1,1,4,-,-,-,-,-,-
153 -,-,-,-,-,-,-,4,4,-,-,-,-,-,-,-
154 \end{filecontents*}
155
156 \PixelArtTikz[Codes=123469,Style=\ttfamily,Unite=0.35]{test1.csv}
157 ~~
158 \PixelArtTikz[Codes=123469,Symboles={A,B,C,D,E,F},Symb,Style=\ttfamily,Unite=0.35]{test1.csv}
159 ~~
160 \PixelArtTikz[Codes=123469,Couleurs={red,brown,yellow,black,blue,white},Correction,Unite=0.35]{test1.csv}
161 \end{center}
162
163 \vspace{0.5cm}
164
165 \vfill
166
167 \hrule
168
169 \medskip
170
171 \TableauDocumentation
172
173 \medskip
174
175 \hrule
176
177 \medskip
178
179 \newpage
180
181 \phantomsection
182 \hypertarget{matoc}{}
183
184 \tableofcontents
185
186 \newpage
187
188 \part{Introduction}
189
190 \section{Le package PixelArtTikz}
191
192 \subsection{Introduction}
193
194 L'idée est de \textit{proposer}, dans un environnement Ti\textit{k}Z, une commande permettant de générer des grilles PixelArt.
195
196 Les données sont \textit{lues} à partir d'un fichier \textsf{csv}, externe au fichier \textsf{tex} ou déclaré en interne grâce à l'environnement \texttt{filecontents}.
197
198 \medskip
199
200 Avant toute chose, quelques petites infos sur les données au format \textsf{csv}, surtout dans l'optique de sa lecture et de son traitement par les commandes :
201
202 \begin{itemize}
203 \item le fichier de données \textsf{csv} doit être formaté avec le séparateur décimal \og , \fg ;
204 \item des cases vides seront codées par \og \texttt{-} \fg.
205 \end{itemize}
206
207 Le fichier \textsf{csv} peut être déclaré directement dans le fichier \textsf{tex}, grâce à l'environnement \textsf{filecontents} (intégré en natif sur les dernières versions de \LaTeX) :
208
209 \begin{PresentationCode}{listing only}
210 \begin{filecontents*}{nomfichier.csv}
211 A,B,C,D
212 A,B,D,C
213 B,A,C,D
214 B,A,D,C
215 \end{filecontents*}
216 \end{PresentationCode}
217
218 À la compilation, le fichier \textsf{nomfichier.csv} sera créé automatiquement, et l'option \Cle{[overwrite]} permet (logiquement) de propager les modifications au fichier \textsf{csv}.
219
220 \subsection{Chargement du package, et option}
221
222 Le package \textit{central} est ici \textsf{csvsimple}, qui permet de lire et traiter le fichier \textsf{csv}.
223
224 Il est \og disponible \fg{} en version \hologo{LaTeX2e} ou en version \hologo{LaTeX3}. Par défaut, \textsf{PixelArtTikz} le charge en version \hologo{LaTeX3}, mais une \textsf{option} est disponible pour une \textit{rétro-compatibilité} avec la version \hologo{LaTeX2e}.
225
226 \smallskip
227
228 L'option \Cle{[csvii]} permet de passer l'appel au package en version \hologo{LaTeX2e}.
229
230 \begin{PresentationCode}{listing only}
231 \usepackage{PixelArtTikz} %chargement du package version 3
232 %qui charge :
233 %\RequirePackage{expl3}
234 %\RequirePackage[l3]{csvsimple}
235
236 \usepackage[csvii]{PixelArtTikz} %chargement du package version 2
237 %qui charge :
238 %\RequirePackage[legacy]{csvsimple}
239 \end{PresentationCode}
240
241 À noter qu'une version alternative \textit{simple}, avec le package \textsf{datatool}, est également disponible.
242
243 \subsection{Packages utilisés}
244
245 Le package est compatible avec les compilations usuelles en \textsf{latex}, \textsf{pdflatex}, \textsf{lualatex} ou \textsf{xelatex}.
246
247 \medskip
248
249 Il charge les packages et librairies suivantes :
250
251 \begin{itemize}
252 \item \texttt{tikz}, \texttt{xintexpr} et \texttt{xinttools};
253 \item \texttt{xstring}, \texttt{simplekv} et \texttt{listofitems} ;
254 \item \texttt{multicol} (pour le \textit{découpage}).
255 \end{itemize}
256
257 \pagebreak
258
259 \subsection{Commandes et environnement}
260
261 Il existe trois manières de représenter un PixelArt :
262
263 \begin{itemize}
264 \item soit par une commande autonome et indépendante ;
265 \item soit par un environnement Ti\textit{k}Z dans lequel du code pourra être \textit{rajouté} ;
266 \item soit par \textit{découpage} de la grille en plusieurs (travail collaboratif).
267 \end{itemize}
268
269 \begin{PresentationCode}{listing only}
270 %Commande autonome
271 \PixelArtTikz[clés]<options tikz>{fichier.csv}
272
273 %Commande semi-autonome, à intégrer dans un environnement tikz
274 \PixelArtTikz*[clés]{fichier.csv}
275
276 %environnement
277 \begin{EnvPixelArtTikz}[clés]<options tikz>{fichier.csv}
278 %code tikz
279 \end{EnvPixelArtTikz}
280 \end{PresentationCode}
281
282 \begin{PresentationCode}{listing only}
283 %Affichage d'un bloc précis (si découpage)
284 \PixelArtTikzBloc[clés]<options tikz>{fichier.csv}{découpage}{num bloc}
285
286 %Affichage des blocs (si découpage)
287 \DecoupPixelArtTikz(*)[clés]<options tikz>{fichier.csv}{découpage}
288
289 %Affichage d'une 'aide'
290 \AideGrillePixelArtTikz(*)[Echelle]{fichier.csv}{découpage}
291 \end{PresentationCode}
292
293 \section{Compléments}
294
295 \subsection{Les couleurs}
296
297 Concernant les couleurs, l'utilisateur utilisera celles disponibles avec les packages chargés.
298
299 %\smallskip
300
301 %La présente documentation a été compilée avec le package \textsf{xcolor}, chargé avec les options \Cle{[table,svgnames]}.
302
303 \smallskip
304
305 Les couleurs disponibles sans autre package sont donc :
306
307 \smallskip
308
309 \begin{tblr}{width=\linewidth,colspec={*{10}{X[m,c]}},cells={font=\small\ttfamily}}
310 \SetCell{bg=magenta} magenta &
311 \SetCell{bg=cyan} cyan &
312 \SetCell{bg=blue,fg=white} blue &
313 \SetCell{bg=green} green &
314 \SetCell{bg=red} red &
315 \SetCell{bg=darkgray,fg=white} darkgray &
316 \SetCell{bg=olive,fg=white} olive &
317 \SetCell{bg=lime} lime &
318 \SetCell{bg=brown} brown &
319 \SetCell{bg=lightgray} lightgray \\
320 \SetCell{bg=white} white &
321 \SetCell{bg=gray,fg=white} gray &
322 \SetCell{bg=black,fg=white} black &
323 \SetCell{bg=yellow} yellow &
324 \SetCell{bg=violet,fg=white} violet &
325 \SetCell{bg=teal,fg=white} teal &
326 \SetCell{bg=purple,fg=white} purple &
327 \SetCell{bg=pink} pink &
328 \SetCell{bg=orange} orange & \\
329 \end{tblr}
330
331 \smallskip
332
333 Pour des couleurs \textit{francisées}, le package \texttt{couleurs-fr} pourra être utile.
334
335 \subsection{Petit aparté sur les fichiers csv}
336
337 \textsf{CSV} désigne un format de fichiers dont le rôle est de présenter des données séparées par des virgules. Il s'agit d'une manière simplifiée d'afficher des données afin de les rendre transmissibles d'un programme à un autre.
338
339 \smallskip
340
341 Dans notre cas, le fichier \textsf{csv} contiendra les \textit{codes} qui seront analysés un par un et ligne par ligne pour avoir le rendu par \textit{code}, \textit{symbole} ou \textit{couleur}.
342
343 \medskip
344
345 Il \underline{doit} être préparé avec des caractères (codes) \textit{simples} pour que le code de \textsf{PixelArtTikz} puisse fonctionner.
346
347 \pagebreak
348
349 \part{Commandes principales}
350
351 \section{La commande principale}
352
353 \subsection{Exemple introductif}
354
355 La commande \texttt{\textbackslash PixelArtTikz} nécessite de connaître :
356
357 \begin{itemize}
358 \item le fichier \textsf{csv} à traiter ;
359 \item la liste (en fait sous forme de chaîne) des codes utilisés dans le fichier \textsf{csv} (comme \texttt{234679} ou \texttt{ABCDJK}\ldots);
360 \item la liste des symboles (éventuellement !) à afficher dans les cases s'il y a ambiguïté, comme \texttt{25,44,12} ou \texttt{AA,AB,AC};
361 \item la liste des couleurs (si la correction est demandée), dans le même ordre que la liste des caractères.
362 \end{itemize}
363
364 On peut donc commencer par créer le fichier \textsf{csv} qui sera lu et interprété par les commandes du package. Le fichier peut-être créé directement dans la code du fichier \textsf{tex}.
365
366 \begin{PresentationCode}{}
367 %déclaration du fichier csv
368 \begin{filecontents*}[overwrite]{base.csv}
369 A,B,C,D
370 A,B,D,C
371 B,A,D,C
372 C,A,B,D
373 \end{filecontents*}
374 \end{PresentationCode}
375
376 \begin{PresentationCode}{}
377 %notice et PixelArt
378 \begin{center}
379 \begin{tblr}{colspec={*{4}{Q[1.25cm,c,m]}},hlines,vlines,rows={1.15em}}
380 \SetCell[c=4]{c} Notice & & & \\
381 A & B & C & D \\
382 45 & 22 & 1 & 7 \\
383 Noir & Vert & Jaune & Rouge \\
384 \end{tblr}
385 \end{center}
386
387 \PixelArtTikz[Codes=ABCD,Style=\large\sffamily,Unite=0.85]{base.csv}
388 ~~
389 \PixelArtTikz[Codes=ABCD,Symboles={45,22,1,7},Symb,Style=\large\sffamily,Unite=0.85]{base.csv}
390 ~~
391 \PixelArtTikz[Codes=ABCD,Couleurs={black,green,yellow,red},Correction,Unite=0.85]{base.csv}
392 ~~
393 \PixelArtTikz[Codes=ABCD,Couleurs={black,green,yellow,red},Correction,BordCases=false,Unite=0.85]{base.csv}
394 \end{PresentationCode}
395
396 \pagebreak
397
398 \subsection{Clés et options}
399
400 \begin{PresentationCode}{listing only}
401 \PixelArtTikz[clés]<options tikz>{fichier.csv}
402 \end{PresentationCode}
403
404 Le premier argument, \textit{optionnel} et entre \texttt{[...]} propose des \textsf{Clés} nécessaires au bon fonctionnement de la commande :
405
406 \begin{itemize}
407 \item la clé \Cle{Codes} contient la \textit{chaîne} des codes \textit{simples} du fichier \textsf{csv} ;
408 \item la clé \Cle{Couleurs} qui contient la \textit{liste} des couleurs associées ;
409 \item la clé \Cle{Symboles} qui contient la \textit{liste éventuelles} des caractères alternatifs à afficher dans les cases ;
410 \item la clé booléenne \Cle{Correction} qui permet de colorier le PixelArt ;\hfill{}défaut \textsf{false}
411 \item la clé booléenne \Cle{Symb} qui permet d'afficher les caractères \textit{alternatifs} ;\hfill{}défaut \textsf{false}
412 \item la clé booléenne \Cle{BordCases} qui permet d'afficher les bords des cases de la correction ;\hfill{}défaut \textsf{true}
413 \item la clé \Cle{Decoupage} pour afficher des lignes de découpage éventuel :
414 \begin{itemize}
415 \item sous la forme \Cle{<nb lig bloc>x<nb col bloc>} pour spécifier la dimension des blocs ;
416 \item sous la forme \Cle{<nb blocs V>+<nb blocs H>} pour spécifier le nombre de blocs ;
417 \end{itemize}
418 \item la clé \Cle{Style} qui permet de spécifier le style des caractères. \hfill{}défaut \textsf{scriptsize}
419 \end{itemize}
420
421 Le second argument, \textit{optionnel} et entre \texttt{<...>} sont des options -- en langage Ti\textit{k}Z -- à passer à l'environnement qui sert de base au PixelArt.
422
423 \medskip
424
425 Le troisième argument, \textit{obligatoire}, est le nom du fichier \textsf{csv} à utiliser.
426
427 \vspace{1cm}
428
429 On rappelle que le fichier peut être créé au préalable, et placé dans le répertoire du fichier, ou bien il peut être créé \textit{en direct}, à l'aide du package \textsf{filecontents} (chargé par \LaTeX).
430
431 \begin{PresentationCode}{}
432 %création du fichier csv
433 \begin{filecontents*}[overwrite]{test1.csv}
434 -,-,-,-,-,-,4,4,4,4,-,-,-,-,-,-
435 -,-,-,-,4,4,1,1,1,1,4,4,-,-,-,-
436 -,-,-,4,1,1,1,1,1,1,1,1,4,-,-,-
437 -,-,4,1,1,1,1,1,1,1,1,1,1,4,-,-
438 -,-,4,1,1,1,1,1,1,1,1,1,1,4,-,-
439 -,4,1,9,9,1,1,1,1,1,1,9,9,1,4,-
440 -,4,9,9,9,9,4,4,4,4,9,9,9,9,4,-
441 -,4,9,4,9,9,4,4,4,4,9,4,9,9,4,-
442 -,4,1,9,9,9,4,4,4,4,9,9,9,1,4,-
443 -,-,4,1,1,9,4,4,4,4,9,1,1,4,-,-
444 -,-,4,1,1,1,4,4,4,4,1,1,1,4,-,-
445 -,-,-,4,1,1,1,4,4,1,1,1,4,-,-,-
446 -,-,4,3,1,1,1,1,1,1,1,1,3,4,-,-
447 -,4,6,3,1,1,1,1,1,1,1,1,3,6,4,-
448 -,4,6,6,1,1,1,1,1,1,1,1,6,6,4,-
449 -,4,6,6,1,1,1,1,1,1,1,1,6,6,4,-
450 -,4,6,4,1,1,1,4,4,1,1,1,4,6,4,-
451 2,2,4,2,4,4,4,2,2,4,4,4,2,4,2,2
452 2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2
453 2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2
454 -,-,-,-,-,4,1,1,1,1,4,-,-,-,-,-
455 -,-,-,-,-,-,4,1,1,4,-,-,-,-,-,-
456 -,-,-,-,-,-,-,4,4,-,-,-,-,-,-,-
457 \end{filecontents*}
458 \end{PresentationCode}
459
460 \begin{PresentationCode}{}
461 %codes simples et sans ambiguïté
462 %une case vide sera codée par -
463 \PixelArtTikz[Codes=123469,Style=\ttfamily,Unite=0.35]{test1.csv}
464 ~~
465 \PixelArtTikz[Codes=123469,Couleurs={red,brown,yellow,black,blue,white},Correction,Unite=0.35]{test1.csv}
466 ~~
467 \PixelArtTikz[Codes=123469,Couleurs={red,brown,yellow,black,blue,white},Correction,Unite=0.35,BordCases=false]%
468 {test1.csv}
469 \end{PresentationCode}
470
471 \pagebreak
472
473 Dans l'exemple suivant, les \textit{symboles} à afficher ne peuvent pas servir de \textit{codes}, donc on utilise les options liées à \Cle{Symboles} pour s'affranchir de cette limitation.
474
475 \begin{PresentationCode}{}
476 %codes à afficher, avec utiliser des symboles
477
478 \begin{filecontents*}[overwrite]{cap.csv}
479 -,-,-,-,-,-,-,-,D,-,D,-,D,-,-,-,-,-,-,-,-,-
480 -,D,D,-,-,-,-,D,D,D,D,D,D,-,-,D,D,D,D,-,-,-
481 D,-,-,D,-,D,D,F,F,F,F,F,F,D,D,-,-,-,-,D,-,-
482 -,D,-,-,D,F,F,F,-,-,F,F,F,F,F,D,-,D,D,-,-,-
483 -,-,D,D,F,F,F,-,F,F,-,F,F,F,F,F,D,D,-,-,-,-
484 -,-,-,D,F,F,F,F,F,F,F,F,F,F,F,F,D,-,-,-,-,-
485 -,-,-,D,F,J,J,J,J,J,J,J,F,F,F,F,D,-,-,-,-,-
486 -,-,-,D,J,-,-,-,J,-,-,-,J,J,F,F,D,-,-,-,-,-
487 -,-,-,D,J,-,D,-,J,-,D,-,J,J,B,B,D,-,-,-,-,-
488 -,-,-,D,J,-,-,-,J,-,-,-,J,J,B,B,D,-,-,-,-,-
489 -,-,-,D,C,J,J,J,J,J,J,J,J,C,C,C,D,-,-,-,-,-
490 -,-,-,D,C,C,C,C,C,C,C,C,C,C,C,D,D,D,-,-,-,-
491 -,-,-,D,C,C,C,D,D,D,D,D,D,C,D,A,A,A,D,-,-,-
492 -,-,-,D,F,C,C,C,C,C,C,C,C,D,A,-,-,-,A,D,-,-
493 -,-,-,D,F,C,F,C,C,C,C,F,D,A,-,A,A,A,-,A,D,-
494 -,-,D,C,F,F,F,F,C,C,F,D,A,-,A,F,F,F,A,-,A,D
495 -,-,D,C,F,F,F,F,F,F,F,D,A,-,A,F,-,F,A,-,A,D
496 -,-,D,A,D,-,A,-,A,-,A,D,A,-,A,F,F,F,A,-,A,D
497 -,-,-,D,D,-,A,-,A,-,A,-,D,A,-,A,A,A,-,A,D,-
498 -,-,-,-,-,D,D,F,D,D,D,D,F,D,A,-,-,-,A,D,-,-
499 -,-,-,-,-,-,D,A,D,-,-,D,-,-,D,A,A,A,D,-,-,-
500 -,-,-,-,-,-,D,D,D,-,-,D,D,D,D,D,D,D,-,-,-,-
501 \end{filecontents*}
502
503 \PixelArtTikz[Codes=ABCDFJ,Symboles={1,2,3,4,6,10},Symb,Style=\tiny\sffamily,Unite=0.35]{cap.csv}
504 ~~
505 \PixelArtTikz[Codes=ABCDFJ,Couleurs={red,brown,yellow,black,blue,gray},Correction,Unite=0.35]{cap.csv}
506 \end{PresentationCode}
507
508 \pagebreak
509
510 \subsection{Symboles dans une liste}
511
512 À noter qu'il est possible de donner comme symboles des listes dans lesquelles seront choisies aléatoirement les symboles.
513
514 \begin{PresentationCode}{}
515 %codes à afficher, avec utiliser des symboles "alétaoires" dans une liste
516
517 \begin{filecontents*}[overwrite]{testlist.csv}
518 A,B,C,A
519 A,B,B,C
520 B,A,C,B
521 C,A,B,C
522 \end{filecontents*}
523
524 \textbf{Notice : }
525
526 Multiples de 5 : Rouge\\
527 Multiples de 3 : Vert\\
528 Multiples de 2 : Bleu
529
530 \PixelArtTikz[Codes=ABC,Symboles={5§25§35,3§9§21§27,2§4§8§14§16},Symb,Style=\large\sffamily,Unite=0.85]{testlist.csv}
531 \hspace{5mm}
532 \PixelArtTikz[Codes=ABC,Symboles={5§25§35,3§9§21§27,2§4§8§14§16},Symb,Style=\large\sffamily,Unite=0.85]{testlist.csv}
533 \hspace{5mm}
534 \PixelArtTikz[Codes=ABC,Couleurs={red,green,blue},Correction,Style=\large\sffamily,Unite=0.85]{testlist.csv}
535 \end{PresentationCode}
536
537 \pagebreak
538
539 \subsection{Commande étoilée}
540
541 La commande \textit{étoilée} \texttt{\textbackslash PixelArtTikz*} permet d'intégrer le PixelArt dans un environnement créé par l'utilisateur. Cela permet par exemple de pouvoir rajouter du code en parallèle du PixelArt.
542
543 \smallskip
544
545 Il est à noter que, dans ce cas :
546
547 \begin{itemize}
548 \item l'argument \textit{optionnel} entre \texttt{<...>} est inutile ;
549 \item la clé \Cle{Unite} n'intervient plus dans le tracé (elle peut être passée directement dans l'environnement !)
550 \end{itemize}
551
552 \begin{PresentationCode}{}
553 \begin{center}
554 \begin{tikzpicture}[scale=0.5]
555 %grille pour visualiser le positionnement
556 \draw[very thin,gray,xstep=1,ystep=1] (0,0) grid (17,-24) ;
557 \foreach \x in {0,1,...,17} \draw[very thin,gray] (\x,-3pt)--(\x,3pt)%
558 node[above,font=\scriptsize\sffamily] {\x} ;
559 \foreach \y in {0,-1,...,-24} \draw[very thin,gray] (3pt,\y)--(-3pt,\y)%
560 node[left,font=\scriptsize\sffamily] {\y} ;
561 %le PixelArt
562 \PixelArtTikz*[Codes=123469,Couleurs={red,brown,yellow,black,blue,white},Correction]{test1.csv}
563 %du code rajouté
564 \filldraw[blue] (14,-1) circle[radius=1] ;
565 \filldraw[yellow] (14,-1) circle[radius=0.8] ;
566 \draw[green,very thick,<-,>=latex] (15,-1) to[bend left=30] (18,-2)%
567 node[right,font=\scriptsize\sffamily] {rajouté en Ti\textit{k}Z} ;
568 \end{tikzpicture}
569 \end{center}
570 \end{PresentationCode}
571
572 \pagebreak
573
574 \section{Environnement PixelArt}
575
576 \subsection{Commande et options}
577
578 Le package \textsf{PixelArtTikz} propose également un environnement pour créer un PixelArt, et pouvoir rajouter des éléments en marge du PixelArt.
579
580 \begin{itemize}
581 \item L'environnement est créé autour de Ti\textit{k}Z et le code rajouté le sera dans un langage Ti\textit{k}Z !
582 \item Le code rajouté le sera, dans ce cas, \textit{au-dessus} du PixelArt !
583 \end{itemize}
584
585 Le fonctionnement global est le même que pour la commande autonome.
586
587 \begin{PresentationCode}{listing only}
588 \begin{EnvPixelArtTikz}[clés]<options tikz>{fichier.csv}
589 %code(s) tikz qui seront au-dessus du PixelArt
590 \end{EnvPixelArtTikz}
591 \end{PresentationCode}
592
593 Le premier argument, \textit{optionnel} et entre \texttt{[...]} propose des \textsf{Clés} nécessaires au bon fonctionnement de la commande :
594
595 \begin{itemize}
596 \item la clé \Cle{Codes} contient la \textit{chaîne} des codes \textit{simples} du fichier \textsf{csv} ;
597 \item la clé \Cle{Couleurs} qui contient la \textit{liste} des couleurs associées ;
598 \item la clé \Cle{Symboles} qui contient la \textit{liste éventuelles} des caractères alternatifs à afficher dans les cases ;
599 \item la clé booléenne \Cle{Correction} qui permet de colorier le PixelArt ;\hfill{}défaut \textsf{false}
600 \item la clé booléenne \Cle{Symb} qui permet d'afficher les caractères \textit{alternatifs} ;\hfill{}défaut \textsf{false}
601 \item la clé booléenne \Cle{BordCases} qui permet d'afficher les bords des cases de la correction ;\hfill{}défaut \textsf{true}
602 \item la clé \Cle{Style} qui permet de spécifier le style des caractères. \hfill{}défaut \textsf{scriptsize}
603 \end{itemize}
604
605 Le second argument, \textit{optionnel} et entre \texttt{<...>} sont des options -- en langage Ti\textit{k}Z -- à passer à l'environnement qui sert de base au PixelArt.
606
607 \medskip
608
609 Le troisième argument, \textit{obligatoire}, est le nom du fichier \textsf{csv} à utiliser.
610
611 \subsection{Exemple}
612
613 Les symboles affichés dans les cases sont situés aux nœuds de coordonnées $(c\,;\,-l)$ où $l$ et $c$ sont les numéros de ligne et de colonne correspondants à la position de la donnée dans le fichier \textsf{csv}.
614
615 \begin{PresentationCode}{}
616 \begin{center}
617 \begin{EnvPixelArtTikz}%
618 [Codes=123469,Couleurs={red,brown,yellow,black,blue,white},Correction,Unite=0.25]
619 {test1.csv}
620 \filldraw[blue] (14,-1) circle[radius=1] ;
621 \filldraw[yellow] (14,-1) circle[radius=0.8] ;
622 \draw[green,very thick,<-,>=latex] (15,-1) to[bend left=30] (18,-2)%
623 node[right,font=\scriptsize\sffamily] {rajouté en Ti\textit{k}Z} ;
624 \end{EnvPixelArtTikz}
625 \end{center}
626 \end{PresentationCode}
627
628 \newpage
629
630 \section{La commande pour découper}
631
632 \subsection{Idée et fonctionnement global}
633
634 L'idée est de proposer unes commandes pour créer des PixelArts \textit{collaboratifs}, pour former une \textit{grande} image à partir de plusieurs petites (de même taille).
635
636 \smallskip
637
638 {\footnotesize\faBomb} Pour des raisons pratiques (liées à l'utilisation de \texttt{filecontents}) le fichier \textsf{csv} doit finir par une ligne vide (elle est créée automatiquement via \texttt{filecontents}, et le code utilise cette spécificité).
639
640 \smallskip
641
642 Les \Cle{clés} disponibles sont exactement les mêmes que celles des affichages classiques.
643
644 \smallskip
645
646 L'exemple qui illustre cet aspect est issu d'un travail de Cyril IakoNelly, et représente un koala, dont le fichier \textsf{csv} a une taille 40×40 (ce qui permet un découpage \textit{facile}).
647
648 \begin{filecontents*}[overwrite]{PAkoala.csv}
649 A,A,A,A,A,A,A,H,H,H,A,A,A,A,A,H,H,H,A,A,A,A,A,A,A,A,A,H,H,H,H,A,A,H,A,A,A,A,A,A
650 A,A,A,A,A,A,A,A,H,A,A,A,A,A,A,H,H,A,A,A,A,A,A,A,A,A,A,H,A,A,A,A,A,H,A,A,A,A,A,A
651 A,A,A,H,A,A,A,A,A,A,A,A,A,A,A,H,H,A,A,A,A,A,A,A,A,H,H,H,A,A,A,A,A,A,A,A,A,A,A,A
652 A,A,A,A,A,A,A,B,E,E,E,E,A,A,A,A,A,A,A,A,A,A,A,H,H,H,A,B,B,E,E,E,E,B,A,A,A,A,A,H
653 A,A,H,A,A,A,A,B,E,E,E,E,E,A,A,A,A,A,A,A,A,A,A,H,H,H,B,E,E,E,E,E,E,B,B,A,A,A,A,H
654 A,A,H,A,A,B,B,E,C,C,C,C,C,E,B,B,B,E,E,E,E,E,E,B,B,B,E,C,C,C,C,C,C,E,B,B,H,H,A,A
655 A,A,H,A,B,E,D,D,D,D,B,D,C,C,E,E,E,E,C,C,C,C,E,E,E,E,E,C,D,B,B,D,D,D,E,B,H,A,A,A
656 A,A,A,A,B,E,D,D,F,F,D,B,D,C,C,E,C,C,C,C,C,C,C,C,E,C,C,D,B,D,D,F,F,D,E,B,A,A,A,H
657 A,A,A,B,C,D,D,F,F,F,D,D,B,B,C,C,C,C,C,C,C,C,C,C,C,C,C,B,D,D,D,F,F,D,D,C,B,A,H,H
658 A,A,A,B,C,D,F,F,F,F,F,D,D,D,C,C,C,C,C,C,C,C,C,C,C,C,C,D,D,F,F,F,F,F,D,C,B,A,H,H
659 A,A,A,B,D,D,F,F,F,F,F,D,C,C,C,C,C,C,C,C,C,C,C,C,C,C,C,C,D,F,F,F,F,F,D,D,B,A,A,H
660 A,A,A,B,D,D,G,F,F,F,F,D,C,C,B,B,B,C,C,B,B,C,C,B,B,B,C,C,D,F,F,F,F,G,D,D,B,A,A,A
661 A,A,A,A,B,G,G,F,F,F,F,D,C,C,B,F,B,C,B,D,D,B,C,B,F,B,C,C,D,G,F,F,F,G,G,B,H,A,A,A
662 A,A,A,A,A,B,G,G,G,F,G,D,C,C,C,B,B,C,B,D,D,B,C,B,B,C,C,C,D,G,G,F,G,G,B,H,H,H,A,A
663 A,A,A,A,A,A,B,G,G,G,G,B,C,C,C,C,C,C,B,B,B,B,C,C,C,C,C,C,D,B,G,G,G,G,B,H,H,H,A,A
664 A,A,A,A,A,A,A,B,B,B,B,B,C,C,C,C,C,C,B,B,B,B,C,C,C,C,C,C,D,B,B,B,B,B,A,A,H,H,A,A
665 A,A,A,A,A,A,A,A,A,A,A,D,D,C,C,C,C,F,B,B,B,B,F,C,C,C,C,D,D,A,A,A,A,A,A,A,A,A,A,A
666 A,A,A,A,A,A,A,A,A,A,A,B,D,D,C,C,C,F,F,B,B,F,F,C,C,C,D,D,B,A,A,A,A,A,A,A,A,A,A,A
667 A,A,A,A,A,H,H,H,A,A,A,A,B,B,D,C,C,F,F,F,F,F,F,C,C,D,B,B,A,A,A,A,A,A,H,H,H,A,A,A
668 A,A,A,A,H,H,H,H,A,A,A,A,B,B,D,D,D,G,G,G,G,G,G,D,D,D,D,B,A,A,A,A,A,A,A,H,H,H,A,A
669 A,A,A,A,H,H,H,A,A,A,A,B,D,D,D,D,D,G,G,G,G,G,G,D,D,D,D,D,B,A,A,A,A,A,A,A,H,H,A,A
670 A,A,A,H,A,A,A,A,A,A,B,C,D,D,D,G,G,G,D,D,D,D,G,G,G,D,D,D,C,B,A,H,H,A,A,A,A,H,A,A
671 A,A,A,H,H,A,A,A,A,A,D,C,C,C,D,G,G,F,G,D,D,G,F,G,G,D,D,C,C,C,B,A,H,H,A,A,A,A,A,A
672 A,A,A,A,A,H,H,H,H,B,D,D,C,C,D,G,G,F,F,F,F,F,F,G,G,D,D,C,C,D,B,A,A,H,H,A,A,A,A,A
673 A,A,A,A,A,A,A,A,A,B,D,D,C,C,C,C,C,B,F,F,F,F,F,B,C,C,C,C,D,D,B,A,A,H,H,H,H,A,A,A
674 A,A,A,H,H,A,A,A,A,B,D,D,C,C,C,C,C,C,B,F,F,F,B,C,C,C,C,C,D,D,B,A,A,A,A,H,H,A,A,A
675 A,A,A,A,A,A,A,A,A,A,B,B,D,D,C,C,C,C,C,B,F,B,C,C,C,C,D,D,B,B,A,A,A,H,H,A,A,A,A,A
676 A,A,A,A,A,A,A,A,A,A,B,B,B,D,D,C,C,C,C,B,F,B,C,C,C,C,D,B,B,B,A,A,A,H,H,A,A,A,A,A
677 A,A,A,A,A,A,A,A,A,B,C,C,C,B,B,D,D,D,D,B,F,B,D,D,D,B,B,D,C,C,B,A,A,A,H,A,A,A,A,A
678 A,A,A,A,A,A,A,A,B,C,C,C,C,C,D,B,B,B,F,F,F,F,B,B,B,D,D,C,C,C,C,B,A,A,A,A,A,A,H,H
679 A,A,A,A,A,A,A,A,B,C,C,C,C,C,D,D,D,G,G,F,F,G,G,D,D,D,D,C,C,C,C,B,A,A,A,A,A,A,H,H
680 A,A,A,A,A,A,A,I,B,D,C,C,C,C,C,C,C,G,G,F,F,G,G,C,C,C,C,C,C,C,D,B,I,A,A,A,A,A,A,A
681 A,A,A,A,A,A,A,I,B,D,D,D,C,C,C,B,B,B,G,G,G,G,B,B,B,C,C,C,D,D,D,B,I,A,A,A,A,A,A,A
682 A,A,A,A,A,H,A,I,I,B,D,D,D,D,D,C,C,C,B,D,D,B,C,C,C,C,D,D,D,B,B,I,I,A,A,A,A,A,A,A
683 A,A,A,A,A,H,H,H,I,B,B,D,D,D,D,D,C,C,B,D,D,B,C,C,C,D,D,D,D,B,I,I,A,A,A,A,A,A,A,A
684 A,A,H,H,H,A,A,A,I,I,I,B,B,B,D,B,B,B,B,B,B,B,B,B,B,D,B,B,B,I,I,I,A,A,A,A,A,A,H,A
685 A,A,H,H,H,A,A,A,A,I,I,I,B,B,B,B,B,B,B,B,B,B,B,B,B,B,B,B,I,I,I,A,A,A,A,A,A,A,H,A
686 H,H,A,H,H,A,A,A,A,A,A,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,A,A,A,A,A,A,A,A,A,A
687 A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,I,I,I,I,I,I,I,I,I,A,A,A,A,A,A,A,A,A,A,A,H,A,A,A,A
688 A,A,A,A,A,A,A,A,A,A,A,A,H,H,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,H,H,A,A,A,A
689 \end{filecontents*}
690
691 \def\listcoulkoala{VertForet,Noir,GrisClair,GrisFonce,Beige,Blanc,BleuClair,VertClair,Marron}
692
693 \begin{PresentationCode}{listing only}
694 \begin{filecontents*}[overwrite]{PAkoala.csv}
695 A,A,A,A,A,A,A,H,H,H,A,A,A,A,A,H,H,H,A,A,A,A,A,A,A,A,A,H,H,H,H,A,A,H,A,A,A,A,A,A
696 A,A,A,A,A,A,A,A,H,A,A,A,A,A,A,H,H,A,A,A,A,A,A,A,A,A,A,H,A,A,A,A,A,H,A,A,A,A,A,A
697 A,A,A,H,A,A,A,A,A,A,A,A,A,A,A,H,H,A,A,A,A,A,A,A,A,H,H,H,A,A,A,A,A,A,A,A,A,A,A,A
698 A,A,A,A,A,A,A,B,E,E,E,E,A,A,A,A,A,A,A,A,A,A,A,H,H,H,A,B,B,E,E,E,E,B,A,A,A,A,A,H
699 A,A,H,A,A,A,A,B,E,E,E,E,E,A,A,A,A,A,A,A,A,A,A,H,H,H,B,E,E,E,E,E,E,B,B,A,A,A,A,H
700 A,A,H,A,A,B,B,E,C,C,C,C,C,E,B,B,B,E,E,E,E,E,E,B,B,B,E,C,C,C,C,C,C,E,B,B,H,H,A,A
701 A,A,H,A,B,E,D,D,D,D,B,D,C,C,E,E,E,E,C,C,C,C,E,E,E,E,E,C,D,B,B,D,D,D,E,B,H,A,A,A
702 A,A,A,A,B,E,D,D,F,F,D,B,D,C,C,E,C,C,C,C,C,C,C,C,E,C,C,D,B,D,D,F,F,D,E,B,A,A,A,H
703 A,A,A,B,C,D,D,F,F,F,D,D,B,B,C,C,C,C,C,C,C,C,C,C,C,C,C,B,D,D,D,F,F,D,D,C,B,A,H,H
704 A,A,A,B,C,D,F,F,F,F,F,D,D,D,C,C,C,C,C,C,C,C,C,C,C,C,C,D,D,F,F,F,F,F,D,C,B,A,H,H
705 A,A,A,B,D,D,F,F,F,F,F,D,C,C,C,C,C,C,C,C,C,C,C,C,C,C,C,C,D,F,F,F,F,F,D,D,B,A,A,H
706 A,A,A,B,D,D,G,F,F,F,F,D,C,C,B,B,B,C,C,B,B,C,C,B,B,B,C,C,D,F,F,F,F,G,D,D,B,A,A,A
707 A,A,A,A,B,G,G,F,F,F,F,D,C,C,B,F,B,C,B,D,D,B,C,B,F,B,C,C,D,G,F,F,F,G,G,B,H,A,A,A
708 A,A,A,A,A,B,G,G,G,F,G,D,C,C,C,B,B,C,B,D,D,B,C,B,B,C,C,C,D,G,G,F,G,G,B,H,H,H,A,A
709 A,A,A,A,A,A,B,G,G,G,G,B,C,C,C,C,C,C,B,B,B,B,C,C,C,C,C,C,D,B,G,G,G,G,B,H,H,H,A,A
710 A,A,A,A,A,A,A,B,B,B,B,B,C,C,C,C,C,C,B,B,B,B,C,C,C,C,C,C,D,B,B,B,B,B,A,A,H,H,A,A
711 A,A,A,A,A,A,A,A,A,A,A,D,D,C,C,C,C,F,B,B,B,B,F,C,C,C,C,D,D,A,A,A,A,A,A,A,A,A,A,A
712 A,A,A,A,A,A,A,A,A,A,A,B,D,D,C,C,C,F,F,B,B,F,F,C,C,C,D,D,B,A,A,A,A,A,A,A,A,A,A,A
713 A,A,A,A,A,H,H,H,A,A,A,A,B,B,D,C,C,F,F,F,F,F,F,C,C,D,B,B,A,A,A,A,A,A,H,H,H,A,A,A
714 A,A,A,A,H,H,H,H,A,A,A,A,B,B,D,D,D,G,G,G,G,G,G,D,D,D,D,B,A,A,A,A,A,A,A,H,H,H,A,A
715 A,A,A,A,H,H,H,A,A,A,A,B,D,D,D,D,D,G,G,G,G,G,G,D,D,D,D,D,B,A,A,A,A,A,A,A,H,H,A,A
716 A,A,A,H,A,A,A,A,A,A,B,C,D,D,D,G,G,G,D,D,D,D,G,G,G,D,D,D,C,B,A,H,H,A,A,A,A,H,A,A
717 A,A,A,H,H,A,A,A,A,A,D,C,C,C,D,G,G,F,G,D,D,G,F,G,G,D,D,C,C,C,B,A,H,H,A,A,A,A,A,A
718 A,A,A,A,A,H,H,H,H,B,D,D,C,C,D,G,G,F,F,F,F,F,F,G,G,D,D,C,C,D,B,A,A,H,H,A,A,A,A,A
719 A,A,A,A,A,A,A,A,A,B,D,D,C,C,C,C,C,B,F,F,F,F,F,B,C,C,C,C,D,D,B,A,A,H,H,H,H,A,A,A
720 A,A,A,H,H,A,A,A,A,B,D,D,C,C,C,C,C,C,B,F,F,F,B,C,C,C,C,C,D,D,B,A,A,A,A,H,H,A,A,A
721 A,A,A,A,A,A,A,A,A,A,B,B,D,D,C,C,C,C,C,B,F,B,C,C,C,C,D,D,B,B,A,A,A,H,H,A,A,A,A,A
722 A,A,A,A,A,A,A,A,A,A,B,B,B,D,D,C,C,C,C,B,F,B,C,C,C,C,D,B,B,B,A,A,A,H,H,A,A,A,A,A
723 A,A,A,A,A,A,A,A,A,B,C,C,C,B,B,D,D,D,D,B,F,B,D,D,D,B,B,D,C,C,B,A,A,A,H,A,A,A,A,A
724 A,A,A,A,A,A,A,A,B,C,C,C,C,C,D,B,B,B,F,F,F,F,B,B,B,D,D,C,C,C,C,B,A,A,A,A,A,A,H,H
725 A,A,A,A,A,A,A,A,B,C,C,C,C,C,D,D,D,G,G,F,F,G,G,D,D,D,D,C,C,C,C,B,A,A,A,A,A,A,H,H
726 A,A,A,A,A,A,A,I,B,D,C,C,C,C,C,C,C,G,G,F,F,G,G,C,C,C,C,C,C,C,D,B,I,A,A,A,A,A,A,A
727 A,A,A,A,A,A,A,I,B,D,D,D,C,C,C,B,B,B,G,G,G,G,B,B,B,C,C,C,D,D,D,B,I,A,A,A,A,A,A,A
728 A,A,A,A,A,H,A,I,I,B,D,D,D,D,D,C,C,C,B,D,D,B,C,C,C,C,D,D,D,B,B,I,I,A,A,A,A,A,A,A
729 A,A,A,A,A,H,H,H,I,B,B,D,D,D,D,D,C,C,B,D,D,B,C,C,C,D,D,D,D,B,I,I,A,A,A,A,A,A,A,A
730 A,A,H,H,H,A,A,A,I,I,I,B,B,B,D,B,B,B,B,B,B,B,B,B,B,D,B,B,B,I,I,I,A,A,A,A,A,A,H,A
731 A,A,H,H,H,A,A,A,A,I,I,I,B,B,B,B,B,B,B,B,B,B,B,B,B,B,B,B,I,I,I,A,A,A,A,A,A,A,H,A
732 H,H,A,H,H,A,A,A,A,A,A,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,A,A,A,A,A,A,A,A,A,A
733 A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,I,I,I,I,I,I,I,I,I,A,A,A,A,A,A,A,A,A,A,A,H,A,A,A,A
734 A,A,A,A,A,A,A,A,A,A,A,A,H,H,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,H,H,A,A,A,A
735 \end{filecontents*}
736
737 %couleurs avec couleurs-fr
738 \def\listcoulkoala%
739 {VertForet,Noir,GrisClair,GrisFonce,Beige,Blanc,BleuClair,VertClair,Marron}
740 \end{PresentationCode}
741
742 \subsection{Aide quant à la création du découpage}
743
744 La première commande disponible est celle de l'affichage \textit{simplifié} de la grille de découpage (attention aux dimensions initiales pour un découpage \textit{idoine} !)
745
746 La version étoilée affiche les grilles sous la forme \texttt{1.1}/\texttt{1.2}, etc.
747
748 La version normale sous la forme \texttt{A1}, \texttt{A2}, etc.
749
750 \smallskip
751
752 L'argument \texttt{découpage} peut être donné sous la forme :
753 %
754 \begin{itemize}
755 \item \Cle{<nb lig bloc>x<nb col bloc>} pour spécifier la dimension des blocs ;
756 \item \Cle{<nb blocs V>+<nb blocs H>} pour spécifier le nombre de blocs.
757 \end{itemize}
758
759 \begin{PresentationCode}{}
760 %découpage par blocs de taille 8x8
761 \AideGrillePixelArtTikz{PAkoala.csv}{8x8}
762 ~~
763 \PixelArtTikz[Correction,Unite=0.125,Codes=ABCDEFGHI,Couleurs={\listcoulkoala},Decoupage=8x8]{PAkoala.csv}
764 \end{PresentationCode}
765
766 \begin{PresentationCode}{}
767 %découpage par 4 blocs / ligne et 4 blocs / colonne
768 \AideGrillePixelArtTikz*[2]{PAkoala.csv}{4+4}
769 ~~
770 \PixelArtTikz[Correction,Unite=0.2,Codes=ABCDEFGHI,Couleurs={\listcoulkoala},Decoupage=4+4]{PAkoala.csv}
771 \end{PresentationCode}
772
773 \newpage
774
775 \subsection{Affichage d'une partie unique}
776
777 Une commande est disponible pour l'affichage d'\textit{un} bloc particulier du PixelArt.
778
779 Les clés sont héritées de celle des commandes principales.
780
781 \begin{PresentationCode}{}
782 %bloc 1/1 pour un découpage 8x8
783 \PixelArtTikzBloc[Unite=0.35,Codes=ABCDEFGHI]{PAkoala.csv}{8x8}{1/1}
784 ~~
785 \PixelArtTikzBloc[Unite=0.35,Codes=ABCDEFGHI,Correction,Couleurs={\listcoulkoala}]{PAkoala.csv}{8x8}{1/1}
786 \end{PresentationCode}
787
788 \begin{PresentationCode}{}
789 %bloc 2/4 pour un découpage 4+4
790 \PixelArtTikzBloc[Unite=0.35,Codes=ABCDEFGHI]{PAkoala.csv}{4+4}{2/4}
791 ~~
792 \PixelArtTikzBloc[Unite=0.35,Codes=ABCDEFGHI,Correction,Couleurs={\listcoulkoala}]{PAkoala.csv}{4+4}{2/4}
793 \end{PresentationCode}
794
795 \smallskip
796
797 L'idée est ensuite d'utiliser cette commande d'insertion d'\textit{un} bloc pour créer l'énoncé avec \textit{les} grilles de découpage.
798
799 Mais il existe une commande de création \textit{automatique} des grilles découpées !
800
801 \newpage
802
803 \subsection{Création automatique du découpage}
804
805 Il existe également une commande dédiée pour le découpage automatique et la présentation automatique des petites grilles.
806
807 \begin{PresentationCode}{}
808 %découpage par blocs de 8x8
809 \DecoupPixelArtTikz[Unite=0.3,Codes=ABCDEFGHI]{PAkoala.csv}{8x8}
810 \end{PresentationCode}
811
812 \pagebreak
813
814 \begin{PresentationCode}{}
815 %découpage en4 blocs par 4
816 \DecoupPixelArtTikz[Unite=0.3,Codes=ABCDEFGHI,Correction,Couleurs={\listcoulkoala}]{PAkoala.csv}{4+4}
817 \end{PresentationCode}
818
819 \newpage
820
821 \part{Commandes complémentaires}
822
823 \section{PixelArt et anamorphose cylindrique}
824
825 \subsection{Idée}
826
827 L'idée est de proposer de quoi créer un PixelArt dans le but d'utiliser une anamorphose cylindrique.
828
829 Sur \url{https://www.youtube.com/watch?v=PT8KUozBg3I}, il y a une vidéo \textit{démonstration}, proposée par Jean-Yves Labouche.
830
831 Le fonctionnement global est similaire à celui de la commande \textit{principale}, il existe cependant quelques ajustements :
832
833 \begin{itemize}
834 \item la possibilité de donner le fichier \textsf{csv} en mode \textit{normal} ou \textit{inversé} ;
835 \item les dimensions (largeur \& milieu) sont à préciser pour produire le PixelArt ;
836 \item la commande est autonome (pour le moment) donc pas d'ajout(s) ultérieurement.
837 \end{itemize}
838
839 \begin{PresentationCode}{listing only}
840 \PixelArtTikzCylindre[clés]{fichier.csv}
841 \end{PresentationCode}
842
843 Les fichiers illustrant ce paragraphe sont donnés ci-dessous.
844
845 \begin{PresentationCode}{}
846 %version avec données inversées
847 \begin{filecontents*}[overwrite]{PAyoda.csv}
848 E,E,E,A,A,E,A,A,E,D
849 E,E,E,F,F,F,F,F,E,D
850 E,E,E,F,F,C,F,F,E,D
851 E,A,F,F,C,C,C,F,F,A
852 E,A,F,F,C,C,C,F,F,A
853 E,E,E,A,A,A,A,A,E,E
854 E,E,E,A,A,A,A,A,E,E
855 E,E,A,E,B,A,B,E,A,E
856 E,A,A,A,A,A,A,A,A,A
857 E,E,E,A,A,A,A,A,E,E
858 \end{filecontents*}
859
860 \PixelArtTikz[%
861 Codes=ABCDEF,
862 Couleurs={green,black,brown,white,brown!75!black,lightgray},
863 Correction,Unite=0.35]%
864 {PAyoda.csv}
865 \end{PresentationCode}
866
867 \begin{PresentationCode}{}
868 %version avec données normales
869 \begin{filecontents*}{PAsorciere.csv}
870 V,V,V,V,N,N,N,V,V,V
871 V,V,V,N,N,N,N,N,V,V
872 N,N,N,N,N,N,N,N,N,N
873 V,V,V,G,G,G,O,O,V,V
874 V,V,V,J,J,G,O,O,O,V
875 V,V,G,N,J,G,O,O,O,V
876 V,G,G,G,G,G,O,O,O,O
877 V,V,N,N,N,G,O,O,O,O
878 V,V,G,G,G,G,O,O,O,O
879 V,V,V,V,N,N,O,O,O,O
880 \end{filecontents*}
881
882 \PixelArtTikz[%
883 Codes=VNGOJ,
884 Couleurs={violet!50,black,green,orange,yellow},
885 Correction,Unite=0.35]%
886 {PAsorciere.csv}
887 \end{PresentationCode}
888
889 \subsection{Clés et options}
890
891 Le premier argument, \textit{optionnel} et entre \texttt{[...]} propose des \textsf{Clés} nécessaires au bon fonctionnement de la commande :
892
893 \begin{itemize}
894 \item la clé \Cle{Largeur} qui définir la largeur (rayon en cm) du rendu ;\hfill{}défaut \textsf{6}
895 \item la clé \Cle{Centre} qui définir la largeur (rayon en cm) du \textit{milieu} ;\hfill{}défaut \textsf{1.25}
896 \item la clé \Cle{Codes} contient la \textit{chaîne} des codes \textit{simples} du fichier \textsf{csv} ;
897 \item la clé \Cle{Couleurs} qui contient la \textit{liste} des couleurs associées ;
898 \item la clé \Cle{Symboles} qui contient la \textit{liste éventuelles} des caractères alternatifs à afficher dans les cases ;
899 \item la clé \Cle{Style} qui permet de spécifier le style des caractères. \hfill{}défaut \textsf{normalsize}
900 \item la clé booléenne \Cle{Correction} qui permet de colorier le PixelArt ;\hfill{}défaut \textsf{false}
901 \item la clé booléenne \Cle{Symb} qui permet d'afficher les caractères \textit{alternatifs} ;\hfill{}défaut \textsf{false}
902 \item la clé booléenne \Cle{Solution} qui permet d'afficher la solution (avec effet \textit{mirroir}) ;\hfill{}défaut \textsf{false}
903 \item la clé booléenne \Cle{Legende} qui permet d'afficher une légende (sur une idée de François Delannoy) ;\hfill{}défaut \textsf{false}
904 \item la clé booléenne \Cle{Swap} qui permet de spécifier le type de données (\Cle{true} := normal ; \Cle{false} := inversé).
905
906 \hfill{}défaut \textsf{false}
907 \end{itemize}
908
909 Le deuxième argument, \textit{obligatoire}, est le nom du fichier \textsf{csv} à utiliser.
910
911 \pagebreak
912
913 \subsection{Exemple avec données inversées (Yoda)}
914
915 Dans ce paragraphe, on utilise les données \texttt{PAyoda}, qui correspondent à la disposition \textit{inversée}, donc la clé \Cle{Swap} n'est pas nécessaire.
916
917 \begin{PresentationCode}{}
918 %version classique
919 \PixelArtTikzCylindre[Codes=ABCDEF,Style=\small\ttfamily,Legende]{PAyoda.csv}
920
921 \medskip
922
923 %version avec 'symboles'
924 \PixelArtTikzCylindre[Codes=ABCDEF,Symboles={1,2,3,4,5,6},Symb,Style=\small\ttfamily]{PAyoda.csv}
925 \end{PresentationCode}
926
927 \begin{PresentationCode}{}
928 %Correction et solution
929 \begin{tabular}{c}
930 \PixelArtTikzCylindre[%
931 Codes=ABCDEF,
932 Couleurs={green,black,brown,white,brown!75!black,lightgray},
933 Solution]%
934 {PAyoda.csv}
935 \\
936 \PixelArtTikzCylindre[%
937 Codes=ABCDEF,
938 Couleurs={green,black,brown,white,brown!75!black,lightgray},
939 Correction]%
940 {PAyoda.csv}
941 \end{tabular}
942 \end{PresentationCode}
943
944 \pagebreak
945
946 \subsection{Exemple avec données classiques (Sorcière)}
947
948 Dans ce paragraphe, on utilise les données \texttt{PAsorciere}, qui correspondent à la disposition \textit{normale}, donc la clé \Cle{Swap} est nécessaire.
949
950 \begin{PresentationCode}{}
951 %version classique
952 \PixelArtTikzCylindre[%
953 Largeur=4,Centre=1,Codes=VNGOJ,
954 Couleurs={violet!50,black,green,orange,yellow},
955 Swap,Style=\ttfamily\scriptsize]%
956 {PAsorciere.csv}
957 \end{PresentationCode}
958
959 \begin{PresentationCode}{}
960 %Correction et solution
961 \begin{tabular}{c}
962 \PixelArtTikzCylindre[%
963 Largeur=4,Centre=0.75,Codes=VNGOJ,
964 Couleurs={violet!50,black,green,orange,yellow},
965 Swap,Solution]%
966 {PAsorciere.csv}
967 \\
968 \PixelArtTikzCylindre[%
969 Largeur=4,Centre=0.75,Codes=VNGOJ,
970 Couleurs={violet!50,black,green,orange,yellow},
971 Swap,Correction]%
972 {PAsorciere.csv}
973 \end{tabular}
974 \end{PresentationCode}
975
976 \newpage
977
978 \section{La commande pour un \textit{mini-}PixelArt}
979
980 \subsection{Idée}
981
982 L'idée est de proposer une commande pour insérer, sans passer par un fichier \textsf{csv}, un petit PixelArt avec une liste de couleurs réduite.
983
984 \begin{PresentationCode}{listing only}
985 \MiniPixelArt[clés]{liste des couleurs}
986 \end{PresentationCode}
987
988 Le premier argument, \textit{optionnel} et entre \texttt{[...]} propose des \textsf{Clés} nécessaires au bon fonctionnement de la commande :
989
990 \begin{itemize}
991 \item la clé \Cle{Unite} pour spécifier l'unité des cases ;\hfill{}défaut \textsf{0.25em}
992 \item le booléen \Cle{Bord} pour afficher une bordure aux cases.\hfill{}défaut \textsf{false}
993 \end{itemize}
994
995 Le deuxième argument, obligatoire et entre \texttt{\{...\}} permet de donner les couleurs des cases :
996
997 \begin{itemize}
998 \item chaque couleur est codée par une lettre :
999 \begin{multicols}{5}
1000 \begin{itemize}
1001 \item \texttt{R : \textcolor{red}{rouge}}
1002 \item \texttt{V : \textcolor{green}{vert}}
1003 \item \texttt{B : \textcolor{blue}{bleu}}
1004 \item \texttt{J : \textcolor{yellow}{jaune}}
1005 \item \texttt{N : \textcolor{black}{noir}}
1006 \item \texttt{G : \textcolor{gray}{gris}}
1007 \item \texttt{. : \colorbox{lightgray}{\textcolor{white}{blanc}}}
1008 \item \texttt{M : \textcolor{brown}{marron}}
1009 \item \texttt{O : \textcolor{orange}{orange}}
1010 \item \texttt{P : \textcolor{violet}{violet}}
1011 \end{itemize}
1012 \end{multicols}
1013 \item chaque \textit{passage à la ligne} est spécifié par \texttt{,} ;
1014 \item les bords éventuels ont une épaisseur égale à 10\,\% de l'unité des carreaux.
1015 \end{itemize}
1016
1017 Le dernier argument, optionnel et entre \texttt{<...>}, permet quant à lui de passer des options à l'environnement \textsf{tikz} créé.
1018
1019 \subsection{Exemples}
1020
1021 \begin{PresentationCode}{}
1022 \MiniPixelArt{%
1023 ..RR..RR..,
1024 .RRRRRRRR.,
1025 RRRRRRRRRR,
1026 RRRRRRRRRR,
1027 RRRRRRRRRR,
1028 .RRRRRRRR.,
1029 ..RRRRRR..,
1030 ...RRRR...,
1031 ....RR....
1032 }
1033 \end{PresentationCode}
1034
1035 \begin{PresentationCode}{}
1036 En ligne, on a \MiniPixelArt[Unite=5mm,Bord]{NBVOJV,JGP.NR}<baseline=(current bounding box.center)> ce miniPA.
1037 \end{PresentationCode}
1038
1039 \newpage
1040
1041 \section{Création automatique du tableau notice}
1042
1043 \subsection{Idée}
1044
1045 L'idée est de proposer une commande pour créer automatiquement le tableau de notice, avec coloration des cases.
1046
1047 \smallskip
1048
1049 Le package utilisé est \texttt{tabularray}, et le code propose deux présentations du tableau, sous forme horizontal ou vertical (les tableaux sur plusieurs lignes ne sont pas gérés\ldots)
1050
1051 \begin{PresentationCode}{listing only}
1052 \TablCouleursPixelArt(*)[clés]{%
1053 données1,%
1054 données2,%
1055 ...
1056 }
1057 \end{PresentationCode}
1058
1059 Les \Cle{données} sont à mettre sous la forme \Cle{<NomCouleur>/<CodeCouleur>/<CouleurPolice>/<Résultat>}.
1060
1061 \subsection{Clés et exemples}
1062
1063 La version \textit{étoilée} force le tableau en mode vertical.
1064
1065 \smallskip
1066
1067 Les \Cle{clés} disponibles pour cette commande sont :
1068
1069 \begin{itemize}
1070 \item la clé \Cle{Largeur}, pour spécifier les informations de largeur :
1071 \begin{itemize}
1072 \item sous la forme \Cle{auto} pour les adapter aux contenus (valeur par défaut) ;
1073 \item sous la forme \Cle{largeurglobale} en mode H (les cases auront la même largeur) ;
1074 \item sous la forme \Cle{largeurcolonne} ou \Cle{largeurcolonne1/largeurcolonne2} en mode V ;
1075 \end{itemize}
1076 \item la clé \Cle{Police} spécifier une police particulière.
1077 \end{itemize}
1078
1079 \begin{PresentationCode}{}
1080 %par défaut
1081 \TablCouleursPixelArt{%
1082 Marron/BrunIntense/Blanc/75,%
1083 {Gris Clair}/GrisClair/Noir/{112,5},%
1084 Vert Clair/VertClair/Noir/600,%
1085 Noir/Noir/Blanc/9,%
1086 Beige/Beige/Noir/15,%
1087 Gris foncé/GrisFonce/Noir/{202,5},%
1088 Bleu clair/BleuClair/Noir/288,%
1089 Vert foncé/VertFonce/Blanc/10,%
1090 Blanc/Blanc/Noir/55%
1091 }
1092 \end{PresentationCode}
1093
1094 \begin{PresentationCode}{}
1095 %personnalisations
1096 \TablCouleursPixelArt[Largeur=\linewidth,Police=\small\sffamily]{%
1097 Marron/BrunIntense/Blanc/75,%
1098 {Gris Clair}/GrisClair/Noir/{112,5},%
1099 Vert Clair/VertClair/Noir/600,%
1100 Noir/Noir/Blanc/9,%
1101 Beige/Beige/Noir/15,%
1102 Gris foncé/GrisFonce/Noir/{202,5},%
1103 Bleu clair/BleuClair/Noir/288,%
1104 Vert foncé/VertFonce/Blanc/10,%
1105 Blanc/Blanc/Noir/55%
1106 }
1107 \end{PresentationCode}
1108
1109 \pagebreak
1110
1111 \begin{PresentationCode}{}
1112 %personnalisations
1113 \TablCouleursPixelArt*[Largeur=3cm/]{%
1114 Marron/BrunIntense/Blanc/75,%
1115 {Gris Clair}/GrisClair/Noir/{112,5},%
1116 Vert Clair/VertClair/Noir/600,%
1117 Noir/Noir/Blanc/9,%
1118 Beige/Beige/Noir/15,%
1119 Gris foncé/GrisFonce/Noir/{202,5},%
1120 Bleu clair/BleuClair/Noir/288,%
1121 Vert foncé/VertFonce/Blanc/10,%
1122 Blanc/Blanc/Noir/55%
1123 }
1124 \end{PresentationCode}
1125
1126 \subsection{Commande simplifiée (??) pour les cases}
1127
1128 Il est également possible de créer le tableau \textit{manuellement}, avec une commande \textit{simplifiée} pour la création des cases.
1129
1130 \begin{PresentationCode}{listing only}
1131 %dans un environnement tblr, chargé avec [expand=\expanded] et \expanded !
1132 \cctblr[couleur police]{couleur fond}{case}
1133 \end{PresentationCode}
1134
1135 \begin{PresentationCode}{}
1136 \begin{tblr}[expand=\expanded]{width=\linewidth,colspec={*{5}{Q[m,l]}},hlines,vlines}
1137 \expanded{\cctblr[Blanc]{BrunIntense}{Marron}} &
1138 \expanded{\cctblr{GrisClair}{Gris clair}} &
1139 \expanded{\cctblr{VertClair}{Vert clair}} &
1140 \expanded{\cctblr[Blanc]{Noir}{Noir}} &
1141 \ldots \\
1142 75 & {112,5} & 600 & 9 & \ldots \\
1143 \end{tblr}
1144 \end{PresentationCode}
1145
1146 \pagebreak
1147
1148 \section{Avec le package datatool}
1149
1150 \subsection{Commandes}
1151
1152 Le package \textsf{datatool}, chargé par \textsf{PixelArtTikz}, permet de représenter un PixelArt (sans environnement).
1153
1154 Les clés sont les mêmes que pour la version \textsf{csvsimple}, mais il est nécessaire de \textit{traiter} le ficher \textsf{csv} en amont des tracés.
1155
1156 \begin{PresentationCode}{listing only}
1157 %lecture du fichier csv
1158 \readdtcsv{fichier.csv}{nomlecture}
1159
1160 %traitement du PixelArt complet
1161 \dtpixlarttikz[clés]{nomlecture}
1162
1163 %traitement du PixelArt en mode découpage
1164 \dtpixlarttikzblock[clés]{nomlecture}{LxC ou L+C}{numbloc}
1165 \end{PresentationCode}
1166
1167 À noter que la commande est autonome, ne permet pas d'ajouts éventuels, mais est compatible avec le traitement par découpage (mais sans création automatique des blocs de découpage avec présentation).
1168
1169 \subsection{Exemple}
1170
1171 \begin{PresentationCode}{}
1172 %lecture du fichier csv (koala)
1173 \readdtcsv{PAkoala.csv}{DTkoala}
1174
1175 %traitement du PixelArt complet
1176 \dtpixlarttikz[Correction,Unite=0.125,Codes=ABCDEFGHI,Couleurs={\listcoulkoala},Decoupage=8x8]{DTkoala}
1177
1178 %traitement du PixelArt en mode découpage
1179 \dtpixlarttikzblock[Unite=0.125,Correction,Codes=ABCDEFGHI,Couleurs={\listcoulkoala}]%
1180 {DTkoala}{8x8}{1/1}
1181 \end{PresentationCode}
1182
1183 \pagebreak
1184
1185 \part{Historique}
1186
1187 \verb|v0.20a|~:~~~~Clé \textsf{[Legende]} pour la version \textit{anamorphose}
1188
1189 \verb|v0.1.9|~:~~~~Version \hologo{LaTeX3} du package (\textsf{pixelarttikz-l3})
1190
1191 \verb|v0.1.8|~:~~~~Bugfix
1192
1193 \verb|v0.1.7|~:~~~~Correction d'un bug avec les découpages
1194
1195 \verb|v0.1.6|~:~~~~Ajout d'un style pour les traits + utilisation de \textsf{datatool} (plus rapide ?)
1196
1197 \verb|v0.1.5|~:~~~~Symboles sous forme de liste(s) (éléments tirés aléatoirement) + Amélioration du traitement
1198
1199 \verb|v0.1.4|~:~~~~PixelArts avec anamorphose cylindrique
1200
1201 \verb|v0.1.3|~:~~~~Possibilité de créer des PixelArts collaboratifs
1202
1203 \verb|v0.1.2|~:~~~~Possibilité de créer des \textit{mini-}PixelArts
1204
1205 \verb|v0.1.1|~:~~~~Correction d'un bug avec les couleurs
1206
1207 \verb|v0.1.0|~:~~~~Version initiale
1208
1209 \end{document}