Cette page présente toutes les possibilités d'actions de la règle dans un script Instrumenpoche. Ce sont les nœuds XML de la forme :
<action objet="regle" mouvement="..." ... />
Comme tous les instruments, la règle peut être masquée avec :
<action objet="regle" mouvement="masquer" />
Elle est montrée avec :
<action objet="regle" mouvement="montrer" />
Il est possible de faire apparaître la règle à 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="regle" mouvement="montrer" abscisse="200" ordonnee="350" />
Les coordonnées de la règle sont celles du zéro des graduations.
La règle peut être déplacée jusqu'à un point en utilisant :
<action objet="regle" mouvement="translation" abscisse="200" ordonnee="350" />
Un attribut vitesse peut être précisé, il donne le nombre de pixels de déplacement de la règle par dixième de seconde. La valeur par défaut est 8.
<action objet="regle" mouvement="translation" abscisse="200" ordonnee="350" vitesse="10" />
Elle peut également pivoter autour du zéro :
<action objet="regle" mouvement="rotation" angle="90" sens="-5" />
L'attribut sens est similaire à l'attribut vitesse pour une translation. Cependant, sens peut être négatif. Une valeur positive permet de faire pivoter la règle dans le sens des aiguilles d'une montre, une valeur négative dans l'autre sens. La valeur absolue de sens indique le nombre de degrés dont la règle pivote à chaque dixième de seconde. L'attribut angle donne l'angle que va faire la règle avec l'horizontale à la fin de sa rotation.
Si un point a été créé auparavant, la règle peut être déplacée jusqu'à ce point en utilisant l'attribut cible qui devra être égal à l'id du point voulu.
Exemple
<?xml version="1.0" encoding="UTF-8"?> <INSTRUMENPOCHE version="2"> <action ordonnee="243.5" abscisse="292.8" couleur="noir" id="1" mouvement="creer" objet="point" /> <action mouvement="montrer" objet="regle" /> <action cible="1" mouvement="translation" objet="regle" /> </INSTRUMENPOCHE>
Ceci est également valable pour la rotation :
<action cible="1" mouvement="rotation" objet="regle" />
On peut masquer les graduations de la règle par :
<action mouvement="vide" objet="regle" />
et les faire apparaître par :
<action mouvement="graduations" objet="regle" />
Par défaut, la règle mesure 15 centimètres. On peut modifier cette donnée par
<action mouvement="modifier_longueur" objet="regle" longueur="..."/>
où longueur donne la longueur voulue pour la règle, en centimètres. La valeur maximale est de 30 cm. Cette longueur est celle des graduations de la règle, l'instrument lui-même étant un peu plus long.