Différences

Ci-dessous, les différences entre deux révisions de la page.

--- developpeurs:parametrage [26/04/2011 12:55] – lzamo
+++ developpeurs:parametrage [04/08/2011 14:42] (Version actuelle) – correction lien lzamo
@@ Ligne 31: / Ligne 31: @@
 </code>
-Où on reconnaît le code ''anim=mon_anim.xml&config=ma_config.xml'' qui donne un lien vers un fichier d'animation ''mon_anim.xml'' et un fichier de configuration ''ma_config.xml''.
+Où on reconnaît deux paramètres ''flashvars'' (qui servent à passer des paramètres à une animation Flash) le code ''anim=mon_anim.xml&config=ma_config.xml'' qui donne un lien vers un fichier d'animation ''mon_anim.xml'' et un fichier de configuration ''ma_config.xml''.
+Il est également possible de passer ces paramètres après l'URL d'instrumenpoche. Au lieu de ''flashvars'', on aura ''<param name="movie" value="iep.swf?anim=mon_anim.xml&config=ma_config.xml" />'' et ''src="iep.swf?anim=mon_anim.xml&config=ma_config.xml"''
+**Note.** Dans la page HTML, les paramètres ''anim'', ''config'', etc doivent apparaître deux fois et les valeurs qui leur sont passées sont données sans guillemets. En cas de texte complet (paramètres ''iep_anim'' ou ''iep_config''), les textes doivent être "échappés" au format URL.
 ==== Dans une autre animation Flash ====
 Si on insère instrumenpoche [[:tutoriels:application_contenant_iep|dans une application Flash]], on peut d'abord créer une variable texte ''anim'' qui donnera le chemin vers un script XML d'animation, et une variable ''config'' qui donnera le chemin vers un script de configuration.
+On peut également donner le texte XML de l'animation dans une variable ''iep_anim'', le texte XML de la configuration dans une variable ''iep_config''.
+Mais il est en plus possible de créer un objet ''iep_parametres'' pour le paramétrage, dont les enfants (noms et valeurs) seront identiques à ceux de la classe Instrumenpoche.as :
+<code>
+var iep_parametres:Object = new Object();
+iep_parametres.boutons_lecteur = new Array("debut",
+      "precedente", "pause", "lecture",
+      "boucle", "suivante", "fin","fermer");
+iep_parametres.geometrie = false;
+</code>
+Tout cela doit être fait avant le chargement d'instrumenpoche.
 ===== Syntaxe du paramétrage =====
 Pour la syntaxe des scripts décrivant les animations, voir [[:script:start|la rubrique "script"]].
-Les paramètres disponibles sont ceux contenus dans la classe [[http://instrumenpoche.sesamath.net/documentation_classes/Instrumenpoche.html/Instrumenpoche.html|Instrumenpoche.as]].
+Les paramètres disponibles sont ceux contenus dans la classe [[http://instrumenpoche.sesamath.net/documentation_classes/Instrumenpoche.html|Instrumenpoche.as]] et dont le nom commence par ''options_''.
 Un fichier de configuration d'instrumenpoche est au format XML. Les paramètres qui sont de la forme ''options_nom1_nom2'' avec une valeur par défaut de ''false'' dans ''Instrumenpoche.as'' peuvent passer à ''true'' par un nœud XML de la forme
@@ Ligne 50: / Ligne 69: @@
 <rapporteur>fixe,double</rapporteur>
 </code>
+Pour les autres, qui apparaissent sous la forme ''parametre=valeur'' dans ''Instrumenpoche.as'', on écrit :
+<code XML><parametre>valeur</parametre></code>
+**Exemple**
+<code XML><debuter>15</debuter></code>
+va débuter l'animation à la quinzième étape.
+**Lecture**
+Pour obtenir instrumenpoche en mode "lecture" classique, un raccourci est disponible : ''config="config_lecture"''.
+==== Exemple complet ====
+On veut créer un exercice tout simple : une figure avec deux points O et I est tracée, et on demande à l'élève de tracer au crayon le segment [OI].
+Cet exemple est [[http://instrumenpoche.sesamath.net/v2/exercices/base/segment.html|visible en ligne]]. Si on examine le code source de la page HTML, on voit qu'elle appelle Instrumenpoche par le code
+<code HTML>
+'../../iep.swf?config=longueur_segment_config.xml&anim=longueur_segment_anim.xml'
+</code>
+Donc Instrumenpoche va se charger avec [[http://instrumenpoche.sesamath.net/v2/exercices/base/segment_anim.xml|une animation]] et [[http://instrumenpoche.sesamath.net/v2/exercices/base/segment_config.xml|une configuration]] accessibles en ligne.
+L'animation chargée est
+<code XML http://instrumenpoche.sesamath.net/v2/exercices/base/segment_anim.xml>
+<?xml version="1.0" encoding="UTF-8"?>
+<INSTRUMENPOCHE>
+<action mouvement="creer" objet="point" id="3" abscisse="200" ordonnee="300" options="fixe" />
+<action mouvement="nommer" objet="point" id="3" nom="O" />
+<action mouvement="creer" objet="point" id="4" abscisse="300" ordonnee="300" options="fixe" />
+<action mouvement="nommer" objet="point" id="4" nom="I" />
+<action mouvement="creer" objet="texte" id="5" abscisse="100" ordonnee="50" options="fixe" />
+<action mouvement="ecrire" objet="texte" id="5" texte="Trace le segment [OI]." />
+</INSTRUMENPOCHE>
+</code>
+où on affiche deux points O et I et le texte de la consigne : "Trace le segment [OI].".
+<code XML http://instrumenpoche.sesamath.net/v2/exercices/base/segment_config.xml>
+<?xml version="1.0" encoding="UTF-8"?>
+<INSTRUMENPOCHE version="2" >
+<instruments>crayon</instruments>
+<boutons_geometrie>annuler,restaurer,valider</boutons_geometrie>
+<point>sansinstrument,sanstrace,sanscoordonnees,fixe</point>
+<dossier>../../</dossier>
+<test objet="segment_crayon"
+   abscisse1="200" ordonnee1="300"
+   abscisse2="300" ordonnee2="300"
+   precision="5"
+   resultat_0="Faux ! Recommencez." resultat_1="Bien !"
+   resultat="Je ne comprends pas..." />
+</INSTRUMENPOCHE>
+</code>
+Comme le fichier de configuration ne précise pas de ''mode'', instrumenpoche va rester en mode "géométrie" (utilisation des instruments) et se caler sur la fin de l'animation chargée, qui servira d'énoncé de l'exercice.
+**Ligne 1**
+Le seul instrument accessible par le menu est le crayon.
+**Ligne 2**
+En plus du bouton permettant de sélectionner ou masquer le crayon, on donne les boutons permettant d'annuler ou restaurer les dernières actions effectuées et le bouton qui valide la construction effectuée.
+Cette validation sera effectuée à l'aide des données de la ligne ''<test>...</test>'' située plus bas.
+**Ligne 3** On ne peut pas déplacer d'instrument sur un point en s'aidant du clic droit (''sansinstrument'') ni tracer de point à point (''sanstrace'') et les points ne peuvent pas être déplacés (''fixe''). Lorsqu'un point est survolé à la souris, ses coordonnées ne sont pas affichées par Instrumenpoche (''sanscoordonnees'').
+**Ligne 4** Par rapport à la page HTML, le fichier d'instrumenpoche ''iep.swf'' est situé deux étages au-dessus dans l'arborescence. Il faut le préciser, car cette arborescence est la même pour les fichiers de la configuration et de l'animation.
+**Ligne 5** Un test. Ce test utilise les fonctions de [[http://instrumenpoche.sesamath.net/documentation_classes/TestIep.html|la classe TestIep.as]]. ''resultat_0'' est le message qui sera affiché si le test renvoie le nombre 0, ''resultat_1'' le message affiché si le test renvoie 1.