Cette page présente toutes les possibilités d'actions avec les textes dans un script Instrumenpoche. Ce sont les nœuds XML de la forme :

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

Avant toute autre action, une zone de texte doit être créé. Pour cela, le nœud XML doit contenir mouvement=“creer” et un attribut id doit être mentionné pour identifier la zone plus tard. Des attributs abscisse et ordonnee facultatifs permettent de placer la zone sur la scène.

Exemple

<action ordonnee="78" abscisse="35" id="1" mouvement="creer" objet="texte" />

Un texte peut être affiché ou masqué par le même code que les autres objets. Il faut cependant mentionner son id :

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

Comme tous les objets, un texte 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 :

<action abscisse="462.1" ordonnee="252" 
     id="2" mouvement="translation" objet="texte" 
     vitesse="1000"/>

Pour écrire un texte, on utilise la syntaxe minimale :

<action texte="Mon texte" id="1" mouvement="ecrire" objet="texte" />

dont tous les attributs sont obligatoires. L'attribut texte reçoit le texte à afficher, qui peut contenir des balises HTML ou des formules mathématiques comme expliqué dans l'article sur les textes dans l'interface.

Si on veut modifier la police, la couleur ou la taille de quelques caractères du texte, il est possible d'utiliser une syntaxe HTML. Mais pour tout le texte, il est plus simple d'utiliser les attributs police, couleur et taille.

Exemple

<action police="Zapfino" couleur="brown" 
        texte="Instrumenpoche" id="1" 
        mouvement="ecrire" objet="texte" />

va donner

NB Lorsqu'on crée des textes dans une animation destinée à être vue sur différents ordinateurs (par exemple une animation disponible sur le web), il est possible d'avoir des rendus différents, notamment car la police demandée peut ne pas être installée sur certains ordinateurs.

Par défaut, les textes d'instrumenpoche ne comportent pas de cadre autour, ce qui permet de les superposer avec les autres tracés.

Si, lors de l'écriture (mouvement=“ecrire”) on précise une couleur couleur_fond, le texte va être muni d'un fond translucide (opacite_fond=“70” par défaut) de cette couleur.

Il est également possible d'encadrer le texte, cette fois en précisant couleur_cadre, qui peut éventuellement muni d'un epaisseur_cadre. Le fond et le cadre peuvent être combinés.

Exemples

<action police="Zapfino" couleur="brown" 
        texte="Instrumenpoche {{:script:exemple_couleur_fond.png|}}" id="1" 
        mouvement="ecrire" objet="texte" 
        couleur_fond="burlywood" />

va donner :

<action police="Zapfino" couleur="brown" 
        texte="Instrumenpoche " id="1" 
        mouvement="ecrire" objet="texte" 
        couleur_cadre="burlywood" />

donnera :

Par défaut, le cadre s'ajuste à la taille du texte. Il est possible d'ajouter une marge tout autour avec un attribut marge. Cette marge peut être ajustée de chaque côté du cadre avec ds attributs marge_gauche, marge_droite, marge_haut et marge_bas.

Exemple En combinant le cadre, le fond, avec une marge tout autour et notamment plus grande à droite, on peut afficher le texte sur un fond suffisamment grand pour pouvoir y placer le crayon afin de créer un logo :

<action police="Zapfino" couleur="brown" texte="Instrumenpoche " 
        id="1" mouvement="ecrire" objet="texte" 
        couleur_cadre="burlywood" couleur_fond="lemonchiffon" epaisseur_cadre="3" 
        marge="15" marge_droite="90" />

• texte pour voir comment manipuler un texte avec la souris.
• La classe TexteIep présente les données à connaître pour programmer un texte depuis une autre application.