Debian Codegraph @

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

raw
1 % !TeX encoding = UTF-8
2 % !TeX TS-program = pdflatex
3 % Ceci est la documentation du package "scratch3"
4 % Fichier compilé avec pdflatex
5 \documentclass[french,a4paper,10pt]{article}
6 \usepackage[utf8]{inputenc}
7 \usepackage[T1]{fontenc}
8 \usepackage[margin=2cm]{geometry}
9 \usepackage[bottom]{footmisc}
10 \usepackage{libertine,boites,tikz,enumitem,MnSymbol,babel,xspace,listings,scratch3}
11 \usepackage[scaled=0.8]{luximono}
12 \frenchbsetup{og=«,fg=»}
13 \def\SCRATCH{\texttt{scratch}\xspace}
14 \def\SSCRATCH{\texttt{\scrname}\xspace}
15 \makeatletter
16 \def\code{\expandafter\code@i\string}
17 \def\code@i#1{%
18 \begingroup
19 \par\nobreak\medskip\parindent0pt
20 \leftskip.1\linewidth
21 \catcode`\^^I 13 \begingroup\lccode`\~`\^^I \lowercase{\endgroup\def~{\leavevmode\space\space\space\space}}%
22 \let\do\@makeother \dospecials
23 \ttfamily\small\@noligs
24 \make@car@active\<{$\langle$\begingroup\itshape}%
25 \make@car@active\>{\endgroup$\rangle$}%
26 \obeylines\obeyspaces
27 \def\code@ii##1#1{##1\par\medbreak\endgroup}%
28 \code@ii
29 }
30 \long\def\grab@toks#1\relax{\gdef\right@content{#1}}
31
32 \newcommand\disable@lig[1]{%
33 \catcode`#1\active
34 \begingroup
35 \lccode`\~`#1\relax
36 \lowercase{\endgroup\def~{\leavevmode\kern\z@\string#1}}%
37 }
38
39 \newcommand\make@car@active[1]{%
40 \catcode`#1\active
41 \begingroup
42 \lccode`\~`#1\relax
43 \lowercase{\endgroup\def~}%
44 }
45
46 \newcommand\exemple{%
47 \begingroup
48 \parskip\z@
49 \exemple@}
50
51 \newcommand\exemple@{%
52 \medbreak\noindent
53 \begingroup
54 \let\do\@makeother\dospecials
55 \make@car@active\ { {}}%
56 \make@car@active\^^M{\par\leavevmode}%
57 \make@car@active\^^I{\space\space}%
58 \make@car@active\,{\leavevmode\kern\z@\string,}%
59 \make@car@active\-{\leavevmode\kern\z@\string-}%
60 \make@car@active\>{\leavevmode\kern\z@\string>}%
61 \make@car@active\<{\leavevmode\kern\z@\string<}%
62 \@makeother\;\@makeother\!\@makeother\?\@makeother\:% neutralise frenchb
63 \exemple@@
64 }
65
66 \newcommand\exemple@@[1]{%
67 \def\@tempa##1#1{\exemple@@@{##1}}%
68 \@tempa
69 }
70
71 \newcommand\exemple@@@[1]{%
72 \xdef\the@code{#1}%
73 \endgroup
74 \begingroup
75 \fboxrule0.4pt \fboxsep=5pt
76 \let\breakboxparindent\z@
77 \def\bkvz@top{\hrule\@height\fboxrule}%
78 \def\bkvz@bottom{\hrule\@height\fboxrule}%
79 \let\bkvz@before@breakbox\relax
80 \def\bkvz@set@linewidth{\advance\linewidth\dimexpr-2\fboxrule-2\fboxsep\relax}%
81 \def\bkvz@left{\vrule\@width\fboxrule\kern\fboxsep}%
82 \def\bkvz@right{\kern\fboxsep\vrule\@width\fboxrule}%
83 \breakbox
84 \kern.5ex\relax
85 \begingroup
86 \ttfamily\small\the@code\par
87 \endgroup
88 \kern3pt
89 \hrule height0.1pt width\linewidth depth0.1pt
90 \vskip5pt
91 \newlinechar`\^^M\everyeof{\noexpand}\scantokens{#1}\par
92 \endbreakbox
93 \endgroup
94 \medbreak
95 \endgroup
96 }
97 \begingroup
98 \catcode`\<13 \catcode`\>13
99 \gdef\verb{\relax\ifmmode\hbox\else\leavevmode\null\fi
100 \bgroup
101 \verb@eol@error \let\do\@makeother \dospecials
102 \verbatim@font\@noligs
103 \catcode`\<13 \catcode`\>13 \def<{\begingroup$\langle$\itshape}\def>{\/$\rangle$\endgroup}%
104 \@ifstar\@sverb\@verb}
105 \endgroup
106 \def\longfrscrdate@i#1/#2/#3\@nil{\number#3\relax\ifnum\number#3=1 \noexpand\ier\fi\space \ifcase#2 \or janvier\or février\or mars\or avril\or mai\or juin\or juillet\or aout\or septembre\or octobre\or novembre\or décembre\fi\space#1}
107 \edef\longfrscrdate{\expandafter\longfrscrdate@i\scrdate\@nil}
108 \makeatother
109 \begingroup
110 \catcode`\_11
111 \gdef\cleval#1#2{%
112 \bigbreak\noindent
113 \hbox to .25\linewidth{%
114 \color{teal}\bfseries\ttfamily
115 \detokenize{#1}=$\langle$\detokenize{#2}$\rangle$\hss}\kern2.5em
116 (\textit{Défaut} : {\color{teal}\ttfamily
117 \skv_eearg\skv_ifempty{\useKV[\scrname]{#1}}
118 {\detokenize{{}}}
119 {\detokenize\expandafter\expandafter\expandafter{\useKV[\scrname]{#1}}}}\unskip)%
120 \par\nobreak
121 }
122 \endgroup
123 \def\suffixe#1{\begingroup\sffamily\bfseries\color{scr#1}#1\endgroup}
124 \newenvironment{version}[2]
125 {%
126 \paragraph{\hbox to 4em {v\hskip1pt #1\hfill}#2}\hskip0pt \par
127 \catcode`\>13 \begingroup\lccode`\~`\> \lowercase{\endgroup\let~}\item
128 \begin{itemize}%
129 }
130 {%
131 \end{itemize}%
132 }
133 \begin{document}
134 \parindent=0pt
135 \thispagestyle{empty}
136 \begin{titlepage}
137 \begingroup
138 \centering
139 \null\vskip.25\vsize
140 {\large\bfseries L'extension pour \LaTeX\medbreak
141 \Huge \begin{scratch}[line width=1.5pt]\blockmove\scrname\end{scratch}\par}
142 \bigbreak
143 v \scrver
144 \smallbreak
145 \longfrscrdate
146 \vskip1.5cm
147 Christian \bsc{Tellechea}\par
148 \texttt{[email protected]}\par
149 \endgroup
150 \vskip2cm
151 \leftskip=.2\linewidth \rightskip=.2\linewidth \small
152 Cette extension permet de dessiner des empilements de blocs similaires à ceux que l'on trouve dans le logiciel de programmation \emph{visuelle} « \SCRATCH v3\footnote{Le logiciel que l'on peut utiliser en ligne à \texttt{https://scratch.mit.edu/}} ».
153 \end{titlepage}
154 \parindent0pt
155 \section{Avant propos}
156 La présente extension intitulée \SSCRATCH, est une évolution de l'extension \SCRATCH qui imitait la version 2 du logiciel. Depuis janvier~2019, le logiciel est passé à la version~3 et l'extension \SCRATCH est donc devenue obsolète et non maintenue.\medbreak
157
158 Cette version de \SSCRATCH ayant un numéro de version inférieur à 1, elle est susceptible d'être immature, c'est-à-dire de contenir des bugs, des incohérences ou des effets non désirés. Si cela se produit, je remercie les utilisateurs de bien vouloir me le faire savoir par email.\medbreak
159
160 Les utilisateurs les plus attentifs auront sans doute remarqué que seuls les blocs de type «stylo» sont disponibles parmi ceux qui sont dorénavant considérés comme «extension». Il s'agit, pour l'instant, d'un choix délibéré...
161
162 \paragraph{Attention} Il est fortement déconseillé de charger les packages \SCRATCH et \SSCRATCH en raison de plusieurs définitions communes qu'ils partagent et qui conduiraient inévitablement à des dysfonctionnements. L'erreur qui survient ---~et le refus de charger le deuxième~--- lorsqu'on tente de charger ces deux packages ne doivent pas être désactivés par une modification de leurs codes.\medbreak
163
164 L'extension \SSCRATCH requiert les extensions \texttt{simplekv} et \texttt{ti\textit kz} qui sont automatiquement chargées si cela s'avère nécessaire.\medbreak
165
166 Fidèle à mes convictions, la documentation de cette extension n'est disponible qu'en français.
167
168 \section{L'environnement \SCRATCH}
169 Pour dessiner un programme comme le fait \SCRATCH, il faut ouvrir un environnement «\SCRATCH» et écrire dans cet environnement les macros correspondant aux \emph{blocs} que l'on veut y mettre :
170
171 \code|\begin{scratch}
172 macros pour dessiner des blocs
173 \end{scratch}|
174
175 Comme le savent ceux qui enseignent l'algorithmique et la programmation avec le très-à-la-mode\footnote{Je ne déteste rien de plus comme langage de programmation que ce \emph{truc} vaguement graphique, ultra limité et contre-productif dans l'apprentissage du codage qu'est \SCRATCH et que l'éducation nationale veut à tout prix imposer. Je ne compte bien évidemment pas me plier à ce nouveau dogme ridicule et ne l'utiliserai ni ne l'enseignerai; je considère que les élèves méritent mieux que \SCRATCH --~Python, java ou lua par exemple~-- comme entrée dans le monde de la programmation.} logiciel « \SCRATCH », les programmes sont construits avec des briques, appelés «blocs», qui peuvent s'emboiter les uns sur les autres. Ces blocs sont de plusieurs couleurs, chacune correspondant à un type d'instruction que l'on retrouve dans les menus de \SCRATCH.
176
177 J'ai pris le parti d'écrire des macros ayant comme argument le texte qui figure dans le bloc. Ce faisant, on a plus de liberté que dans \SCRATCH où les blocs ont des textes prédéfinis, mais cette liberté permet d'utiliser cette extension quelle que soit la langue dans laquelle on écrit.
178
179 Enfin, j'ai cherché le bon compromis entre complexité du code et qualité des dessins obtenus avec cette extension: ils \emph{ressemblent} à ceux du logiciel \SCRATCH, mais le but de cette extension n'est \emph{pas} la ressemblance absolue au pixel près!
180
181 \section{Les blocs normaux}
182 Ces blocs sont les plus courants et possèdent une encoche d'emboitement, femelle en haut et mâle en bas. Les macros permettant de dessiner ces blocs ont des noms de la forme \verb|\block<suffixe>| et ont un seul argument obligatoire qui est le texte que l'on souhaite mettre dans le bloc. Par exemple, un bloc bleu (correspondant au menu «mouvement») a un suffixe \suffixe{move}, et est dessiné grâce à la macro \verb|\blockmove{<texte>}|. Ainsi, dans l'environnement \SCRATCH, écrire \verb|\blockmove{Bonjour le monde}| donne
183 \begin{center}\begin{scratch}\blockmove{Bonjour le monde}\end{scratch}\end{center}
184
185 La police d'écriture dans chaque bloc est la police « \textsf{sans serif} » qui est définie dans le document au moment où l'environnement est appelé : pratiquement, cela signifie que la macro \verb|\sffamily| est exécutée avant que le texte des blocs ne soit composé. La clé «\texttt{pre text}» (voir page~\pageref{pre text}), modifiable par l'utilisateur, contient par défaut le code exécuté avant que du texte ne soit affiché, c'est-à-dire \verb|\sffamily|. Dans cette documentation, la police sans serif est «\textsf{biolinum}».
186
187 La plupart des dimensions des blocs sont proportionnelles à la taille de la police en cours. On peut donc jouer sur la taille de la police (via les classiques macros \verb|\small|, \verb|\large|, \verb|\footnotesize|, etc) pour modifier la taille des blocs\footnote{Il y a aussi la clé «\texttt{scale}» pour mettre le dessin à l'échelle que l'on souhaite, voir page~\pageref{cle-scale}} .
188
189 Voici un inventaire des tous les blocs disponibles, empilés les uns sous les autres :
190
191 \exemple/Voici un algorithme bizarre : \begin{scratch}
192 \blockmove{bloc de mouvement}
193 \blocklook{bloc d'apparence}
194 \blocksound{bloc de son}
195 \blockpen{bloc de stylo}
196 \blockvariable{bloc de variable}
197 \blocklist{bloc de liste}
198 \blockevent{bloc d'événement}
199 \blockcontrol{bloc de contrôle}
200 \blocksensing{bloc de capteur}
201 \end{scratch}/
202
203 Il faut donc retenir cette logique : les suffixes \suffixe{move}, \suffixe{look}, \suffixe{sound}, \suffixe{pen}, \suffixe{variable}, \suffixe{list}, \suffixe{event}, \suffixe{control} et \suffixe{sensing} correspondent aux couleurs des blocs. Il existe aussi le suffixe \suffixe{operator} qui n'a pas été montré précédemment puisqu'aucun bloc n'existe pour la fonction «opérateurs».
204
205 \section{Les ovales}
206 Les « ovales » sont, selon le code graphique de \SCRATCH, censés contenir des variables que l'utilisateur spécifie lui-même (comme des nombres ou du texte) :
207 \begin{center}
208 \begin{scratch}
209 \blockmove{tourner de \turnleft{} de \ovalnum{45} degrés}
210 \blocklook{penser à \ovalnum{Hmm..} pendant \ovalnum{2} secondes}
211 \end{scratch}
212 \end{center}
213 Les variables peuvent être prédéfinies dans \SCRATCH ou créées par l'utilisateur et dans ce cas, les ovales sont de couleur identique à la couleur du thème auquel appartient la variable:
214 \begin{center}
215 \begin{scratch}
216 \blocklook{penser à \ovalsensing{réponse}}
217 \blockmove{aller à x: \ovaloperator{\ovalmove{ abscisse x} + \ovalnum{1}} y: \ovalmove{ordonnée y}}
218 \end{scratch}
219 \end{center}
220 Ces variables peuvent également être spécifiques aux blocs concernés, sélectionnées parmi plusieurs possibilités, auquel cas l'ovale est de couleur plus sombre que le bloc et se termine avec une flèche de sélection :
221 \begin{center}
222 \begin{scratch}
223 \blocksound{jouer le son \ovalsound*{Meow}}
224 \blockcontrol{créer un clone de \ovalcontrol*{moi même}}
225 \end{scratch}
226 \end{center}
227 Au niveau des macros utilisées :
228 \begin{itemize}
229 \item la macro \verb|\ovalnum{<nombre>}| dessine un ovale à fond blanc;
230 \item la macro \verb|\oval<suffixe>| trace un ovale de la couleur de \verb|<suffixe>|;
231 \item en version étoilée, \verb|\oval<suffixe>*| trace un ovale de couleur plus sombre avec une flèche de sélection;
232 \item les macros \verb|\turnleft| et \verb|\turnright| dessinent des flèches de rotation dans les blocs \verb|\blockmove|.
233 \end{itemize}
234
235 \exemple/Ovales de toutes sortes : \begin{scratch}
236 \blockmove{tourner de \turnleft{} de \ovalnum{45} degrés}
237 \blocklook{penser à \ovalnum{Hmm..} pendant \ovalnum{2} secondes}
238 \blocklook{penser à \ovalsensing{réponse}}
239 \blockmove{aller à x: \ovaloperator{\ovalmove{ abscisse x} + \ovalnum{1}} y: \ovalmove{ordonnée y}}
240 \blocksound{jouer le son \ovalsound*{Meow}}
241 \blockcontrol{créer un clone de \ovalcontrol*{moi même}}
242 \end{scratch}/
243
244 Toutes les macros de la forme \verb|\oval<suffixe>| sont utilisables \emph{en dehors} de l'environnement \SCRATCH:
245
246 \exemple/Voici une variable simple «\ovalmove{direction}»,
247 une variable sélectionnée «\ovalsound*{Meow}»./
248
249 Il faut signaler que les blocs de suffixes \suffixe{operator}, \suffixe{variable} , \suffixe{list} ou \suffixe{moreblocks} ne peuvent avoir d'ovales de sélection. N'ayant pas de sens pour \SCRATCH, une erreur sera émise si une macro étoilée \verb|\oval<suffixe>*| est utilisée, et visuellement, cela se traduira par une couleur de remplissage du bloc en rouge.
250 \medbreak
251 Un ovale rempli de couleur et accessible avec la macro \verb|\pencolor{<couleur>}| permet de sélectionner la couleur du stylo:
252
253 \exemple/\begin{scratch}
254 \blockpen{stylo en position d'écriture}
255 \blockpen{mettre la couleur du style à \pencolor{red!75!black}}
256 \blockmove{avancer de \ovalnum{25}}
257 \end{scratch}/
258
259 \section{Les blocs de début}
260 Ces blocs sont de la couleur \suffixe{event} pour la plupart (macro \verb|\blockinit|), mais il existe aussi un bloc de début de couleur \suffixe{control} (macro \verb|\blockinitclone|). Le drapeau vert est dessiné avec la macro \verb|\greenflag|.
261
262 \exemple/Voici un début :
263 \begin{scratch}
264 \blockinit{quand \greenflag est cliqué}
265 \blockmove{suite de l'algorithme...}
266 \end{scratch}
267 et un autre :
268 \begin{scratch}
269 \blockinitclone{quand je commence comme un clone}
270 \blocklook{enfiler le costume de clown !}
271 \end{scratch}/
272
273 \section{Les rectangles}
274 Un menu déroulant contenant des valeurs prédéfinies est symbolisé par un rectangle dont la couleur reprend celle du bloc dans lequel il se trouve. Pour ce faire, la macro \verb|\selectmenu{<texte>}| doit être exécutée :
275
276 \exemple/\begin{scratch}
277 \blockinit{Quand je reçois \selectmenu{message 1}}
278 \blocksound{ajouter \ovalnum{10} à l'effet \selectmenu{hauteur}}
279 \blocklook{mettre l'effet \selectmenu{couleur} à \ovalnum{0}}
280 \blockvariable{mettre \selectmenu{ma_variable} à \ovalnum{10}}
281 \end{scratch}/
282
283 \section{Les losanges et les blocs de test}
284 Dans la symbolique graphique de \SCRATCH, les losanges contiennent des valeurs booléennes ayant vocation à se retrouver dans un bloc de test. Pour dessiner de tels objets booléens, les macros \verb|\bool<suffixe>{<texte>}| sont utilisées où les \verb|<suffixes>| représentent les couleurs correspondant à la fonction du booléen tracé : \suffixe{list}, \suffixe{sensing} ou \suffixe{operator}.
285
286 Les blocs de test sont de deux types,selon qu'ils possèdent ou pas une branche « else».
287 \code|\blockif{<texte du test>}
288 {<instructions si test vrai>}|
289 et
290 \code|\blockifelse{<texte du test>}
291 {<instructions si test vrai>}
292 {<instructions si test faux>}|
293
294
295 \exemple/Conditions : \begin{scratch}
296 \blockif{si \booloperator{\ovalmove{abscisse x} < \ovalnum{7}} alors}
297 {\blockmove{aller à \selectmenu{position aléatoire}}
298 \blocklook{basculer sur costume \selectmenu{costume 4}}
299 }
300 \blockmove{aller à \selectmenu{pointeur souris}}
301 \end{scratch}
302 et
303 \begin{scratch}
304 \blockifelse{si \boolsensing{couleur \pencolor{blue!65} touchée ?} alors}
305 {\blockmove{avancer de \ovalnum{2}}
306 \blocksound{jouer le son \selectmenu{miaou}}
307 }
308 {\blockvariable{mettre \ovalvariable{total} à \ovaloperator{\ovalvariable{total} + \ovalnum{1}}}
309 \blocksound{arrêter tous les sons}
310 }
311 \blockmove{aller à \selectmenu{pointeur souris}}
312 \end{scratch}/
313
314 La macros \verb|\pencolor| et celles de la forme \verb|\bool<suffixe>| sont utilisables \emph{en dehors} d'un environnement \SCRATCH :
315
316 \exemple/Une couleur : \pencolor{cyan}.\par
317 Un booléen : \boollist{liste \selectmenu{malist} contient \ovalnum{foobar}}.\par
318 Un autre : \booloperator{\booloperator{\ovalvariable{varx} > \ovalnum{1}}
319 et \booloperator{\ovalvariable{varx} < \ovalnum{5}}}./
320
321 La macro \verb|\boolempty[<dimension>]| permet de tracer un losange vide. L'argument optionnel est une \verb|<dimension>| qui vaut \verb|2em| par défaut.
322
323 \exemple/\begin{scratch}
324 \blockifelse{si \boolempty[3em] alors}
325 {\blocklook{dire \ovalnum{le test est vrai}}}
326 {\blocklook{dire \ovalnum{le test est faux}}}
327 \end{scratch}/
328
329 \section{Les blocs de fin}
330 Ces blocs sont susceptibles de clore un algorithme et n'ont donc pas d'encoche mâle dans leur partie basse. Ils ne peuvent être que du type \suffixe{control} et sont dessinés avec la macro \verb|\blockstop{<texte>}|
331
332 \exemple/\begin{scratch}\blockstop{supprimer ce clone}\end{scratch}
333 ou
334 \begin{scratch}\blockstop{stop \selectmenu{ce script}}\end{scratch}/
335
336 \section{Les blocs de répétition}
337 Ces blocs sont de deux types, selon que la répétition est prévue pour s'arrêter ou pas (boucle infinie). Ils seront dessinés par les macros \verb|\blockrepeat| et \verb|\blocinfloop| ayant chacune \emph{deux} arguments : le premier étant le \verb|<texte>| du bloc et le second la suite d'instructions à répéter.
338
339 \exemple/\begin{scratch}
340 \blockpen{stylo en position d'écriture}
341 \blockrepeat{répéter \ovalnum{4} fois}
342 {
343 \blockmove{avancer de \ovalnum{10}}
344 \blockmove{tourner \turnright{} de \ovalnum{90} degrés}
345 }
346 \end{scratch}
347 et
348 \begin{scratch}
349 \blockpen{stylo en position d'écriture}
350 \blockinfloop{répéter indéfiniment}
351 {
352 \blockmove{s'orienter à \ovaloperator{nombre aléatoire entre \ovalnum{0} et \ovalnum{359}}}
353 \blockmove{avancer de \ovaloperator{nombre aléatoire entre \ovalnum{1} et \ovalnum{10}}}
354 \blockif{si \boolsensing{\selectmenu{bord} touché?}}
355 {
356 \blockmove{aller à x: \ovalnum{0} y: \ovalnum{0}}
357 }
358 }
359 \end{scratch}/
360
361 \section{Les blocs de définition}
362 Les « procédures », ayant le suffixe \suffixe{moreblocks}, permettent d'étendre les maigres possibilités données au programmeur en \SCRATCH.
363
364 \exemple/\begin{scratch}
365 \initmoreblocks{définir \namemoreblocks{trace_carré \ovalmoreblocks{coté_carré}}}
366 \blockrepeat{répéter \ovalnum4 fois}
367 {\blockmove{avancer de \ovalmoreblocks{coté_carré}}
368 \blockmove{tourner \turnleft{} de \ovalnum{90} degrés}
369 }
370 \end{scratch}
371 puis
372 \begin{scratch}
373 \blockinit{Quand \greenflag est cliqué}
374 \blockpen{effacer tout}
375 \blockpen{relever le stylo}
376 \blockmove{aller à x: \ovalnum0 y: \ovalnum0}
377 \blockmove{s'orienter à \ovalnum{90} degrés}
378 \blockpen{stylo en position d'écriture}
379 \blockrepeat{répéter \ovalnum{10} fois}
380 {
381 \blockmoreblocks{trace carré \ovalnum{50}}
382 \blockmove{avancer de \ovalnum{10}}
383 \blockmove{tourner \turnleft{} de \ovalnum{36} degrés}
384 }
385 \end{scratch}/
386
387 À l'intérieur d'un \verb|\namemoreblocks|, on peut mettre \verb|\ovalmoreblocks| pour spécifier un argument de type nombre ou texte ou bien \verb|\boolmoreblocks| pour un argument de type booléen.
388
389 \section{Bloc invisible}
390 Bien que ce genre de bloc n'existe pas avec \SCRATCH, cette fonctionnalité peut s'avérer utile. On insère un espace vide avec \verb|\blockspace[<coeff>]|. L'espace verticale insérée est égale à la hauteur normale d'un bloc multipliée par le \verb|<coeff>|, valeur optionnelle qui vaut 1 par défaut.
391
392 \exemple/\begin{scratch}
393 \blockmove{ci-dessous, une espace d'un bloc}
394 \blockspace
395 \blockmove{ci dessous, une espace égale à la moitié d'un bloc}
396 \blockspace[0.5]
397 \blockmove{la suite}
398 \end{scratch}/
399
400 \section{Personnalisation}
401 Plusieurs \verb|<paramètres>| peuvent être réglés par l'utilisateur selon la syntaxe \verb|<clé>=<valeur>|. Cas paramètres peuvent être spécifiés dans :
402
403 \begin{itemize}
404 \item l'argument optionnel de l'environnement \verb|\begin{scratch}[<paramètres>]| auquel cas les \verb|<paramètres>| ne s'appliquent qu'à cet environnement;
405 \item l'argument de la macro \verb|\setscratch{<paramètres>}| pour spécifier des \verb|<paramètres>| pour les environnements \SCRATCH à venir;
406 \item l'argument de \verb|\setdefaultscratch{<paramètres>}| pour spécifier des \verb|<paramètres>| \emph{par défaut}.
407 \end{itemize}
408
409 Il existe la macro \verb|\resetscratch| qui remet à leur valeur par défaut tous les \verb|<paramètres>| de \SCRATCH, pour annuler les effets d'une macro \verb|\setscratch|.\bigbreak
410
411 Voici les \verb|<paramètres>| disponibles :
412
413 \cleval{else word}{caractères}
414 Représente est le mot qui est inséré dans la branche « else » d'un bloc de test.
415
416 \cleval{pre text}{code}\label{pre text}
417 C'est le \verb|code| qui est exécuté avent que du texte ne soit affiché par \SSCRATCH.
418
419 \cleval{x sep}{dimension}
420 Représente l'espace horizontale insérée entre les bords droit et gauche du texte du bloc et les bords droits et gauche du bloc. La valeur est ramenée si nécessaire dans l'intervalle [3pt ; 1em].
421
422 \cleval{y sepsup}{dimension}
423 Représente l'espace verticale insérée entre le bas de l'encoche femelle et le bord supérieur du texte du bloc. La valeur est ramenée si nécessaire dans l'intervalle [3pt ; 3ex].
424
425 \cleval{y sepinf}{dimension}
426 Représente l'espace verticale insérée entre le bas du bloc et le bord inférieur du texte du bloc. La valeur est ramenée si nécessaire dans l'intervalle [3pt ; 3ex].
427
428 \cleval{line width}{dimension}
429 Représente l'épaisseur des lignes de relief des blocs et le double des lignes de relief des losanges booléens. La valeur est ramenée si nécessaire dans l'intervalle [0pt ; 5pt].
430
431 \cleval{loop width}{dimension}
432 Représente est la largeur de la barre verticale des blocs de répétition ou de test. La valeur est ramenée si nécessaire dans l'intervalle [3pt ; 3em].
433
434 \cleval{loop height}{dimension}
435 Représente est l'épaisseur des barres horizontales « else » et inférieure des blocs de répétition ou de test. La valeur est ramenée si nécessaire dans l'intervalle [3pt ; 3ex].
436
437 \cleval{corner}{dimension}
438 Représente la dimension des chanfreins des blocs. La valeur est ramenée si nécessaire dans l'intervalle [0.33333ex ; 1ex].
439
440 \cleval{notch}{dimension}
441 Représente la largeur des encoches. La valeur est ramenée si nécessaire dans l'intervalle [0.33333em ; 3em].
442
443 \cleval{scale}{coefficient}\label{cle-scale}
444 Représente l'échelle à laquelle est représenté le dessin. La valeur est ramenée si nécessaire dans l'intervalle [0.2 ; 5].
445
446 Les blocs ovales ou losanges, qui peuvent se trouver à l'extérieur de l'environnement scrtach, sont affectés par la valeur de \texttt{scale} :
447
448 \exemple/\setscratch{scale=1}Échelle 1 : \ovalvariable{var} et \booloperator{\ovalmove{abscisse x} < \ovalnum{7}}\par
449 Échelle 0.75 :\setscratch{scale=.75} : \ovalvariable{var} et \booloperator{\ovalmove{abscisse x} < \ovalnum{7}}\par
450 Échelle 1.25 :\setscratch{scale=1.25} : \ovalvariable{var} et \booloperator{\ovalmove{abscisse x} < \ovalnum{7}}/
451
452 \cleval{init arcangle}{angle}
453 Représente l'angle avec l'horizontale de l'arc de cercle tracé dans la partie haute des blocs de départ. La valeur est ramenée si nécessaire dans l'intervalle [20 ; 40].
454
455 \cleval{init arclength}{dimension}
456 Représente la longueur horizontale de l'arc de cercle tracé dans la partie haute des blocs de départ. La valeur est ramenée si nécessaire dans l'intervalle [3em ; 8em].
457
458 \cleval{print}{booléen}
459 Lorsque ce booléen est vrai, les dessins se font en noir et blanc de façon à pouvoir être dirigés vers une impression en noir et blanc.
460
461 \exemple/\begin{scratch}
462 \blockinit{Quand \greenflag est cliqué}
463 \blockpen{effacer tout}
464 \blocksound{jouer le son \ovalsound*{Meow}}
465 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
466 \end{scratch} puis
467 \begin{scratch}[print]
468 \blockinit{Quand \greenflag est cliqué}
469 \blockpen{effacer tout}
470 \blocksound{jouer le son \ovalsound*{Meow}}
471 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
472 \end{scratch}/
473
474 \cleval{fill blocks}{booléen}
475 Ce booléen n'est pris en compte que lorsque le booléen \verb|print| est vrai. Si \verb|fill blocks| est vrai, tous les dessins (sauf les ovales contenant des nombres) seront remplis avec un gris choisi avec la clé suivante.
476
477 \cleval{fill gray}{taux de gris}
478 Lorsque \verb|fill blocks| est vrai, ce taux de blanc dans le gris (nombre compris entre 0 pour noir et 1 pour blanc) est utilisé pour définir une couleur de remplissage des dessins. La valeur est ramenée si nécessaire dans l'intervalle [0 ; 1].
479
480 \exemple/\begin{scratch}
481 \blockinit{Quand \greenflag est cliqué}
482 \blockpen{effacer tout}
483 \blocksound{jouer le son \ovalsound*{Meow}}
484 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
485 \end{scratch} puis
486 \begin{scratch}[print,fill blocks]
487 \blockinit{Quand \greenflag est cliqué}
488 \blockpen{effacer tout}
489 \blocksound{jouer le son \ovalsound*{Meow}}
490 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
491 \end{scratch} puis
492 \begin{scratch}[print,fill blocks,fill gray=0.66]
493 \blockinit{Quand \greenflag est cliqué}
494 \blockpen{effacer tout}
495 \blocksound{jouer le son \ovalsound*{Meow}}
496 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
497 \end{scratch}/
498
499 \cleval{contrast}{entier}
500 Lorsque l'option \verb|print| est vraie, cet entier, compris entre 0 et 100 inclus, qualifie la différence de teinte entre les lignes de relief et la teinte de gris de ces blocs, spécifiée par la clé \texttt{fill gray}. L'entier 0 sélectionne la couleur spécifiée par \texttt{fill gray} tandis que 100 trace les lignes en noir. La valeur est ramenée si nécessaire dans l'intervalle [0 ; 100].
501
502 \cleval{text color}{couleur}
503 Lorsque \verb|fill blocks| est vrai, cette couleur sera utilisée pour le texte des blocs.
504
505 \cleval{flag gray}{taux de gris}
506 Lorsque \verb|print| est vrai, ce taux de gris est utilisé pour la couleur du drapeau tracé avec \verb|\greenflag| ainsi que pour la flèche se trouvant au bas des blocs de répétition. La valeur est ramenée si nécessaire dans l'intervalle [0 ; 1].
507
508 \exemple/\begin{scratch}[print,fill blocks,fill gray=0.66]
509 \blockinit{Quand \greenflag est cliqué}
510 \blockpen{effacer tout}
511 \blocksound{jouer le son \ovalsound*{Meow}}
512 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
513 \end{scratch} puis
514 \begin{scratch}[print,fill blocks,fill gray=0.33,text color=white,flag gray=0.66]
515 \blockinit{Quand \greenflag est cliqué}
516 \blockpen{effacer tout}
517 \blocksound{jouer le son \ovalsound*{Meow}}
518 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
519 \end{scratch}/
520
521 \cleval{line gray}{taux de gris}
522 Lorsque \verb|print| est vrai, ce taux de gris est utilisé pour la couleur des lignes de relief. La valeur est ramenée si nécessaire dans l'intervalle [0 ; 1].
523
524 \cleval{num blocks}{booléen}
525 Lorsque ce booléen est vrai, les blocs sont numérotés.
526
527 \cleval{num sep}{dimension}
528 Cette clé contient l'espacement entre les numéros de blocs et leur frontière gauche. La valeur est ramenée si nécessaire dans l'intervalle [0pt ; 1.5em].
529
530 \cleval{num start}{entier}
531 Cette clé contient le premier numéro du bloc.
532
533 La macro \verb|\numblock| est chargée d'imprimer les numéros de ligne. Elle admet un argument (le numéro de ligne) et permet, lorsqu'elle est redéfinie, de personnaliser la numérotation : choix de la couleur, de la police, de sa taille et des effets applicables à son argument. Par défaut, cette macro est définie par
534 \begin{center}
535 \verb|\newcommand*\numblock[1]{\color{black}\footnotesize\bfseries#1}|
536 \end{center}
537
538 Dans l'environnement \SCRATCH, entre des instructions \SCRATCH, on peut activer ou désactiver la numérotation \emph{pour le dessin en cours} à l'aide de
539 \begin{center}
540 \verb|\setscratch{num blocks=<booléen>}|
541 \end{center}
542
543 \exemple/\begin{scratch}[num blocks]
544 \blockinit{Quand \greenflag est cliqué}
545 \blockpen{effacer tout}
546 \blocksound{jouer le son \ovalsound*{Meow}}
547 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
548 \end{scratch} puis
549 \renewcommand*\numblock[1]{\color{blue!80}\itshape#1}
550 \begin{scratch}[num blocks,num start=3]
551 \blockinit{Quand \greenflag est cliqué}
552 \blockpen{effacer tout}
553 \blocksound{jouer le son \ovalsound*{Meow}}
554 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
555 \end{scratch}
556 puis
557 \renewcommand*\numblock[1]{\fboxsep=0.5pt\fbox{\bfseries#1}}
558 \begin{scratch}[num blocks=false]
559 \blockinit{Quand \greenflag est cliqué}
560 \blockpen{effacer tout}
561 \setscratch{num blocks=true}
562 \blocksound{jouer le son \ovalsound*{Meow}}
563 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
564 \end{scratch}/
565
566 \cleval{baseline}{alignement}
567 Cette clé contient la consigne d'alignement du dessin tout entier, c'est-à-dire :
568 \begin{itemize}
569 \item la lettre «\verb|c|» auquel cas, le dessin est centré sur la ligne de base
570 \item un entier qui spécifie un numéro de bloc existant : la numérotation est cohérente avec l'entier initial contenu dans la clé \verb|num start|. Dans ce cas, la ligne de base choisie est celle du texte contenu dans le bloc portant le numéro choisi.
571 \end{itemize}
572
573 \exemple/Défaut : \begin{scratch}
574 \blockinit{Quand \greenflag est cliqué}
575 \blockpen{effacer tout}
576 \blocksound{jouer le son \ovalsound*{Meow}}
577 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
578 \end{scratch}
579 bloc 3 : \begin{scratch}[baseline=3]
580 \blockinit{Quand \greenflag est cliqué}
581 \blockpen{effacer tout}
582 \blocksound{jouer le son \ovalsound*{Meow}}
583 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
584 \end{scratch}
585 centré
586 \begin{scratch}[baseline=c]
587 \blockinit{Quand \greenflag est cliqué}
588 \blockpen{effacer tout}
589 \blocksound{jouer le son \ovalsound*{Meow}}
590 \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
591 \end{scratch}/
592
593 \section{Mot de la fin}
594 Le code de cette extension démontre mon immense ignorance de ti\textit kz/pgf et les méthodes de programmation qui lui sont propres que décidément, je ne comprendrai jamais! C'est sans doute le trop grand éloignement avec la logique de \TeX{} et la documentation de ti\textit kz/pgf, aussi indigeste qu'illisible, qui explique cette incompatibilité d'humeur et mon désintérêt à l'égard de ti\textit kz. Toujours est-il que cette extension fonctionne, avec une lenteur certaine que j'attribue autant à ma programmation hasardeuse qu'à la lenteur intrinsèque de ti\textit kz.
595
596 Toute remarque, remontée de bug ---~je n'ose pas dire amélioration du code~---, demande d'implémentation de fonctionnalité est bien évidemment bienvenue; j'invite les utilisateurs à m'en faire part \emph{via} email à \texttt{[email protected]}
597
598 \section{Historique}
599 \begin{version}{0.1}{19/02/2019}
600 >Première version.
601 \end{version}
602 \begin{version}{0.11}{10/03/2019}
603 >Correction d'un bug dans \verb|\scr_blockloop| : la couleur \verb|\scr_current_blockcolor| y est désormais définie;
604 >Correction d'un bug dans \verb|\boolmoreblocks| : la couleur est correcte et \verb|rounded corners| désormais est nul pour le tracé d'un losange.
605 \end{version}
606 \begin{version}{0.12}{18/05/2019}
607 >Correction d'un bug dans \verb|\ovalnum|;
608 >Correction d'un bug dans \verb|\scr_ovalbox|.
609 \end{version}
610 \begin{version}{0.13}{01/07/2019}
611 >Mise en place de \verb|\relax| pour éviter le bug de \verb|\lastkern| avec Xe\LaTeX.
612 \end{version}
613 \begin{version}{0.14}{01/10/2019}
614 >Gestion de l'échelle (via clé "\texttt{scale}") améliorée.
615 >Hors de l'environnement, les ovales et les losanges sont affectés par la clé "\texttt{scale}" si elle est spécifiée via \verb|\setscratch|.
616 >Erreur de tracé corrigée dans \verb|\scr_blockloop|.
617 >Nouveau losange vide : \verb|\boolempty[<dimension>]|.
618 \end{version}
619 \begin{version}{0.15}{05/03/2020}
620 >Bug corrigé dans les blocs normaux: l'échelle est désormais réinitialisée si besoin.
621 \end{version}
622 \begin{version}{0.16}{20/03/2020}
623 >Le bug corrigé dans la v0.15 est fautif, \verb|scr_scale| est désormais initialisée dans \verb|\initmoreblocks|.
624 \end{version}
625 \begin{version}{0.17}{27/04/2020}
626 >Quelques petites modifications pour ne plus appeler aucune macro privée de simplekv et sa version 0.2.
627 \end{version}
628 \begin{version}{0.18}{03/09/2020}
629 >initialisation de \verb|\scr_yoffset| et \verb|\scr_xoffset| dans \verb|\scr_namemoreblocks|.
630 >initialisation de \verb|\scr_linewidth| dans \verb|\greenflag|.
631 \end{version}
632 \begin{version}{0.19}{06/02/2022}
633 >échelle initialisée dans les blocs normaux.
634 >espace de 0.3333em en début de texte \verb|\selectmenu|.
635 >bug fix dans \verb|\scr_ovalbox| : 0.1 de séparation.
636 >\verb-\scr_blockstop- vaut 0 après \verb-\blockspace-.
637 >encodage UTF-8
638 \end{version}
639 \end{document}