Cette page présente toutes les possibilités d'actions de l'équerre dans un script Instrumenpoche. Ce sont les nœuds XML de la forme :
<action objet="equerre" mouvement="..." ... />
Comme tous les instruments, l'équerre peut être masquée avec :
<action objet="equerre" mouvement="masquer" />
Elle est montrée avec :
<action objet="equerre" mouvement="montrer" />
Il est possible de faire apparaître l'é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="equerre" mouvement="montrer" abscisse="200" ordonnee="350" />
Les coordonnées de l'équerre sont celles du sommet de son angle droit.
L'équerre peut être déplacée jusqu'à un point en utilisant :
<action objet="equerre" mouvement="translation" abscisse="200" ordonnee="350" />
Un attribut vitesse peut être précisé, il donne le nombre de pixels de déplacement de l'équerre par dixième de seconde. La valeur par défaut est 8.
<action objet="equerre" mouvement="translation" abscisse="200" ordonnee="350" vitesse="10" />
Elle peut également pivoter autour de son angle droit :
<action objet="equerre" 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 l'é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 l'équerre pivote à chaque dixième de seconde. L'attribut angle donne l'angle que va faire l'équerre avec l'horizontale à la fin de sa rotation.
Si un point a été créé auparavant, l'é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="equerre" /> <action cible="1" mouvement="translation" objet="equerre" /> </INSTRUMENPOCHE>
Ceci est également valable pour la rotation :
<action cible="1" mouvement="rotation" objet="equerre" />
La taille de l'é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 l'équerre ait le double de sa taille normale :
<action echelle="200" mouvement="zoom" objet="equerre" />