Différences

Ci-dessous, les différences entre deux révisions de la page.

--- script:point [28/04/2011 15:32] – créée lzamo
+++ script:point [03/05/2011 20:17] (Version actuelle) – lzamo
@@ Ligne 3: / Ligne 3: @@
 <code XML><action objet="point" mouvement="..." ... /></code>
 ===== Création, apparition, déplacement =====
+==== Création ====
+Pour pouvoir être utilisé dans Instrumenpoche, un point doit d'abord être "créé", avec un identifiant (attribut ''id'').
+L'action minimale pour créer un point est donc :
+<code XML>
+<action id="1" mouvement="creer" objet="point" />
+</code>
+Si on veut que le point apparaisse directement à un certain endroit de la scène, on précise les attributes ''abscisse'' et ''ordonnee'' (égaux à 0 par défaut). On peut également préciser un attribut ''[[:couleurs|couleur]]'' (égal à "noir" par défaut) :
+<code XML>
+<action ordonnee="200" abscisse="300" couleur="bleu" id="2" mouvement="creer" objet="point" />
+</code>
+On peut faire en sorte que le point ne puisse pas être déplacé à la souris en ajoutant ''fixe="true"'' dans le nœud XML.
+Par défaut, le point apparaît comme une croix de Saint-André. Il est possible de lui donner, à la création, une autre forme en utilisant l'attribut ''forme''. Les valeurs possibles sont les mêmes que celles des [[:script:longueur|codages de longueur]] : "/","//","///","\\","\\\\","\\\\\\","X", "O", "]" et "[". Chaque valeur correspond à la forme que l'on verra : "O" (la lettre O) donnera un rond vide, "X" une croix (c'est la forme par défaut), "]" et "[" sont utiles pour dessiner des intervalles. Les valeurs "\\","\\\\","\\\\\\" sont doubles car le caractère "\" est un caractère d'"échappement", ainsi "\\" donnera un seul trait, "\\\\" deux traits, etc.
+==== Apparition, disparition ====
+Dès qu'un point est créé, il apparaît sur la scène. Il est possible de le masquer, puis de faire réapparaître, avec les nœuds XML suivants (l'attribut ''id'' obligatoire permettant d'identifier un point précis) :
+<code XML>
+<action id="2" mouvement="masquer" objet="point" />
+<action id="2" mouvement="montrer" objet="point" />
+</code>
+==== Déplacement ====
+Comme tous les objets, un point peut être déplacé par un attribut ''translation'' auquel on adjoint des attributs ''abscisse'' et ''ordonnee'' désignant le lieu où on veut l'envoyer, avec éventuellement un attribut ''vitesse'' :
+**Exemple** Pour que le déplacement soit instantané, on définit ''vitesse'' sur un grand nombre :
+<code XML>
+<action abscisse="462.1" ordonnee="252"
+     id="2" mouvement="translation" objet="point"
+     vitesse="1000"/>
+</code>
 ===== Le nom du point =====
-===== Voir aussi =====
+Tout point peut être accompagné d'un texte (//a priori// son nom) qui va l'accompagner automatiquement en cas de déplacement. Ceci se fait avec un ''mouvement="nommer"'' qui nécessite un attribut ''nom'', éventuellement accompagne d'une ''couleur'', qui peut être différente de celle du dessin du point. Le nom du point contient un texte qui peut être formaté de la même façon qu'un objet [[:interface:texte]] (écriture de mathématiques, mise en forme, etc).
+Il faut bien sûr préciser l'"id" du point qu'on veut ainsi nommer.
+**Exemple**
+<code XML>
+<action couleur="rouge" nom="point A" id="2"
+    mouvement="nommer" objet="point" />
+</code>
+Le nom du point peut être changé plus loin dans l'animation par un autre nœud semblable à celui-ci.
+Par défaut, le nom du point se situe en bas à gauche de son dessin. Il est possible de le faire apparaître ailleurs en renseignant des attributs ''abscisse'' et ''ordonnee''. Ces coordonnées sont celles du coin supérieur gauche de la zone de texte du nom, relative au centre du dessin du point. Comme toujours, ces coordonnées sont exprimées en pixels, un centimètre d'Instrumenpoche étant égal à 30 pixels.
+**Exemple**
+<code XML>
+<?xml version="1.0" encoding="UTF-8"?>
+<INSTRUMENPOCHE version="2">
+<action ordonnee="218.45" abscisse="287.55"
+      id="2" mouvement="creer" objet="point" />
+<action ordonnee="-29.25" abscisse="-20.9"
+      nom="point A" id="2" mouvement="nommer" objet="point" />
+</INSTRUMENPOCHE>
+</code>
+===== Voir aussi =====
+   * [[:interface:point]] pour voir comment manipuler les points avec la souris.
+   * [[http://instrumenpoche.sesamath.net/documentation_classes/PointIep.html|La classe CompasIep]] présente les données à connaître pour programmer les points depuis une autre application.
+   * Pour savoir comment utiliser le script pour déplacer des objets vers des points, voir la documentation de l'objet concerné.