Il est possible de paramétrer instrumenpoche pour que, dès son apparition, le logiciel ait un certain comportement : limitation du nombre de boutons disponibles, instruments “cassés” ou fixes…

Instrumenpoche est un fichier Flash qui peut être inséré dans une page HTML ou une autre application Flash.

On peut peut insérer instrumenpoche “simplement” afin d'avoir toutes les fonctionnalités du logiciel comme sur la page Utiliser en ligne, mais on peut aussi lui passer deux paramètres essentiels :

• un script décrivant une animation,
• un script de paramétrage.

Chacun de ces deux paramètres peut être passé de deux façons différentes à instrumenpoche : soit en donnant un URL vers un fichier, soit en donnant directement le code XML voulu.

La variable donnant un chemin vers une script XML doit s'appeler anim (et iep_anim si on veut donner le contenu du script), la variable pour un fichier de configuration s'appelle config (et iep_config si on préfère donner le contenu). Pour la configuration, lorsque Instrumenpoche est appelé depuis une autre application Flash, on peut aussi utiliser un objet appelé iep_parametres.

Si on insère instrumenpoche dans une page HTML sans javascript, on le fait avec le code suivant :

<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" 
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,0,0" 
width="800" height="600" id="iep" align="middle">
<param name="allowScriptAccess" value="always" />
<param name="allowFullScreen" value="true" />
<param name="movie" value="iep.swf" />
<param name="quality" value="high" />
<param name="flashvars" value="anim=mon_anim.xml&config=ma_config.xml" />
<param name="bgcolor" value="#ffffff" />
<embed src="iep.swf"  quality="high" bgcolor="#ffffff" 
   width="800" height="600" name="iep" align="middle" flashvars="anim=mon_anim.xml&config=ma_config.xml"
   wmode="window" allowScriptAccess="always" allowFullScreen="true" 
   type="application/x-shockwave-flash" pluginspage="http://www.adobe.com/go/getflashplayer_fr" />
</object>

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.

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.

Si on insère instrumenpoche 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.

Pour la syntaxe des scripts décrivant les animations, voir la rubrique "script".

Les paramètres disponibles sont ceux contenus dans la classe Instrumenpoche.as.

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

<nom1>nom2</nom1>

Si on veut passer plusieurs paramètres de la forme options_nom1_XXX à true, on les écrit dans le même nœud en les séparant par une virgule.

Exemple Pour que le rapporteur soit fixe et apparaisse avec une double graduation (Instrumenpoche.options_rapporteur_fixe et Instrumenpoche.options_rapporteur_double égaux à true), on code :

<rapporteur>fixe,double</rapporteur>

Lecture Pour obtenir instrumenpoche en mode “lecture” classique, un raccourci est disponible : config=“config_lecture”.

<?xml version="1.0" encoding="UTF-8"?>
<INSTRUMENPOCHE version="2" >
<mode>exercice,6</mode>
<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

Ligne 1 Le code ci-dessus va mettre instrumenpoche en mode exercice (qui est un synonyme du mode geometrie) et se placer après la 6ème action de l'animation chargée par ailleurs.

Ligne 2 Le seul instrument accessible par le menu est le crayon.

Ligne 3 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 4 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).