Cette page présente toutes les possibilités d'actions de la règle-équerre dans un script Instrumenpoche. Ce sont les nœuds XML de la forme :
<action objet="requerre" mouvement="..." ... />
Comme tous les instruments, la règle-équerre peut être masquée avec :
<action objet="requerre" mouvement="masquer" />
Elle est montrée avec :
<action objet="requerre" mouvement="montrer" />
Il est possible de faire apparaître la règle-équerre à 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="requerre" mouvement="montrer" abscisse="200" ordonnee="350" />
Les coordonnées de la règle-équerre sont celles du point marqué par un trait, sur la règle.
La règle-équerre peut être déplacée jusqu'à un point en utilisant :
<action objet="requerre" 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-équerre par dixième de seconde. La valeur par défaut est 8.
<action objet="requerre" mouvement="translation" abscisse="200" ordonnee="350" vitesse="10" />
Elle peut également pivoter autour du point marqué :
<action objet="requerre" 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-équerre 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-équerre pivote à chaque dixième de seconde. L'attribut angle donne l'angle que va faire la règle de la règle-équerre avec l'horizontale à la fin de sa rotation.
Si un point a été créé auparavant, la règle-équerre 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="requerre" /> <action cible="1" mouvement="translation" objet="requerre" /> </INSTRUMENPOCHE>
Ceci est également valable pour la rotation :
<action cible="1" mouvement="rotation" objet="requerre" />
La taille de la règle-équerre est modifiable avec un attribut mouvement égal “zoom”. Il faut alors préciser un attribut “echelle” qui donne la taille voulue, en pourcentage de la taille normale.
Exemple pour que la règle-équerre ait le double de sa taille normale :
<action echelle="200" mouvement="zoom" objet="requerre" />
Pour faire glisser l'équerre de la règle-équerre le long de la règle, on utilise un attribut mouvement égal à “glisser”, muni d'un attribut obligatoire “abscisse” qui donne la position finale de l'équerre dans le repère formé par le côté de la règle, le zéro correspondant au point marqué par un trait sur la règle.
<action abscisse="-100" mouvement="glisser" objet="requerre" />