doc/mp-scratch.tex

   1 \documentclass[12pt]{article}
   2 \usepackage[utf8]{inputenc}
   3 \usepackage[T1]{fontenc}
   4 \usepackage[a4paper,margin=2cm,nohead,includefoot]{geometry}
   5 \usepackage{fourier}
   6 \usepackage[scaled=0.875]{helvet}
   7 \pagestyle{empty}
   8 \usepackage[frenchb]{babel}
   9 \input{Christ5}
  10 \usepackage{graphicx}
  11 \graphicspath{{figures/}}
  12 \DeclareGraphicsRule{*}{mps}{*}{}
  13 \usepackage{mflogo}
  14 \usepackage{url}
  15 \usepackage{multicol}
  16 \usepackage{listingsutf8}
  17 \usepackage{filecontents}
  18 \lstset{language=MetaPost,inputencoding=utf8,basicstyle=\sffamily}
  19 \usepackage[tikz]{bclogo}
  20 %\renewcommand\bcStyleTitre[1]{}
  21 \title{\includegraphics[scale=0.05]{Scratch_cat.png}\kern0.05\linewidth Scratch et \MP\kern0.05\linewidth\includegraphics{Carre.1}}
  22 \author{
  23   \begin{tabular}{c}
  24     C.Poulain\\
  25     \url{chrpoulain@gmail.com}\\
  26   \end{tabular}
  27 }
  28 \date{Janvier 2017}
  29 \begin{document}
  30 \maketitle
  31 \begin{abstract}
  32   Comment utiliser \MP\ pour produire des algorithmes \og papier\fg\ avec les conventions de Scratch.
  33 \end{abstract}
  34 \vspace{2em}
  35 \setcounter{tocdepth}{1}
  36 \tableofcontents
  37 \vspace{2em}
  38 Avec les nouveaux programmes 2016 du Cycle 4 (Classes de 5\ieme\ à 3\ieme\ de collège) est apparu l'enseignement de l'algorithmique et l'utilisation de Scratch. Développé par le laboratoire Média du MIT, il permet de mettre en \oe uvre des algorithmes sous forme {\em ludique}. Sans rentrer dans un débat \og pour ou contre\fg, son emploi doit donc être enseigné aux élèves aux travers de différentes activités : questions {\em flash}\footnote{Sans aucun lien avec le langage informatique. Il s'agit de questions rapides posées en début de séance.}, questions de compréhension, modification, correction d'algorithmes\ldots\ Il fallait donc trouver une solution me permettant de proposer des algorithmes Scratch dans mes devoirs.\par La première solution envisagée a été, bien évidemment, la capture d'écran. Simple, facile, rapide\ldots\ ses avantages sont nombreux. Cependant, la qualité d'impression est parfois \og moyenne\fg\ldots
  39 \\Soucieux de proposer quelque chose de plus {\em cohérent} avec le \og monde\fg\ \LaTeX, je me suis lancé dans la création de {\sffamily mp-scratch} avec pour objectif principal de proposer une syntaxe et une présentation très proche de celles utilisées par Scratch.
  40 \begin{figure}[h]
  41   \centering
  42   \includegraphics[scale=0.85]{Scratch1.png}\kern0.05\linewidth\includegraphics{Algo1.1}
  43   \caption{Algorithme de création d'un carré - Versions Scratch et \MP\protect\footnotemark}
  44   \label{fig:1}
  45 \end{figure}
  46 \footnotetext{Ce premier algorithme me permet de remercier Maxime Chupin et son package {\sffamily bclogo} : le drapeau vert a été créé à partir des sources de son package et notamment la construction, en \MP, de ses drapeaux.}
  47 \section{Installation}
  48 {\sffamily mp-scratch} est indépendant des autres packages personnels déjà produits tels \lstinline!geometriesyr16!, \lstinline!mp-geo! ou \lstinline!mp-solid!.
  49 \\Au travers d'un dépôt \lstinline!git!\footnote{Tous les contributeurs sont donc les bienvenus pour développer le package.}, on trouvera l'archive à l'adresse
  50 \begin{center}
  51   \url{http://melusine.eu.org/syracuse/G/mp-scratch/}
  52 \end{center}
  53 et l'ensemble des fichiers sera à placer correctement dans une arborescence \TeX\footnote{Arborescence locale de préférence, par exemple dans {\sffamily /home/christophe/texmf/metapost/} sous Linux.}.
  54 \\Pour l'utilisation, il sera nécessaire de veiller :
  55 \begin{itemize}
  56 \item à installer, si ce n'est pas fait, la fonte {\sffamily Carlito}\footnote{\url{http://www.tug.dk/FontCatalogue/carlito/} pour un exemple. Le choix reste personnalisable évidemment mais Thierry Pasquier, à juste titre, m'a préconisé d'utiliser une fonte sans serif.};
  57 \item à modifier, dans le fichier {\sffamily LATEXScratch.mp}, la ligne
  58 \vspace{1em}
  59 \begin{center}
  60   \lstinline!  write "\graphicspath{{/home/cp/texmf/metapost/Scratch/}}" to "mptextmp.mp";!
  61 \end{center}
  62 \vspace{1em}
  63 pour indiquer le chemin correspondant à votre installation.
  64 \end{itemize}
  65 \section{Utilisation}
  66 \begin{figure}[h]
  67   \centering
  68   \begin{minipage}{0.4\linewidth}
  69   \includegraphics{Algo1.1}
  70 \end{minipage}
  71 \hspace{4em}
  72 \begin{minipage}{0.4\linewidth}
  73 \small
  74 \begin{lstlisting}[firstnumber=1,frame=tb]
  75 input mp-scratch;
  76
  77 beginfig(1);
  78   draw Drapeau;
  79   draw Repeter1(4);
  80   draw Avancer(50);
  81   draw Tournerd(90);
  82   draw FinBlocRepeter1(10);
  83 endfig;
  84 end
  85   \end{lstlisting}
  86 \end{minipage}
  87   \caption{Un carré - Code et résultat sous \MP}
  88   \label{fig:carre}
  89 \end{figure}
  90 %\par\vspace{1em}\par
  91 Reprenons l'exemple de l'algorithme du carré pour faire les premières constatations suivantes :
  92 \begin{Enumerate}
  93   \item la syntaxe est très proche du vocabulaire utilisé par Scratch; donc très peu de nouvelles commandes à apprendre\ldots
  94   \item les couleurs\footnote{Cela reste, bien évidemment, paramétrable. Les paramètres disponibles pour personnaliser les couleurs sont \lstinline!colMouv!, \lstinline!colAp!, \lstinline!colSon!, \lstinline!colStylo!, \lstinline!colEvenements!, \lstinline!colControle!, \lstinline!colCapteur!, \lstinline!colBloc!, \lstinline!colVar!, \lstinline!colList!.} sont celles utilisées par Scratch\footnote{Une nouvelle fois, merci à Maxime Chupin pour m'avoir fait découvrir l'utilitaire \lstinline!gcolor2! sous Linux};
  95   \item le bloc {\sffamily Répéter} est particulier car il nécessite l'ajout {\em manuel} d'un nombre (ou chiffre)\footnote{{\sffamily Repeter2}, {\sffamily Repeter5}\ldots} qui permettra  à \MP\ de faire la liaison correcte lors de la présence de multiples blocs {\sffamily Répéter} comme le montre l'exemple ci-dessous.
  96 %\par\vspace{1em}\par
  97     \begin{figure}[h]
  98       \centering
  99       \begin{minipage}{0.45\linewidth}
 100   \includegraphics{Algo2.1}
 101 \end{minipage}
 102 \hspace{2em}
 103 \begin{minipage}{0.35\linewidth}
 104 \small
 105 \begin{lstlisting}[firstnumber=1,frame=tb]
 106 input mp-scratch;
 107
 108 beginfig(1);
 109   draw Drapeau;
 110   draw Repeter2(10);
 111   draw Repeter1(4);
 112   draw Avancer(50);
 113   draw Tournerd(90);
 114   draw FinBlocRepeter1(10);
 115   draw Avancer(60);
 116   draw FinBlocRepeter2(10);
 117 endfig;
 118 end
 119   \end{lstlisting}
 120 \end{minipage}
 121       \caption{Un carré se déplace - Code et résultat sous \MP}
 122       \label{fig:carredep}
 123     \end{figure}
 124 \end{Enumerate}
 125 \begin{bclogo}[arrondi=0.1,logo=\bcattention,noborder=true,cadreTitre=false,barre=none]{}
 126   Pour les codes \MP\ suivants, on omettra volontairement \lstinline!input mp-scratch! et \lstinline!end!.\footnotemark
 127 \end{bclogo}
 128 \footnotetext{Chacun aura reconnu le package \lstinline!bclogo! de Maxime Chupin.}
 129 \subsection{Commandes Scratch}
 130 \begin{description}
 131   \item[Groupe {\sffamily Mouvement}]\hfil\newline
 132     \begin{itemize}
 133     \item[\textbullet]\lstinline!draw Avancer(10);!
 134       \par\hfill\includegraphics{CommandeMouvement.1}
 135     \item[\textbullet]\lstinline!draw Tournerd(90);!
 136       \par\hfill\includegraphics{CommandeMouvement.2}
 137     \item[\textbullet]\lstinline!draw Tournerg(90)!
 138       \par\hfill\includegraphics{CommandeMouvement.3}
 139     \item[\textbullet]\lstinline!draw Orienter(90);!
 140       \par\hfill\includegraphics{CommandeMouvement.4}
 141     \item[\textbullet]\lstinline!draw Orienterdirection("pointeur de souris");!
 142       \par\hfill\includegraphics{CommandeMouvement.5}
 143     \item[\textbullet]\lstinline!draw Aller(50,100);!
 144       \par\hfill\includegraphics{CommandeMouvement.6}
 145     \item[\textbullet]\lstinline!draw Allera("pointeur de souris");!
 146       \par\hfill\includegraphics{CommandeMouvement.7}
 147     \item[\textbullet]\lstinline!draw Glisser(2,50,100);!
 148       \par\hfill\includegraphics{CommandeMouvement.8}
 149     \item[\textbullet]\lstinline!draw Ajouter(10,"x");!
 150       \par\hfill\includegraphics{CommandeMouvement.9}
 151     \item[\textbullet]\lstinline!draw Mettre(10,"x");!
 152       \par\hfill\includegraphics{CommandeMouvement.10}
 153     \item[\textbullet]\lstinline!draw Ajouter(50,"y");!
 154       \par\hfill\includegraphics{CommandeMouvement.11}
 155     \item[\textbullet]\lstinline!draw Mettre(10,"y");!
 156       \par\hfill\includegraphics{CommandeMouvement.12}
 157     \item[\textbullet]\lstinline!draw Rebondir;!
 158       \par\hfill\includegraphics{CommandeMouvement.13}
 159     \item[\textbullet]\lstinline!draw FixerSensRotation("position \`a gauche ou \`a droite"';!
 160       \par\hfill\includegraphics{CommandeMouvement.14}
 161     \end{itemize}
 162 Les \og opérateurs\footnote{Je nomme \og opérateurs\fg\ les variables ou commandes Scratch pouvant s'inclure dans les blocs-commande. Je me demande si je suis assez clair\ldots}\fg\
 163 \[\includegraphics{CommandeMouvement.18}\kern0.1\linewidth\includegraphics{CommandeMouvement.19}\kern0.1\linewidth\includegraphics{CommandeMouvement.20}\]
 164  s'obtiennent avec la commande \LaTeX\footnote{Oui, une commande \LaTeX. Cela signifie donc que cette commande sera passée comme un élément de type {\sffamily string} de \MP.} \lstinline!\opMouv{}! comme le montrent les exemples ci-dessous :
 165     \begin{itemize}
 166     \item[\textbullet]\lstinline!draw Avancer("\opOp{$\opMouv{abscisse x}\bm{+}\opSimple{10}$}");!
 167       \par\hfill\includegraphics{CommandeMouvement.15}
 168     \item[\textbullet]\lstinline!draw Mettre("\opMouv{abscisse x}","y");!
 169       \par\hfill\includegraphics{CommandeMouvement.16}
 170     \item[\textbullet]\lstinline!draw Ajouter("\opMouv{direction}","y");!
 171       \par\hfill\includegraphics{CommandeMouvement.17}
 172     \end{itemize}
 173     \vspace*{2em}\par
 174   \item[Groupe {\sffamily Apparence}]\hfil\newline
 175     \begin{itemize}
 176     \item[\textbullet]\lstinline!draw DireT("\opSimple{Hello}",2);!
 177       \par\hfill\includegraphics{CommandeApparence.1}
 178     \item[\textbullet]\lstinline!draw Dire("\opSimple{Hello}");!
 179       \par\hfill\includegraphics{CommandeApparence.2}
 180     \item[\textbullet]\lstinline!draw PenserT("\opSimple{Hmm...}",2);!
 181       \par\hfill\includegraphics{CommandeApparence.3}
 182     \item[\textbullet]\lstinline!draw Penser("\opSimple{Hmm...}");!
 183       \par\hfill\includegraphics{CommandeApparence.4}
 184     \item[\textbullet]\lstinline!draw Montrer;!
 185       \par\hfill\includegraphics{CommandeApparence.5}
 186     \item[\textbullet]\lstinline!draw Cacher;!
 187       \par\hfill\includegraphics{CommandeApparence.6}
 188     \item[\textbullet]\lstinline!draw Basculer("\opApMenu{costume2}");!
 189       \par\hfill\includegraphics{CommandeApparence.7}
 190     \item[\textbullet]\lstinline!draw CostumeSuivant;!
 191       \par\hfill\includegraphics{CommandeApparence.8}
 192     \item[\textbullet]\lstinline!draw BasculerAR("\opApMenu{arriere-plan2}");!
 193       \par\hfill\includegraphics{CommandeApparence.9}
 194     \item[\textbullet]\lstinline!draw AjouterEffet("\opApMenu{couleur}",10);!
 195       \par\hfill\includegraphics{CommandeApparence.10}
 196     \item[\textbullet]\lstinline!draw MettreEffet("\opApMenu{couleur}",10);!
 197       \par\hfill\includegraphics{CommandeApparence.11}
 198     \item[\textbullet]\lstinline!draw AnnulerEffet;!
 199       \par\hfill\includegraphics{CommandeApparence.12}
 200     \item[\textbullet]\lstinline!draw AjouterTaille(10);!
 201       \par\hfill\includegraphics{CommandeApparence.13}
 202     \item[\textbullet]\lstinline!draw MettreA("\opOp{$\opSimple{10}\bm{+}\opSimple{5}$}");!
 203       \par\hfill\includegraphics{CommandeApparence.14}
 204     \item[\textbullet]\lstinline!draw AllerPPlan;!
 205       \par\hfill\includegraphics{CommandeApparence.15}
 206     \item[\textbullet]\lstinline!draw DeplacerAP("\opOp{$\opMouv{abscisse x}\bm{+}\opSimple{10}$}");!
 207       \par\hfill\includegraphics{CommandeApparence.16}
 208     \end{itemize}
 209 \vspace{1em}\par Quand \og la scène\fg\ est sélectionnée, on dispose également des commandes :
 210     \begin{itemize}
 211     \item[\textbullet]\lstinline!draw BasculerARA("\opApMenu{arriere-plan2}");!
 212       \par\hfill\includegraphics{CommandeApparence.20}
 213     \item [\textbullet]\lstinline!draw ARSuivant;!
 214       \par\hfill\includegraphics{CommandeApparence.21}
 215     \end{itemize}
 216     \par\vspace*{2em}\par Les \og opérateurs\fg\
 217 \[\includegraphics{CommandeApparence.17}\kern0.1\linewidth\includegraphics{CommandeApparence.18}\kern0.1\linewidth\includegraphics{CommandeApparence.19}\kern0.1\linewidth\includegraphics{CommandeApparence.22}\]
 218 s'obtiennent avec la commande \LaTeX\ \lstinline!\opAp{}!.
 219     \par\vspace*{2em}\par
 220   \item[Groupe {\sffamily Son}]\hfil\newline
 221     \begin{itemize}
 222     \item[\textbullet]\lstinline!draw Jouer("miaou");!
 223       \par\hfill\includegraphics{CommandeSon.1}
 224     \item[\textbullet]\lstinline!draw JouerT("miaou");!
 225       \par\hfill\includegraphics{CommandeSon.2}
 226     \item[\textbullet]\lstinline!draw ArreterSon;!
 227       \par\hfill\includegraphics{CommandeSon.3}
 228     \item[\textbullet]\lstinline!draw Tambour(2,0.25);!
 229       \par\hfill\includegraphics{CommandeSon.4}
 230     \item[\textbullet]\lstinline!draw Pause(0.25);!
 231       \par\hfill\includegraphics{CommandeSon.5}
 232     \item[\textbullet]\lstinline!draw JouerNote(50,0.25);!
 233       \par\hfill\includegraphics{CommandeSon.6}
 234     \item[\textbullet]\lstinline!draw ChoisirInstrument(17);!
 235       \par\hfill\includegraphics{CommandeSon.7}
 236     \item[\textbullet]\lstinline!draw AjouterVol(-10);!
 237       \par\hfill\includegraphics{CommandeSon.8}
 238     \item[\textbullet]\lstinline!draw MettreVol(15);!
 239       \par\hfill\includegraphics{CommandeSon.9}
 240     \item[\textbullet]\lstinline!draw AjouterTempo(20);!
 241       \par\hfill\includegraphics{CommandeSon.10}
 242     \item[\textbullet]\lstinline!draw MettreTempo(15);!
 243       \par\hfill\includegraphics{CommandeSon.11}
 244     \end{itemize}
 245 Les \og opérateurs\fg
 246 \[\includegraphics{CommandeSon.12}\kern0.1\linewidth\includegraphics{CommandeSon.13}\]
 247 s'obtiennent par la commande \LaTeX\ \lstinline!\opSon{}!.
 248     \par\vspace*{2em}\par
 249   \item[Groupe {\sffamily Stylo}]\hfil\newline
 250     \begin{itemize}
 251     \item[\textbullet]\lstinline!draw Effacer;!
 252       \par\hfill\includegraphics{CommandeStylo.1}
 253     \item[\textbullet]\lstinline!draw Estampiller;!
 254       \par\hfill\includegraphics{CommandeStylo.2}
 255     \item[\textbullet]\lstinline!draw PoserStylo;!
 256       \par\hfill\includegraphics{CommandeStylo.3}
 257     \item[\textbullet]\lstinline!draw ReleverStylo;!
 258       \par\hfill\includegraphics{CommandeStylo.4}
 259     \item[\textbullet]\lstinline!draw MettreCouleur("Magenta",1,0,1);!\footnote{La couleur est définie par son triplet {\sffamily rgb}. Le nom de la couleur est libre mais ne doit pas rentrer en conflit avec les couleurs déjà définies dans le sous-package {\sffamily LATEXScratch.mp}.}
 260       \par\hfill\includegraphics{CommandeStylo.5}
 261     \item[\textbullet]\lstinline!draw AjouterCS("\opOp{$\opSimple{15}\bm{+}\opSimple{10}$}");!
 262       \par\hfill\includegraphics{CommandeStylo.6}
 263     \item[\textbullet]\lstinline!draw MettreCS(25);!
 264       \par\hfill\includegraphics{CommandeStylo.7}
 265     \item[\textbullet]\lstinline!draw AjouterIS("\opOp{$\opSimple{25}\bm{-}\opSimple{10}$}");!
 266       \par\hfill\includegraphics{CommandeStylo.8}
 267     \item[\textbullet]\lstinline!draw MettreIS(15);!
 268       \par\hfill\includegraphics{CommandeStylo.9}
 269     \item[\textbullet]\lstinline!draw AjouterTS(12);!
 270       \par\hfill\includegraphics{CommandeStylo.10}
 271     \item[\textbullet]\lstinline!draw MettreTS("\opOp{$\opSimple{15}\bm{\times}\opSimple{10}$}");!
 272       \par\hfill\includegraphics{CommandeStylo.11}
 273     \end{itemize}
 274     \vspace*{2em}\par
 275 \item[Groupe {\sffamily Données}]\hfil\newline
 276   \begin{itemize}
 277   \item[\textbullet]\lstinline!draw MettreVar("pi",0);!
 278     \par\hfill\includegraphics{CommandeVariable.1}
 279   \item[\textbullet]\lstinline!draw AjouterVar("pi","\opOp{$\opSimple{15}\bm{+}\opSimple{10}$}");!
 280     \par\hfill\includegraphics{CommandeVariable.2}
 281   \item[\textbullet]\lstinline!draw MontrerVar("pi");!
 282     \par\hfill\includegraphics{CommandeVariable.3}
 283   \item[\textbullet]\lstinline!draw CacherVar("pi");!
 284     \par\hfill\includegraphics{CommandeVariable.4}
 285   \item[\textbullet]\lstinline!draw AjouterList("\opSimple{\LaTeX}","Listepi");!
 286     \par\hfill\includegraphics{CommandeVariable.5}
 287   \item[\textbullet]\lstinline!draw SupprimerList("\opSimple{\LaTeX}","Listepi");!
 288     \par\hfill\includegraphics{CommandeVariable.6}
 289   \item[\textbullet]\lstinline!draw InsererList("\opSimple{\MP}",1,"Listepi");!
 290     \par\hfill\includegraphics{CommandeVariable.7}
 291   \item[\textbullet]\lstinline!draw RemplacerList(3,"Listepi","\opOp{$\opSimple{4}\bm{+}\opSimple{5}$}");!
 292     \par\hfill\includegraphics{CommandeVariable.8}
 293   \item[\textbullet]\lstinline!draw MontrerList("Listepi");!
 294     \par\hfill\includegraphics{CommandeVariable.9}
 295   \item[\textbullet]\lstinline!draw CacherList("Listepi");!
 296     \par\hfill\includegraphics{CommandeVariable.10}
 297   \end{itemize}
 298   \par\vspace*{2em}\par Les \og opérateurs\fg
 299   \begin{center}
 300     \begin{minipage}{0.8\linewidth}
 301       \includegraphics{CommandeVariable.11}\hfill\includegraphics{CommandeVariable.12}\hfill \includegraphics{CommandeVariable.13}\par
 302     \includegraphics{CommandeVariable.14}\hfill \includegraphics{CommandeVariable.15}
 303     \end{minipage}
 304 \end{center}
 305 s'obtiennent par les commandes \LaTeX\ \lstinline!\opVar{}!, \lstinline!\opList{}! et \lstinline!\opSousList{}!.
 306 \vspace{0.5em}
 307 \begin{center}
 308     \includegraphics{CommandeVariable.15}
 309 %  \begin{minipage}{0.6\linewidth}
 310     \begin{lstlisting}[frame=tb]
 311 label(LATEX("\opList{\opSousList{Pythagore}
 312  contient \opSimple{(3;4;5)} ?}"),(0,0));
 313     \end{lstlisting}
 314 %  \end{minipage}
 315 \end{center}
 316     \par\vspace*{2em}\par
 317 \item[Groupe {\sffamily \'Evènement}]\hfil\newline
 318   \begin{itemize}
 319   \item[\textbullet]\lstinline!draw Drapeau;!
 320     \par\hfill\includegraphics{CommandeEvenements.1}
 321   \item[\textbullet]\lstinline!draw QPresse("espace");!
 322     \par\hfill\includegraphics{CommandeEvenements.2}
 323   \item[\textbullet]\lstinline!draw QLutinPresse;!
 324     \par\hfill\includegraphics{CommandeEvenements.3}
 325   \item[\textbullet]\lstinline!draw QBasculeAR("arriere-plan1");!
 326     \par\hfill\includegraphics{CommandeEvenements.4}
 327   \item[\textbullet]\lstinline!draw QVolumeSup("Volume sonore",10);!
 328     \par\hfill\includegraphics{CommandeEvenements.5}
 329   \item[\textbullet]\lstinline!draw QRecevoirMessage("message1");!
 330     \par\hfill\includegraphics{CommandeEvenements.6}
 331   \item[\textbullet]\lstinline!draw EnvoyerMessage("message1");!
 332     \par\hfill\includegraphics{CommandeEvenements.7}
 333   \item[\textbullet]\lstinline!draw EnvoyerMessageA("message1");!
 334     \par\hfill\includegraphics{CommandeEvenements.8}
 335   \end{itemize}
 336 \vspace{1em}\par
 337 Quand \og la scène\fg\ est sélectionnée, on dispose de :
 338 \begin{itemize}
 339   \item[\textbullet]\lstinline!draw QScenePressee;!
 340     \par\hfill\includegraphics{CommandeEvenements.9}\footnote{C'est le seul endroit où il y a une majuscule dans les notations {\sffamily Scratch}\ldots}
 341 \end{itemize}
 342     \vspace*{2em}\par
 343 \item[Groupe {\sffamily Contrôle}]\hfil\newline
 344   \begin{itemize}
 345   \item[\textbullet]\lstinline!draw Attendre("\opOp{$\opSimple{10}\bm{+}\opSimple{40}$}");!
 346     \par\hfill\includegraphics{CommandeControle.1}
 347   \item[\textbullet]\lstinline!draw AttendreJ("\opOp{$\opSimple{10}\bm{+}\opMouv{Abscisse x}\bm{=}\opSimple{20}$}");!
 348     \par\hfill\includegraphics{CommandeControle.6}
 349   \item[\textbullet]\lstinline!draw Stop("ce script");!
 350     \par\hfill\includegraphics{CommandeControle.8}
 351 \newpage
 352   \item[\textbullet]\lstinline!draw CommencerClone;!
 353     \par\hfill\includegraphics{CommandeControle.9}
 354   \item[\textbullet]\lstinline!draw CreerClone("Lutin1");!
 355     \par\hfill\includegraphics{CommandeControle.10}
 356   \item[\textbullet]\lstinline!draw SupprimerClone;!
 357     \par\hfill\includegraphics{CommandeControle.11}
 358   \item[\textbullet]
 359     \begin{lstlisting}[frame=tb]
 360 draw Repeter1("\opOp{$\opSimple{10}\bm{+}\opSimple{40}$}");
 361 draw LigneVide("Bonjour");
 362 draw FinBlocRepeter1(10);
 363     \end{lstlisting}
 364     \par\hfill\includegraphics{CommandeControle.2}
 365   \item[\textbullet]
 366     \begin{lstlisting}[frame=tb]
 367 draw RepeterI1;
 368 draw LigneVide("Bonjour");
 369 draw FinBlocRepeterI1(10);
 370     \end{lstlisting}
 371     \par\hfill\includegraphics{CommandeControle.3}
 372 \par On remarquera ici la distinction \lstinline!FinBlocRepeter1! et \lstinline!FinBlocRepeterI1!. Le premier autorise une suite à l'algorithme (par la présence du cadre \og puzzle\fg), le deuxième non.
 373 \\Une deuxième remarque concerne la \og sortie\fg\ des blocs \lstinline!Repeter! (elle est aussi valable pour les blocs \lstinline!Si!\ldots\lstinline!alors!). Comme l'indique la figure \ref{fig:pbsortiebloc} et contrairement à \lstinline!Scratch!, j'ai {\em choisi}\footnote{Par commodité de programmation, par esthétique et aussi par conception de la sortie d'un tel bloc.} de ne pas faire de distinction \og puzzle / non puzzle\fg\ en fin de boucle (ou test).
 374 \begin{figure}[h!]
 375   \centering
 376   \includegraphics[width=0.5\linewidth]{Scratchpbsortiebloc-1}\hfill\includegraphics{SortieBloc.1}
 377   \caption{Comparaison Scratch / \MP\ pour l'affichage des \og sorties\fg\ de boucles et tests.}
 378   \label{fig:pbsortiebloc}
 379 \end{figure}
 380
 381 \`A noter dans le code \MP\ de cet exemple, l'utilisation du paramètre \lstinline! _coinprec ! afin de placer différentes partie d'un algorithme au sein d'une même figure \MP.
 382 \begin{lstlisting}[frame=tb]
 383   ...
 384   draw FinBlocRepeter1(10);
 385   _coinprec:=_coinprec+(0,-1cm);
 386   draw Si2("\opOp{$\opVar{i}\bm{<}10$}");
 387   ...
 388 \end{lstlisting}%
 389
 390   \item[\textbullet]
 391     \begin{lstlisting}[frame=tb]
 392 draw Si1("\opOp{$\opSimple{10}\bm{+}\opMouv{Abscisse x}%
 393 \bm{=}\opSimple{20}$}");
 394 draw LigneVide("Bonjour");
 395 draw FinBlocSi1;
 396     \end{lstlisting}
 397     \par\hfill\includegraphics{CommandeControle.4}
 398   \item[\textbullet]
 399     \begin{lstlisting}[frame=tb]
 400 draw Si1("\opOp{$\opSimple{10}\bm{+}\opMouv{Abscisse x}%
 401 \bm{=}\opSimple{20}$}");
 402 draw LigneVide("Bonjour");
 403 draw Sinon1;
 404 draw LigneVide("Bonjour");
 405 draw FinBlocSi1;
 406     \end{lstlisting}
 407     \par\hfill\includegraphics{CommandeControle.5}
 408   \item[\textbullet]
 409     \begin{lstlisting}[frame=tb]
 410 draw RepeterJ1("\opOp{$\opSimple{10}\bm{+}\opMouv{Abscisse x}%
 411  \bm{=}\opSimple{20}$}");
 412 draw LigneVide("Bonjour");
 413 draw FinBlocRepeter1(10);
 414     \end{lstlisting}
 415     \par\hfill\includegraphics{CommandeControle.7}
 416   \end{itemize}
 417 \vspace*{2em}\par
 418 \item[Groupe {\sffamily Capteurs}]\hfil\newline
 419   \begin{itemize}
 420   \item[\textbullet]\begin{filecontents*}{capteur1.txt}
 421 draw Demander("Quel est votre prénom ?");
 422 \end{filecontents*}
 423 \lstinputlisting[inputencoding=utf8/latin1]{capteur1.txt}
 424     \par\hfill\includegraphics{CommandeCapteurs.1}
 425   \item[\textbullet]\lstinline!draw ActiverVideo("active");!
 426     \par\hfill\includegraphics{CommandeCapteurs.2}
 427   \item[\textbullet]\lstinline!draw TransparenceVideo("\opOp{$\opSimple{17}\bm{+}\opSimple{25}$}");!
 428     \par\hfill\includegraphics{CommandeCapteurs.3}
 429   \item[\textbullet]\lstinline!draw ReinitChrono;!
 430     \par\hfill\includegraphics{CommandeCapteurs.4}
 431   \end{itemize}
 432 Les \og opérateurs\fg
 433   \begin{center}
 434     \begin{minipage}{0.8\linewidth}
 435       \includegraphics{CommandeCapteurs.5}\par
 436       \includegraphics{CommandeCapteurs.6}\hfill \includegraphics{CommandeCapteurs.7}\par
 437       \includegraphics{CommandeCapteurs.19}\par
 438       \includegraphics{CommandeCapteurs.20}\hfill\includegraphics{CommandeCapteurs.8}
 439 \par\includegraphics{CommandeCapteurs.9}\hfill \includegraphics{CommandeCapteurs.10}\hfill\includegraphics{CommandeCapteurs.11}
 440 \par\includegraphics{CommandeCapteurs.12}\hfill \includegraphics{CommandeCapteurs.13}\par
 441 \includegraphics{CommandeCapteurs.14}\hfill\includegraphics{CommandeCapteurs.15}
 442 \par\includegraphics{CommandeCapteurs.16}\hfill
 443       \includegraphics{CommandeCapteurs.17}\hfill\includegraphics{CommandeCapteurs.18}
 444     \end{minipage}
 445 \end{center}
 446 s'obtiennent par les commandes \LaTeX\ \lstinline!\opCap{}! et \lstinline!\opCapCap{}!.
 447 Néanmoins, il faut parfois un codage conséquent. Par exemple, voici un capteur et son code.
 448 \par\vspace{1em}\par\begin{minipage}{0.3\linewidth}
 449   \includegraphics{CommandeCapteurs.7}
 450 \end{minipage}
 451 \hfill
 452 \begin{minipage}{0.65\linewidth}
 453 \small
 454 \begin{lstlisting}[frame=tb]
 455 \opCap{couleur %
 456   \definecolor{Magenta}{rgb}{1,0,1}%
 457   \colorbox{Magenta}{\textcolor{white}{%
 458       \phantom{t}}}touche%
 459   \definecolor{LGray}{gray}{0.85}%
 460   \colorbox{LGray}{\textcolor{white}{%
 461       \phantom{t}}} ?%
 462 }
 463 \end{lstlisting}
 464 \end{minipage}
 465 \\Un peu barbare, non ? Mais, cela ne nécessitera qu'un simple copier-coller pour les autres utilisations\ldots%}
 466 \par\vspace*{2em}\par
 467 \item[Groupe {\sffamily Opérateurs}]\hfil\newline
 468 Les éléments%
 469   \begin{center}
 470     \begin{minipage}{0.8\linewidth}
 471       \includegraphics{CommandeOperateurs.1}\hfill\includegraphics{CommandeOperateurs.2}\hfill\includegraphics{CommandeOperateurs.3}\hfill
 472       \includegraphics{CommandeOperateurs.4}\par
 473       \includegraphics{CommandeOperateurs.5}\par
 474       \includegraphics{CommandeOperateurs.6}\hfill \includegraphics{CommandeOperateurs.7}\hfill\includegraphics{CommandeOperateurs.8}
 475 \par\includegraphics{CommandeOperateurs.9}\hfill \includegraphics{CommandeOperateurs.10}\hfill\includegraphics{CommandeOperateurs.11}
 476 \par\includegraphics{CommandeOperateurs.12}\hfill \includegraphics{CommandeOperateurs.13}\par
 477 \includegraphics{CommandeOperateurs.14}
 478 \par\includegraphics{CommandeOperateurs.15}\hfill\includegraphics{CommandeOperateurs.16}\hfill\includegraphics{CommandeOperateurs.17}
 479     \end{minipage}
 480 \end{center}
 481 s'obtiennent par les commandes \LaTeX\ \lstinline!\opOp{}! et \lstinline!\opSousOp{}!.
 482 \\Afin de rapprocher le package des conventions d'écriture des opérations, le choix du $\times$ à la place de * s'est imposé. Néanmoins, cela peut être discuté et modifié\ldots
 483 \vspace*{2em}\par
 484 \item[Groupe {\sffamily Ajouter blocs}]\hfil\newline
 485   \begin{itemize}
 486   \item[\textbullet]\lstinline!draw NouveauBloc("Pentagone");!
 487     \par\hfill\includegraphics{CommandeBloc.1}
 488   \item[\textbullet]\lstinline!draw NouveauBloc("Pentagone \opBloc{cote}");!
 489     \par\hfill\includegraphics{CommandeBloc.3}
 490   \item[\textbullet]\lstinline!draw Bloc("Pentagone");!
 491     \par\hfill\includegraphics{CommandeBloc.2}
 492 \end{itemize}
 493 \item[Groupe {\sffamily Divers}]\hfil\newline
 494 D'un point de vue pédagogique, il m'est apparu nécessaire d'ajouter la possibilité de donner l'illusion d'un algorithme \og vide\fg. J'ai donc créé la commande \lstinline!LigneVide! qui demande un argument simple (on pourra se reporter aux exemples du groupe {\sffamily Contrôle}\footnote{On peut obtenir le même résultat avec le paramètre \lstinline! _coinprec ! mais la précision de placement me semble plus délicate à obtenir.}).
 495 \\On aura également à disposition \lstinline!CommandeVide("Bonjour!")! afin de faire compléter un algorithme par les élèves.
 496 \begin{figure}[h]
 497   \centering
 498   \begin{minipage}{0.4\linewidth}
 499     \includegraphics{ExCommandeVide.1}
 500   \end{minipage}
 501   \hfill
 502   \begin{minipage}{0.5\linewidth}
 503 \begin{filecontents*}{CommandeVide.txt}
 504   beginfig(1);
 505   draw Drapeau;
 506   draw Repeter1(4);
 507   draw Avancer(50);
 508   draw CommandeVide("Tourner à droite%
 509  de 90 degrés");
 510   draw FinBlocRepeter1(10);
 511   endfig;
 512 \end{filecontents*}
 513 \lstinputlisting[inputencoding=utf8/latin1,frame=tb]{CommandeVide.txt}
 514   \end{minipage}
 515   \caption{Utilisation de \lstinline!CommandeVide!}
 516   \label{fig:CommandeVide}
 517 \end{figure}
 518   \end{description}
 519 Terminons cette liste de commandes par un algorithme associé à la suite de Syracuse :)
 520 \[\includegraphics[scale=0.9]{Syracuse.1}\]
 521 \begin{filecontents*}{Syracuse.txt}
 522   beginfig(1);
 523   draw Drapeau;
 524   draw SupprimerList("\opSimple{tout}","Suite");
 525   draw Demander("\opSimple{Quel est le nombre choisi ?}");
 526   draw AjouterList("\opCap{réponse}","Suite");
 527   draw MettreVar("pas",1);
 528   draw RepeterI1;
 529   draw Si2("\opOp{\opList{élément \opVar{pas} de \opSousList{Suite}} modulo \opSimple{2}%
 530 \,$\bm{=}$\,\opSimple{0}}");
 531   draw MettreVar("résultat","\opOp{\opList{élément \opVar{pas} de \opSousList{Suite}}%
 532 \,$\bm{/}$\,\opSimple{2}}");
 533   draw Sinon2;
 534   draw MettreVar("résultat","\opOp{\opSimple{3}\,$\bm{\times}$\,\opList{élément \opVar{pas}%
 535  de \opSousList{Suite}}\,$\bm{+}$\,\opSimple{1}}");
 536   draw FinBlocSi2;
 537   draw Si3("\opList{\opSousList{Suite} contient \opVar{résultat} ?}");
 538   draw Stop("tout");
 539   draw Sinon3;
 540   draw AjouterList("\opVar{résultat}","Suite");
 541   draw AjouterVar("pas",1);
 542   draw FinBlocSi3;
 543   draw FinBlocRepeter1(10);
 544 endfig;
 545 \end{filecontents*}
 546 {\footnotesize
 547 \lstinputlisting[inputencoding=utf8/latin1,frame=tb]{Syracuse.txt}
 548 }
 549 \newpage
 550 \section{Quelques exemples}
 551 \subsection{Sujet de Brevet des collèges}
 552 \vspace{-2em}
 553 %  \begin{figure}[h]
 554 %  \centering
 555 %  \includegraphics{Scratch2-2}
 556 %\caption{Figure du Sujet 0 de mathématiques du Brevet des Collèges}
 557 %\label{fig:4}
 558 %\end{figure}
 559 \begin{figure}[h]
 560   \centering
 561   \includegraphics{Scratch2-2}\par
 562   \includegraphics[scale=0.85]{Scratch2-3}\kern0.05\linewidth\includegraphics{Algo3.1}
 563   \caption{Figure du Sujet 0 - versions Scratch et \MP}
 564   \label{fig:3}
 565 \end{figure}
 566 %\begin{minipage}{0.5\linewidth}
 567 {\small
 568 \begin{lstlisting}[firstnumber=1,frame=tb]
 569 beginfig(1);
 570   draw Drapeau;
 571   draw Effacer;
 572   draw MettreTS(1);
 573   draw Repeter2(6);
 574   draw PoserStylo;
 575   draw Repeter1(4);
 576   draw Avancer(50);
 577   draw Tournerd(90);
 578   draw FinBlocRepeter1(10);
 579   draw ReleverStylo;
 580   draw AjouterTS(1);
 581   draw Avancer(60);
 582   draw FinBlocRepeter2(10);
 583 endfig;
 584   \end{lstlisting}
 585 }
 586 \newpage
 587   \subsection{\OE uvre d'art}
 588 \begin{figure}[h]
 589   \centering
 590   \includegraphics[width=0.7\linewidth]{Morellet}
 591   \label{fig:5}
 592   \caption{François Morellet - Oeuvre Pi piquant, 1=1°, 38 décimales}
 593 \end{figure}
 594 \[\includegraphics[width=0.7\linewidth]{Ex-Morellet.1}\]
 595 \begin{filecontents*}{Morellet.txt}
 596 beginfig(1)%François Morellet - Oeuvre Pi piquant, 1=1°, 38 décimales
 597   draw Drapeau;
 598   draw Effacer;
 599   draw Aller(-50,0);
 600   draw Orienter(180);
 601   draw PoserStylo;
 602   draw Tournerg("\opList{élément \opSimple{1} de \opSousList{Pi}}");
 603   draw Avancer(150);
 604   draw MettreVar("varpi","\opSimple{2}");
 605   draw RepeterJ1("\opOp{\opVar{varpi}\,$\bm{>}$\,38}");
 606   draw Si2("$\opOp{\opVar{varpi}\mbox{ modulo }\opSimple{2}\,=\,\opSimple{0}}$");
 607   draw Tournerg("$\opOp{\opSimple{180}}\bm{-}\opList{élément \opVar{varpi}
 608  de \opSousList{pi}}$");
 609   draw Sinon2;
 610   draw Tournerd("$\opOp{\opSimple{180}}-\opList{élément \opVar{varpi} de \opSousList{pi}}$");
 611   draw FinBlocSi2;
 612   draw Avancer(150);
 613   draw AjouterVar("varpi","\opSimple{1}");
 614   draw FinBlocRepeter1(10);
 615   draw ReleverStylo;
 616 endfig;
 617 \end{filecontents*}
 618 {\footnotesize
 619 \lstinputlisting[inputencoding=utf8/latin1,frame=tb]{Morellet.txt}
 620 }
 621 \newpage
 622 \subsection{Une \og spirale\fg}
 623     \begin{figure}[h!]
 624       \centering
 625 \begin{minipage}{0.4\linewidth}
 626       \[\includegraphics[scale=0.8]{ex-tice74.1}\]
 627 {\tiny Source : \url{http://www.ac-grenoble.fr/tice74/spip.php?article1219}}
 628 \end{minipage}
 629 \hfill
 630 \begin{minipage}{0.55\linewidth}
 631   \begin{lstlisting}[frame=tb]
 632 beginfig(1);
 633   draw Drapeau;
 634   draw ReleverStylo;
 635   draw Aller(0,0);
 636   draw Orienter(90);
 637   draw PoserStylo;
 638   draw MettreVar("i",1);
 639   draw RepeterJ1("\opOp{$\opVar{i}\bm{=}%
 640     \opSimple{200}$}");
 641   draw Avancer("\opVar{i}");
 642   draw AjouterVar("i",1);
 643   draw Tournerd(121);
 644   draw FinBlocRepeter1(10);
 645 endfig;
 646   \end{lstlisting}
 647 \end{minipage}
 648       \caption{Figure géométrique - Code Scratch}
 649       \label{fig:10}
 650     \end{figure}
 651 \[\includegraphics[scale=1]{ex-tice74-scratch.1}\]
 652 \newpage
 653 \subsection{Triangle de Sierpinski}
 654 \begin{figure}[h]
 655   \centering
 656   \includegraphics[scale=0.5]{Ex-Serpinski.1}\par
 657   \includegraphics{Ex-Serpinski-scratch.1}
 658   \caption{Triangle de Sierpinski - Code Scratch et \MP}
 659   \label{fig:11}
 660 \end{figure}
 661 %\begin{lstlisting}[frame=tb]
 662 \begin{filecontents*}{Sierpinski.txt}
 663 beginfig(1);%https://sites.google.com/site/stjomaths/scratch
 664   draw Drapeau;
 665   draw Aller(-200,-150);
 666   draw Orienter(0);
 667   draw Effacer;
 668   draw PoserStylo;
 669   draw Demander("\opSimple{rang ?}");
 670   draw MettreVar("rang","\opCap{réponse}");
 671   draw Demander("\opSimple{dimension du motif ?}");
 672   draw MettreVar("rang","\opCap{réponse}");
 673   draw Bloc("Sierpinski \opBloc{rang} \opBloc{triangles}");
 674   _coinprec:=(8.5cm,0);
 675   draw NouveauBloc("Sierpinski \opBloc{rang} \opBloc{triangles}");
 676   draw Si1("\opOp{non $\opBloc{rang}\bm{=}0$}");
 677   draw Repeter2(3);
 678   draw Bloc("Sierpinski \opOp{$\opBloc{rang}\bm{-}\opSimple{1}$}%
 679  \opOp{$\opBloc{triangles}\,\bm{/}\,\opSimple{2}$}");
 680   draw Avancer("\opBloc{triangles}");
 681   draw Tournerd(120);
 682   draw FinBlocRepeter2(10);
 683   draw FinBlocSi1;
 684 endfig;
 685 \end{filecontents*}
 686 %\end{lstlisting}
 687 {\footnotesize
 688 \lstinputlisting[inputencoding=utf8/latin1,frame=tb]{Sierpinski.txt}
 689 }
 690 \newpage
 691 \section{Historique}
 692 \begin{description}
 693 \item[16/02/2017] {\bfseries Version 0.59} - Correction des commandes {\sffamily Dire}, {\sffamily DireT}, {\sffamily Penser}, {\sffamily PenserT}. Mise à jour de la documentation (informations sur l'installation du package).
 694 \item[15/02/2017] {\bfseries Version 0.57} - Correction de problèmes mineurs d'affichage. Correction de la documentation.
 695 \item[14/02/2017] {\bfseries Version 0.55} - Mise à jour de la documentation.
 696   \item[13/02/2017] {\bfseries Version 0.53} - Ajout des chanfreins sur les blocs. Correction de \og doublons\fg\ de commandes. Mise à jour de la documentation.
 697   \item[05/02/2017] {\bfseries Version 0.51} - Sur les conseils de Maxime Chupin et Thierry Pasquier, travail sur les couleurs (mise en accord avec celles de Scratch et personnalisation possible). Passage des majuscules aux minuscules pour les blocs.
 698   \item[21/01/2017] {\bfseries Version 0.5} - Publication sur \url{www.melusine.eu.org/syracuse/}
 699   \item[19/01/2017] {\bfseries Version 0.32} - Ajout d'éléments de présentation ($\blacktriangledown$).
 700   \item[18/01/2017] {\bfseries Version 0.31} - Ajout du groupe {\sffamily Son}.
 701   \item[15/01/2017] {\bfseries Version 0.3} - Modification du code. Conception de la documentation.
 702   \item[08/01/2017] {\bfseries Version 0.2} - Ajout des commandes des groupes {\sffamily Données} et {\sffamily Capteurs}.
 703   \item[06/01/2017] {\bfseries Version 0.15} - Ajout des commandes du groupe {\sffamily Ajouter blocs}.
 704   \item[05/01/2017] {\bfseries Version 0.1} - Sont disponibles les commandes des groupes {\sffamily Mouvement}, {\sffamily Apparence}, {\sffamily Stylo}, {\sffamily Évènements}, {\sffamily Contrôle}.
 705 \end{description}
 706 \end{document}