====== Codage de longueur ======
Cette page présente toutes les possibilités d'actions sur les codages de longueur dans un script Instrumenpoche. Ce sont les nœuds XML de la forme :
<code XML><action objet="longueur" mouvement="..." ... /></code>

==== Création ====

Pour pouvoir être utilisé dans Instrumenpoche, un codage de longueur doit d'abord être "créé", avec un identifiant (attribut ''id'').

L'action minimale pour créer un codage de longueur est donc :
<code XML>
<action id="1" mouvement="creer" objet="longueur" />
</code>

Si on veut que le codage apparaisse directement à un certain endroit de la scène, on précise les attributs ''abscisse'' et ''ordonnee'' (égaux à 0 par défaut). On peut également préciser un attribut ''[[:couleurs|couleur]]'' (égal à "noir" par défaut) :
<code XML>
<action ordonnee="200" abscisse="300" couleur="bleu" id="2" mouvement="creer" objet="longueur" />
</code>

On peut faire en sorte que le codage ne puisse pas être déplacé à la souris en ajoutant ''fixe="true"'' dans le nœud XML.

Par défaut,  un codage de longueur apparaît comme un trait oblique : /. Il est possible de lui donner, à la création, une autre forme en utilisant l'attribut ''forme''. Les valeurs possibles sont : "/","//","///","\\","\\\\","\\\\\\","X", "O", "]" et "[". Chaque valeur correspond à la forme que l'on verra : "O" (la lettre O) donnera un rond vide, "X" une croix (c'est la forme par défaut), "]" et "[" sont utiles pour dessiner des intervalles. Les valeurs "\\","\\\\","\\\\\\" sont doubles car le caractère "\" est un caractère d'"échappement", ainsi "\\" donnera un seul trait, "\\\\" deux traits, etc.

==== Apparition, disparition ====
Dès qu'un codage de longueur est créé, il apparaît sur la scène. Il est possible de le masquer, puis de faire réapparaître, avec les nœuds XML suivants (l'attribut ''id'' obligatoire permettant d'identifier un longueur précis) :
<code XML>
<action id="2" mouvement="masquer" objet="longueur" />
<action id="2" mouvement="montrer" objet="longueur" />
</code>
==== Déplacement ====

Comme tous les objets, un codage peut être déplacé par un attribut ''translation'' auquel on adjoint des attributs ''abscisse'' et ''ordonnee'' désignant le lieu où on veut l'envoyer, avec éventuellement un attribut ''vitesse'' : 

**Exemple** Pour que le déplacement soit instantané, on définit ''vitesse'' sur un grand nombre :

<code XML>
<action abscisse="462.1" ordonnee="252" 
     id="2" mouvement="translation" objet="longueur" 
     vitesse="1000"/>
</code>

Les coordonnées d'un codage de longueur sont celles de sont centre. Par exemple pour un codage de la forme "/" les coordonnées sont celles du milieu du segment.

===== Voir aussi =====
   * [[:interface:codage]] pour apprendre comment créer et manipuler des codages à la souris ;
   * [[script:angle]] pour apprendre la partie du script instrumenpoche concernant les codages d'angles ;
   * [[script:angle_droit]] pour apprendre la partie du script instrumenpoche concernant les codages d'angles droits.