Ceci est une ancienne révision du document !
Table des matières
Paramétrage
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…
Le principe
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
.
Dans une page HTML
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
.
Dans une autre animation Flash
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.
Syntaxe du paramétrage
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>