Instrumenpoche

Outils du site

script:crayon

Différences

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

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
script:crayon [06/12/2010 09:58] – lzamoscript:crayon [29/04/2011 08:17] (Version actuelle) – lzamo
Ligne 1: Ligne 1:
 ====== Le crayon ====== ====== Le crayon ======
-Cette page présente toutes les possibilités de script Instrumenpoche de la forme : +Cette page présente toutes les possibilités d'actions du crayon dans un script Instrumenpoche. Ce sont les nœuds XML de la forme : 
-<code XML><action objet="crayon" ... /></code> +<code XML><action objet="crayon" mouvement="..." ... /></code>
-c'est-à-dire les actions mettant en jeu le [[:interface:crayon]].+
  
 ===== Déplacement, apparition ===== ===== Déplacement, apparition =====
Ligne 20: Ligne 19:
 <code XML><action objet="crayon" mouvement="rotation" angle="90" sens="-5" /></code> <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. 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 ===== ===== Tracer =====
 En plus des attributs ''objet'' et ''mouvement'', tout tracé doit contenir un attribut ''id'' dont la valeur est unique. C'est cette valeur qui permet à Instrumenpoche d'identifier le tracé. Si, par exemple, on trace un trait avec un ''id'' égal 7 puis, plus tard, un autre trait avec le même ''id'', le deuxième trait effacera le premier. En cas d'absence d'identifiant, Instrumenpoche affichera des messages d'erreurs lors de la lecture et, ne pouvant identifier les traits correctement, risque d'en effacer certains en en traçant d'autres. En plus des attributs ''objet'' et ''mouvement'', tout tracé doit contenir un attribut ''id'' dont la valeur est unique. C'est cette valeur qui permet à Instrumenpoche d'identifier le tracé. Si, par exemple, on trace un trait avec un ''id'' égal 7 puis, plus tard, un autre trait avec le même ''id'', le deuxième trait effacera le premier. En cas d'absence d'identifiant, Instrumenpoche affichera des messages d'erreurs lors de la lecture et, ne pouvant identifier les traits correctement, risque d'en effacer certains en en traçant d'autres.
  
-Le crayon trace un segment //depuis sa position actuelle// jusqu'au coordonnées données, par exemple :+Le crayon trace un segment depuis sa position actuelle avec :
 <code XML><action objet="crayon" mouvement="tracer" id="1" abscisse="200" ordonnee="350" /></code> <code XML><action objet="crayon" mouvement="tracer" id="1" abscisse="200" ordonnee="350" /></code>
 Par exemple, pour tracer un segment au crayon depuis le point de coordonnées (100 ; 150) jusqu'à (200;350), il faut écrire : Par exemple, pour tracer un segment au crayon depuis le point de coordonnées (100 ; 150) jusqu'à (200;350), il faut écrire :
Ligne 31: Ligne 42:
 <action objet="crayon" mouvement="tracer" id="1" abscisse="200" ordonnee="350" /> <action objet="crayon" mouvement="tracer" id="1" abscisse="200" ordonnee="350" />
 </code> </code>
-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 [[:script:couleurs|couleur]], par son format hexadécimal ou son nom. Les deux nœuds suivants sont équivalents :+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> <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> </code>
 On peut forcer le crayon à dessiner une flèche au bout du segment en précisant ''style="vecteur"'' On peut forcer le crayon à dessiner une flèche au bout du segment en précisant ''style="vecteur"''
Ligne 43: 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''        * ''"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.       * ''"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|}} Le code suivant donne l'image ci-contre {{   :script:exemple_polygone.png|}}
 <code XML> <code XML>
Ligne 55: Ligne 68:
        couleur="darkorchid" epaisseur="3" couleur_fond="gold" />        couleur="darkorchid" epaisseur="3" couleur_fond="gold" />
 </INSTRUMENPOCHE> </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> </code>
  
 Si l'attribut ''forme'' n'est pas précisé, le crayon trace un segment. Si l'attribut ''forme'' n'est pas précisé, le crayon trace un segment.
 +
 +===== Voir aussi =====
 +   * [[: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.
 +
script/crayon.1291625900.txt.gz · Dernière modification : 06/12/2010 09:58 de lzamo