Ceci est une ancienne révision du document !
Table des matières
La règle-équerre
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="..." ... />
Déplacement, apparition
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 sommet de son angle droit.
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 de son angle droit :
<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-é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" />
Modification de taille
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" />
Voir aussi
- equerre pour voir comment manipuler la règle-équerre avec la souris.
- La classe EquerreIep présente les données à connaître pour programmer la règle-équerre depuis une autre application.