Différences

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

--- script:crayon [28/04/2011 15:15] – lzamo
+++ script:crayon [29/04/2011 08:17] (Version actuelle) – lzamo
@@ Ligne 19: / Ligne 19: @@
 <code XML><action objet="crayon" 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 crayon 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 crayon pivote à chaque dixième de seconde. L'attribut ''angle'' donne l'angle que va faire le crayon avec l'horizontale à la fin de sa rotation.
+Si un [[:script:point]] a été créé auparavant, le crayon 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="crayon" />
+<action cible="1" mouvement="translation" objet="crayon" />
+</INSTRUMENPOCHE></code>
 ===== Tracer =====
@@ Ligne 32: / Ligne 44: @@
 Par défaut, le tracé sera noir et d'une épaisseur de 1 pixel. Il est possible de préciser une autre épaisseur (en pixels) et une [[:couleurs|couleur]], par son format hexadécimal ou son nom. Les deux nœuds suivants sont équivalents :
 <code XML>
-<action objet="crayon" mouvement="tracer" id="1" abscisse="200" ordonnee="350" epaisseur="3" couleur="darkorchid" />
+<action objet="crayon" mouvement="tracer" id="1"
-<action objet="crayon" mouvement="tracer" id="1" abscisse="200" ordonnee="350" epaisseur="3" couleur="9932CC" />
+   abscisse="200" ordonnee="350" epaisseur="3" couleur="darkorchid" />
+<action objet="crayon" mouvement="tracer" id="1"
+   abscisse="200" ordonnee="350" epaisseur="3" couleur="9932CC" />
 </code>
 On peut forcer le crayon à dessiner une flèche au bout du segment en précisant ''style="vecteur"''
@@ Ligne 42: / Ligne 56: @@
       * ''"demidroite"'' : le crayon trace depuis sa position d'avant le tracé jusqu'au bord de la feuille, en passant par le point dont les coordonnées sont données par ''abscisse'' et ''ordonnee''
       * ''"libre"'' : le crayon trace des segments consécutifs dont les coordonnées extrémités sont données par les attributs ''abscisses'' et ''ordonnees'', qui sont des listes de nombres séparés par des virgules.
-      * ''"polygone"'' : le crayon trace un polygone fermé dont l'intérieur est colorié. Les coordonnées des sommets du polygone sont données dans des listes ''abscisses'' et ''ordonnees'' comme pour la forme ''libre''. Pour un polygone, on peut préciser ''couleur_fond'' si on veut que la couleur de fond du polygone soit différente de la couleur de son périmètre. L'attribut facultatif ''opacite'' reçoit un nombre compris entre 0 et 100 définissant l'opacité du fond du polygone : 0 pour un fond totalement transparent, 100 pour un fond opaque. La valeur par défaut est 60.
+      * ''"polygone"'' : le crayon trace un polygone fermé dont l'intérieur est colorié. Les coordonnées des sommets du polygone sont données dans des listes ''abscisses'' et ''ordonnees'' comme pour la forme ''libre''. Mais on peut également donner une liste d'''id'' de points déjà créés dans un attribut ''cibles'' (voir deuxième exemple ci-dessous). Pour un polygone, on peut préciser ''couleur_fond'' si on veut que la couleur de fond du polygone soit différente de la couleur de son périmètre. L'attribut facultatif ''opacite'' reçoit un nombre compris entre 0 et 100 définissant l'opacité du fond du polygone : 0 pour un fond totalement transparent, 100 pour un fond opaque. La valeur par défaut est 60.
-**Exemple**
+**Exemples**
 Le code suivant donne l'image ci-contre {{   :script:exemple_polygone.png|}}
 <code XML>
@@ Ligne 54: / Ligne 68: @@
        couleur="darkorchid" epaisseur="3" couleur_fond="gold" />
 </INSTRUMENPOCHE>
+</code>
+Pour tracer un triangle dont les sommets sont des points d'''id'' respectivement égaux à 1 ; 2 et 3 :
+<code XML>
+<action cibles="2,3,1" epaisseur="0" couleur="0"
+   forme="polygone" id="4" mouvement="tracer" objet="crayon" />
 </code>
 Si l'attribut ''forme'' n'est pas précisé, le crayon trace un segment.
 ===== Voir aussi =====
-* [[http://instrumenpoche.sesamath.net/documentation_classes/CrayonIep.html|La classe CrayonIep.as]], pour les développeurs.
+   * [[:interface:crayon]] pour voir comment manipuler le crayon avec la souris.
+   * [[http://instrumenpoche.sesamath.net/documentation_classes/CrayonIep.html|La classe CrayonIep]] présente les données à connaître pour programmer le crayon depuis une autre application.