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

Comme tous les instruments,  l'équerre peut être masquée avec :
<code XML><action objet="equerre" mouvement="masquer" /></code>
Elle est montrée avec :
<code XML><action objet="equerre" mouvement="montrer" /></code>
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 [[script:coordonnees|coordonnées]] de cet endroit, par exemple :
<code XML><action objet="equerre" mouvement="montrer" abscisse="200" ordonnee="350" /></code>
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 :
<code XML><action objet="equerre" mouvement="translation" abscisse="200" ordonnee="350" /></code>
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.
<code XML><action objet="equerre" mouvement="translation" abscisse="200" ordonnee="350" vitesse="10" /></code>
Elle peut également pivoter autour de son angle droit :
<code XML><action objet="equerre" 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  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 [[:script: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**
<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="equerre" />
<action cible="1" mouvement="translation" objet="equerre" />
</INSTRUMENPOCHE></code>

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



===== Modification de taille =====
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 :
<code XML><action echelle="200" mouvement="zoom" objet="equerre" />
</code>

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