Outils du site


interface:script

Ceci est une ancienne révision du document !


Fenêtre de script

Dans les deux modes, création et lecture, d'instrumenpoche, le bouton permet de montrer ou masque une fenêtre contenant le 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

  1. on montre le crayon en cliquant sur le bouton
  2. on déplace le crayon
  3. on clique sur

alors une fenêtre semblable à l'image ci-dessous apparaît.

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
<commentaire texte="écrire ici le commentaire" />

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.

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

et permettent d'agrandir ou de rapetisser le texte du script.

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 :

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

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.

valide le script et met à jour la scène de dessin en fonction du script validé.

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.

interface/script.1294046969.txt.gz · Dernière modification : 03/01/2011 10:29 de lzamo