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 :

<action objet="rapporteur" mouvement="..." ... />

Comme tous les instruments, le rapporteur peut être masqué avec :

<action objet="rapporteur" mouvement="masquer" />

Il est montré avec :

<action objet="rapporteur" mouvement="montrer" />

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 coordonnées de cet endroit, par exemple :

<action objet="rapporteur" mouvement="montrer" abscisse="200" ordonnee="350" />

Les coordonnées du rapporteur sont celles de son centre.

Le rapporteur peut être déplacé jusqu'à un point en utilisant :

<action objet="rapporteur" mouvement="translation" abscisse="200" ordonnee="350" />

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.

<action objet="rapporteur" mouvement="translation" abscisse="200" ordonnee="350" vitesse="10" />

Il peut également pivoter autour de son centre :

<action objet="rapporteur" 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 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 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

<?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>

Ceci est également valable pour la rotation :

<action cible="1" mouvement="rotation" objet="rapporteur" />

On peut masquer la deuxième série de graduations du rapporteur par :

<action mouvement="vide" objet="rapporteur" />

et la faire apparaître par :

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

Il est possible de masquer les nombres accompagnant les graduations, et de les faire réapparaître, par le code :

<action mouvement="masquer_nombres" objet="rapporteur" />
<action mouvement="montrer_nombres" objet="rapporteur" />

Par défaut, le rapporteur est en forme de demi-cercle. Il est possible d'obtenir un rapporteur circulaire avec

<action mouvement="circulaire" objet="rapporteur" />

et de le rendre semi-circulaire avec

<action mouvement="semicirculaire" objet="rapporteur" />

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 :

<action echelle="200" mouvement="zoom" objet="rapporteur" />

• rapporteur pour voir comment manipuler le rapporteur avec la souris.
• La classe RapporteurIep présente les données à connaître pour programmer le rapporteur depuis une autre application.