====== Le rapporteur ======
Cette page présente toutes les possibilités d'actions du rapporteur dans un script Instrumenpoche. Ce sont les nœuds XML de la forme :
<code XML><action objet="rapporteur" mouvement="..." ... /></code>
===== Déplacement, apparition =====

Comme tous les instruments, le rapporteur peut être masqué avec :
<code XML><action objet="rapporteur" mouvement="masquer" /></code>
Il est montré avec :
<code XML><action objet="rapporteur" mouvement="montrer" /></code>
Il est possible de faire apparaître le rapporteur à 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="rapporteur" mouvement="montrer" abscisse="200" ordonnee="350" /></code>
Les coordonnées du rapporteur sont celles de son centre.

Le rapporteur peut être déplacé jusqu'à un point en utilisant :
<code XML><action objet="rapporteur" mouvement="translation" abscisse="200" ordonnee="350" /></code>
Un attribut ''vitesse'' peut être précisé, il donne le nombre de pixels de déplacement du rapporteur par dixième de seconde. La valeur par défaut est 8.
<code XML><action objet="rapporteur" mouvement="translation" abscisse="200" ordonnee="350" vitesse="10" /></code>
Il peut également pivoter autour de son centre :
<code XML><action objet="rapporteur" 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 le rapporteur 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 le rapporteur pivote à chaque dixième de seconde. L'attribut ''angle'' donne l'angle que va faire le rapporteur avec l'horizontale à la fin de sa rotation.

Si un [[:script:point]] a été créé auparavant, le rapporteur peut être déplacé 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="rapporteur" />
<action cible="1" mouvement="translation" objet="rapporteur" />
</INSTRUMENPOCHE></code>

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



===== Modification : graduations, taille et forme =====
On peut masquer la deuxième série de graduations du rapporteur par :
<code XML><action mouvement="vide" objet="rapporteur" />
</code>
et la faire apparaître par :

<code XML>
<action mouvement="graduations" objet="rapporteur" />
</code>

Il est possible de masquer les nombres accompagnant les graduations, et de les faire réapparaître, par le code :
<code XML>
<action mouvement="masquer_nombres" objet="rapporteur" />
<action mouvement="montrer_nombres" objet="rapporteur" />
</code>

Par défaut, le rapporteur est en forme de demi-cercle. Il est possible d'obtenir un rapporteur circulaire avec 
<code XML>
<action mouvement="circulaire" objet="rapporteur" />
</code>
et de le rendre semi-circulaire avec
<code XML>
<action mouvement="semicirculaire" objet="rapporteur" />
</code>

La taille du rapporteur 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 le rapporteur ait le double de sa taille normale :
<code XML><action echelle="200" mouvement="zoom" objet="rapporteur" />
</code>

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