======  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 :
<code XML><action objet="requerre" mouvement="..." ... /></code>
===== Déplacement, apparition =====

Comme tous les instruments,  la règle-équerre peut être masquée avec :
<code XML><action objet="requerre" mouvement="masquer" /></code>
Elle est montrée avec :
<code XML><action objet="requerre" mouvement="montrer" /></code>
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 [[script:coordonnees|coordonnées]] de cet endroit, par exemple :
<code XML><action objet="requerre" mouvement="montrer" abscisse="200" ordonnee="350" /></code>
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 :
<code XML><action objet="requerre" mouvement="translation" abscisse="200" ordonnee="350" /></code>
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.
<code XML><action objet="requerre" mouvement="translation" abscisse="200" ordonnee="350" vitesse="10" /></code>
Elle peut également pivoter autour du point marqué :
<code XML><action objet="requerre" mouvement="rotation" angle="90" sens="-5" /></code>
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 [[:script: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**
<code XML>
<?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></code>

Ceci est également valable pour la rotation :
<code XML>
<action cible="1" mouvement="rotation" objet="requerre" />
</code>



===== 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 :
<code XML><action echelle="200" mouvement="zoom" objet="requerre" />
</code>
===== Glissement de l'équerre =====
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.
<code XML>
<action abscisse="-100" mouvement="glisser" objet="requerre" />
</code>

===== Voir aussi =====
   * [[:interface:equerre]] pour voir comment manipuler  la règle-équerre avec la souris.
   * [[http://instrumenpoche.sesamath.net/documentation_classes/EquerreIep.html|La classe EquerreIep]] présente les données à connaître pour programmer la règle-équerre depuis une autre application.