====== Le compas ====== Cette page présente toutes les possibilités d'actions du compas dans un script Instrumenpoche. Ce sont les nœuds XML de la forme : ===== Déplacement, apparition ===== ==== Afficher/masquer ==== Comme tous les instruments, le compas peut être masqué avec : Il est montré avec : Il est possible de faire apparaître le compas à un autre endroit de la scène que celui qui est prévu par défaut en précisant les [[script:coordonnees|coordonnées]] de cet endroit, par exemple : Les coordonnées du compas sont celles de l'extrémité de sa pointe. ==== Translation ==== Le compas peut être déplacé jusqu'à un point en utilisant : Un attribut ''vitesse'' peut être précisé, il donne le nombre de pixels de déplacement du compas par dixième de seconde. La valeur par défaut est 8. Si un [[point]] d'Instrumenpoche a été créé auparavant, on peut déplacer le compas jusqu'à ce point en utilisant l'attibut "cible" : ==== Retourner ==== Par défaut, le compas s'ouvre vers la droite. On peut le "retourner" (lui faire subir une symétrie axiale) pour qu'il s'ouvre vers la gauche par : Si on "retourne" deux fois le compas, il retrouve sa configuration initiale. ===== Rotation ===== Le compas peut pivoter autour le l'extrémité de sa pointe. Dans ce cas, l'attribut ''mouvement'' doit prendre la valeur ''"rotation"'' et doit être accompagné de l'attribut ''angle'', et éventuellement de ''sens''. ''angle'' précise l'angle, mesuré en degrés, que formera le compas à la fin de la rotation avec la //verticale//, contrairement aux autres instruments pour lesquels l'angle est mesuré par rapport à l'horizontale. Cet angle est celui qui est formé par une demi-droite verticale tournée vers le haut et la bissectrice de l'angle formée par les deux branches du compas. Il faut se souvenir que, dans Instrumenpoche, le sens positif est celui des aiguilles d'une montre. Ainsi, sur la figure ci-dessous, le compas a été pivoté de 60°. {{ :script:rotation_compas.png |}} ''sens'' précise à la fois le sens de rotation et sa vitesse : si ''sens'' est positif, le compas tourne dans le sens des aiguilles d'une montre, et dans l'autre sens si ''sens'' est négatif. La valeur absolue de ''sens'' donne la vitesse de rotation, en degrés par dixième de seconde. Par défaut, ''sens'' est égal à 5. Le code ci-dessous montre le compas et le fait pivoter pour qu'il se trouve à l'horizontale, sa "tête" tournée vers la droite. Si un [[:script:point]] a déjà été créé, on peut faire en sorte d'aligner la pointe et la mine du compas avec ce point, en utilisant l'attribut ''cible'' : **Exemple** ===== Écartement ===== L'écartement du compas est modifié en utilisant ''mouvement="ecarter"'' et en ajoutant un attribut ''ecart'' dont la valeur sera la distance voulue entre la pointe et la mine du compas, exprimée en pixels. Par exemple, pour obtenir un écart de 6 cm (en considérant qu'un cm mesure trente pixels) : Si ''ecart'' n'est pas un nombre compris entre 0 et 410, Instrumenpoche ignore ce mouvement. Avec un [[:script:point]] déjà créé, on peut utiliser l'attribut ''cible'' pour faire en sorte que l'écart entre la point et la mine soit égal à la distance entre la pointe du compas et le point. Cela ne règle que la distance, si on veut que la mine se déplace, il faut également régler la rotation. **Exemple** ===== Tracé ===== Le compas admet deux positions : l'une où il est "levé" (en position de tracer) l'autre où "couché" (position normale, pour le déplacement). Elles sont données ci-dessous avec le script qui permet de les obtenir. ^ Compas couché ^ Compas levé, en train de tracer ^ | {{:interface:compas:compas_ouvert.png}} | {{:interface:compas:compas_tracant.png}} | | | | Un nœud permettant de tracer au compas doit préciser : * l'attribut ''mouvement'' égal à "tracer" ; * un attribut ''debut'' et un attribut ''fin'' qui donnent respectivement les angles que forment le début et la fin du tracé de l'arc de cercle tracé par rapport à l'horizontale ; on peut ici donner différentes mesures, par exemple, ajouter 360 à ''fin'' fera en sorte que le compas fasse un tour supplémentaire ; * un attribut ''sens'' semblable à celui donné pour une rotation ; cependant ici, ''sens'' ne donne que la vitesse angulaire de rotation en valeur absolue, pas le sens de rotation : le tracé se fait toujours de ''debut'' jusqu'à ''fin'' ; * éventuellement, comme toutes les actions de tracé, les paramètres du trait : ''couleur'' et ''epaisseur''. **Exemples** va donner : {{ :script:compas_exemple1.png |}} Si on inverse ''debut'' et ''fin'', l'arc de cercle tracé est le même, mais le compas se trouve, à la fin de l'animation, avec un angle de rotation égal à ''fin'' : d'où la figure finale suivante : {{ :script:compas_exemple2.png |}} ===== Voir aussi ===== * [[:interface:compas]] pour voir comment manipuler le compas avec la souris. * [[http://instrumenpoche.sesamath.net/documentation_classes/CompasIep.html|La classe CompasIep]] présente les données à connaître pour programmer le compas depuis une autre application.