Instrumenpoche

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Fenêtre de script ======
Dans les deux modes, création et lecture, d'instrumenpoche, le bouton {{:interface:btn_script.png|}} permet de montrer ou masque une fenêtre contenant le [[:script:start|script]] de la construction en cours, c'est-à-dire un texte, au format XML, décrivant cette construction.

Dans l'interface de création, le script se met à jour en temps réel, ce qui permet, par l'observation d'apprendre son langage.

Par exemple, si 
   - on montre le crayon en cliquant sur le bouton {{:interface:btn_crayon.png|}} 
   - on déplace le crayon
   - on clique sur {{:interface:btn_script.png|}}
alors une fenêtre semblable à l'image ci-dessous apparaît.

{{   :interface:fenetre_script.png   |}}

Le texte qui apparaît dans le fenêtre est modifiable.

===== Coloration syntaxique =====
Instrumenpoche applique automatiquement une coloration syntaxique au script affiché dans cette fenêtre. Cette coloration a pour effet de mettre : 
  * en bleu le début et la fin obligatoires à tout script ;
  * en rouge le début et la fin obligatoires à chaque étape de l'animation : ''<action '' et ''/>''
  * en noir tous les textes entre guillemets ;
  * en vert les mot-clés du script ;
  * en gris les commentaires. Un commentaire est un nœud XML qui est ignoré lors de la lecture d'animations par instrumenpoche. La syntaxe d'un commentaire est de la forme 

 <code XML><commentaire texte="écrire ici le commentaire" /></code>

La coloration syntaxique permet à un utilisateur de repérer les différents éléments du script. Elle permet aussi de détecter certaines erreurs : un mot-clé non reconnu se colore de bleu. Voir ci-dessous ce qui se produit si on écrit //mouvemet// pour //mouvement//.

{{   :interface:erreur_coloration_syntaxique.png   |}}

===== Menu =====
La fenêtre comporte une barre de menu avec des boutons :

{{:interface:btn_texte_plus.png|}} et {{:interface:btn_texte_moins.png|}} permettent d'agrandir ou de rapetisser le texte du script.

{{:interface:btn_plus.png|}} crée un nouveau nœud vide à la fin du script, pour les utilisateurs avertis qui veulent améliorer une animation en modifiant directement le script. Ce nœud "vide" contient uniquement les éléments communs à toutes les actions possibles :
<code XML><action mouvement="" objet=""/></code>

{{:interface:btn_coloration_syntaxique.png|}} active ou désactive la coloration syntaxique. En effet, si la coloration syntaxique est pratique pour se repérer dans le script, le fait qu'elle soit mise à jour en temps réel occupe de la ressource et peut dans certains cas ralentir les réactions d'instrumenpoche. La désactiver accélère ces réactions.

{{:interface:btn_valider.png|}} valide le script et met à jour la scène de dessin en fonction du script validé.

{{:interface:btn_fermer.png|}} ferme la fenêtre sans valider les modifications éventuelles du script.

===== Aller à une étape =====
En mode lecture uniquement, un clic droit sur un nœud XML de la fenêtre de script fait apparaître un menu comportant un choix nommé "Aller à...". Si on sélectionne ce "Aller à...", le lecteur lit immédiatement l'animation jusqu'à l'étape désignée par ce nœud XML. Les nœuds suivants sont alors colorés en gris.

Par exemple, si la fenêtre contient le script suivant, qui consiste à montrer et déplacer le crayon,  puis montrer l'équerre :
<code XML>
<?xml version="1.0" encoding="UTF-8"?>
<INSTRUMENPOCHE version="2">
<action mouvement="montrer" objet="crayon" />
<action abscisse="157.15" ordonnee="246.3" 
   mouvement="translation" objet="crayon" />
<action mouvement="montrer" objet="equerre" />
</INSTRUMENPOCHE>
</code>
On fait un clic droit sur le deuxième nœud, c'est-à-dire sur n'importe quelle partie du texte
<code XML><action abscisse="157.15" ordonnee="246.3" 
   mouvement="translation" objet="crayon" /></code>
{{   :interface:clic_droit_fenetre_script.png   |}}
puis on clique sur "Aller à..."
{{   :interface:apres_clic_droit_fenetre_script.png   |}}
Le lecteur fait alors apparaître le crayon, le déplace et colore en gris le troisième nœud du script.

On peut poursuivre la lecture de l'animation en cliquant sur le boutons habituels : {{:interface:btn_lecture.png|}} ou {{:interface:btn_suivante.png|}}

===== Voir aussi =====
   * [[:tutoriels:tutoriel_complements|Un tutoriel]] expliquant comment réaliser une construction avec les instruments et la corriger avec le script.
   * [[:script:start|La documentation sur le langage de script]] d'instrumenpoche.