====== Textes ======
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 :
<code XML><action objet="texte" mouvement="..." ... /></code>
===== Création, déplacement, affichage =====
==== Création ====
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** 
<code XML>
<action ordonnee="78" abscisse="35" id="1" mouvement="creer" objet="texte" />
</code>
==== Afficher/masquer ====
Un texte peut être affiché ou masqué par le même code que les autres objets. Il faut cependant mentionner son ''id'' : 
<code XML>
<action id="1" mouvement="masquer" objet="texte" />
<action id="1" mouvement="montrer" objet="texte" />
</code>

==== Déplacement ====

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 :

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

===== Écrire un texte =====
Pour écrire un texte, on utilise la syntaxe minimale :
<code XML>
<action texte="Mon texte" id="1" mouvement="ecrire" objet="texte" />
</code>
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 [[:interface:texte|l'article sur les textes dans l'interface]].
==== Mise en forme ====
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**
<code XML>
<action police="Zapfino" couleur="brown" 
        texte="Instrumenpoche" id="1" 
        mouvement="ecrire" objet="texte" />
</code>
va donner 

{{   :script:zapfino_marron.png   |}}

**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.

==== Cadre ====
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 [[:couleurs|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**
<code XML>
<action police="Zapfino" couleur="brown" 
        texte="Instrumenpoche {{:script:exemple_couleur_fond.png|}}" id="1" 
        mouvement="ecrire" objet="texte" 
        couleur_fond="burlywood" />
</code>
va donner :
{{   :script:exemple_couleur_fond.png   |}}

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

donnera :

{{   :script:exemple_couleur_cadre.png   |}}

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 :
<code XML>
<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" />
</code>

{{   :script:exemple_fond_texte_complet.png   |}}

===== Voir aussi =====
   * [[:interface:texte]] pour voir comment manipuler un texte avec la souris.
   * [[http://instrumenpoche.sesamath.net/documentation_classes/TexteIep.html|La classe TexteIep]] présente les données à connaître pour programmer un texte depuis une autre application.