Cette page présente toutes les possibilités d'actions sur un repère du plan dans un script Instrumenpoche. Ce sont les nœuds XML de la forme :

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

Un nœud XML de création doit être de cette forme, avec un attribut mouvement égal à “creer” :

<action hauteur="10" largeur="10" 
        haut="1" gauche="1" 
        Ygrad="1" Xgrad="1" 
        Ymax="5" Ymin="-5" Xmax="5" Xmin="-5" 
        couleur="noir" 
        mouvement="creer" objet="repere" />

• hauteur et largeur sont les dimensions du cadre contenant le repère, exprimées en centimètres ;
• haut et gauche donnent la position de ce cadre relativement au bord haut et au bord gauche de la zone de dessin, en centimètres ;
• Xgrad et Ygrad donnent les unités de graduations : si Xgrad est égal à 5, le repère va être gradué de 5 en 5 ;
• Xmin, Xmax, Ymin et Ymax sont les valeurs extrêmes des abscisses et ordonnées affichées dans le repère ;
• un attribut couleur facultatif est possible (noir par défaut).

Voir repère pour des exemples.

Le repère peut être masqué ou affiché avec les nœuds XML suivants :

<action mouvement="masquer" objet="repere" />
<action mouvement="montrer" objet="repere" />

Le repère doit d'abord être créé avec mouvement=“montrer” pour pouvoir être affiché.

Il est possible de tracer des fonctions dans le repère lorsque celui-ci a déjà été créé. Pour l'instant, cela n'est pas implémenté dans l'interface, il faut passer par le script.

Dans ce cas, le nom de l'objet est “fonction”, qui doit être accompagné d'un attribut id permettant de l'identifier. Un attribut couleur est facultatif (noir par défaut), ainsi qu'un attribut epaisseur pour l'épaisseur du trait de tracé.

Le tracé d'une courbe de fonction se fait avec mouvement=“creer” et un attribut formule donnant l'expression de la fonction à tracer, la variable étant notée x. La courbe de la fonction s'adapte automatiquement au repère, comme si celui-ci était un écran de calculatrice : la courbe ne dépasse pas du cadre.

Exemple Pour tracer la courbe de la fonction carré :

<action mouvement="creer" objet="fonction" id="1" formule="x^2" couleur="rouge" />

Comme tous les autres objets, les fonctions peuvent être montrées ou masquer par les nœuds suivants, en n'oubliant pas leur id :

<action mouvement="masquer" objet="fonction" id="1" />
<action mouvement="montrer" objet="fonction" id="1" />

Par défaut, la fonction va être tracée sur un domaine de définition compris entre les valeus Xmin et Xmax du repère. Il est possible de restreindre ce domaine en donnant des attributs Xmin et Xmax dans le nœud de création du graphe de la fonction. Il n'est pas possible d'étendre ce domaine : en d'autres termes, la courbe ne “dépassera” jamais le cadre du repère.

Exemple Pour tracer la courbe de la fonction carré sur l'intervalle [-1;2] :

<action mouvement="creer" objet="fonction" formule="x*x" Xmin="-1" Xmax="2" id="1" />

Exemple complet Le code ci-dessous montre comment tracer une fonction définie par morceaux :

<?xml version="1.0" encoding="UTF-8"?>
<INSTRUMENPOCHE version="2">
<action hauteur="10" largeur="10" haut="2" gauche="1" 
     Ygrad="1" Xgrad="1" Ymax="5" Ymin="-5" Xmax="5" Xmin="-5" 
     couleur="noir" mouvement="creer" objet="repere" />
<action mouvement="creer" objet="fonction" 
     couleur="rouge" epaisseur="2" formule="x*x" 
     Xmin="-1" Xmax="2" id="1" />
<action mouvement="creer" objet="fonction" couleur="rouge" 
     epaisseur="2" formule="x+2" Xmax="-1" Xmin="-3" id="2" />
</INSTRUMENPOCHE>

• repere pour voir comment manipuler le repère avec la souris.
• La classe RepereIep présente les données à connaître pour programmer le repère (mais aussi l'axe gradué et le quadrillage) depuis une autre application.