Cette page présente toutes les possibilités d'actions du compas dans un script Instrumenpoche. Ce sont les nœuds XML de la forme :

<action objet="compas" mouvement="..." ... />

Comme tous les instruments, le compas peut être masqué avec :

<action objet="compas" mouvement="masquer" />

Il est montré avec :

<action objet="compas" mouvement="montrer" />

Il est possible de faire apparaître le compas à un autre endroit de la scène que celui qui est prévu par défaut en précisant les coordonnées de cet endroit, par exemple :

<action objet="compas" mouvement="montrer" abscisse="200" ordonnee="350" />

Les coordonnées du compas sont celles de l'extrémité de sa pointe.

Le compas peut être déplacé jusqu'à un point en utilisant :

<action objet="compas" mouvement="translation" abscisse="200" ordonnee="350" />

Un attribut vitesse peut être précisé, il donne le nombre de pixels de déplacement du compas par dixième de seconde. La valeur par défaut est 8.

<action objet="compas" mouvement="translation" abscisse="200" ordonnee="350" vitesse="10" />

Si un point d'Instrumenpoche a été créé auparavant, on peut déplacer le compas jusqu'à ce point en utilisant l'attibut “cible” :

<action ordonnee="392.05" abscisse="113.45" couleur="noir" id="1" mouvement="creer" objet="point" />
<action mouvement="montrer" objet="compas" />
<action cible="1" mouvement="translation" objet="compas" />

Le compas peut pivoter autour le l'extrémité de sa mine. Dans ce cas, l'attribut mouvement doit prendre la valeur “rotation” et doit être accompagné des deux attributs : angle et sens.

angle précise l'angle, mesuré en degrés, que formera le compas à la fin de la rotation avec la verticale, contrairement aux autres instruments pour lesquels l'angle est mesuré par rapport à l'horizontale.

sens précise à la fois le sens de rotation et sa vitesse : si sens est positif, le compas tourne dans le sens des aiguilles d'une montre, et dans l'autre sens si sens est négatif. La valeur absolue de sens donne la vitesse de rotation, en degrés par dixième de seconde.

Le code ci-dessous montre le compas et le fait pivoter pour qu'il se trouve à l'horizontale, sa “tête” tournée vers la droite.

<?xml version="1.0" encoding="UTF-8"?><INSTRUMENPOCHE version="2">
<action mouvement="montrer" objet="compas" />
<action sens="5" angle="90" mouvement="rotation" objet="compas" />
</INSTRUMENPOCHE>

L'écartement du compas est modifié en utilisant mouvement=“ecarter” et en ajoutant un attribut ecart dont la valeur sera la distance voulue entre la pointe et la mine du compas, exprimée en pixels.

Par exemple, pour obtenir un écart de 6 cm (en considérant qu'un cm mesure trente pixels) :

<action ecart="180" mouvement="ecarter" objet="compas" />

Si ecart n'est pas un nombre compris entre 0 et 410, Instrumenpoche ignore ce mouvement.

* La classe CompasIep.as, pour les développeurs.