Fonctions globales

Pour le début de notre apprentissage nous allons examiner les différentes façons d'afficher à l'écran une fenêtre, qu'il s'agisse d'un simple message d'alerte lancé à l'utilisateur, d'une demande de confirmation ou encore d'une boite de dialogue permettant d'aller chercher un fichier sur sa machine. Nous ne parlerons pas ici des éléments d'Interface Utilisateur que l'on peut créer soi-même pour interagir avec l'utilisateur, ceux-ci seront vus dans la section du même nom.

Si nous souhaitons pouvoir éditer et évaluer 'en direct' les scripts qui vont suivre, il serait souhaitable d'avoir un projet ouvert et d'avoir exécuté le script "Console.jsx" (dans la section Ressources) ou alors d'ouvrir un éditeur externe de son choix.

alert(), prompt() et les autres

Débutons avec la fonction alert() : elle nous pemet d'afficher un message de texte dans une fenêtre. Elle prend en paramètre une chaîne de caractères notée entre guillemets (les chaînes de caractères sont toujours notées entre guillemets) qui correspond au message à afficher. Cette fonction est très utile notamment pour prévenir l'utilisateur en cas d'échec (ou de succés) d'une opération ou pour lui rappeler dans quelle condition le script doit s'exécuter. C'est un bon moyen pour communiquer avec lui.

Une deuxième fonction utile est la fonction confirm(). Elle affiche une fenêtre demandant une confirmation à l'utilisateur (oui/non?) et retourne une valeur boolénne ('true' ou 'false') qu'on peut récupérer dans notre script. En fonction de la réponse, le script pourra s'adapter à ce choix et agir en conséquence. Elle prend aussi une chaîne de caractères en paramètre, représentant la question soumise à l'utilisateur.

La fonction prompt() permet quant à elle d'afficher une fenêtre contenant une zone de texte éditable par l'utilisateur. C'est un moyen par exemple pour lui demander de préciser la valeur d'un paramètre du script. Elle nécessite deux chaînes de caractères, la première étant le message à afficher et la seconde le texte par défaut situé dans l'espace éditable.

Nous utiliserons la fonction fileGetDialog() pour afficher une fenêtre 'Ouvrir' standard. Elle prend en considération deux paramètres, le premier est le titre de la fenêtre et le second est le type de fichier à ouvrir. Nous écrirons la chaîne vide "" pour ouvrir tout type de fichier et "EggP aep" pour ne choisir que des fichiers *.aep.

Nous pouvons également afficher une fenêtre pour ouvrir cette fois un dossier. On utilisera pour cela la fonction folderGetDialog() qui prend en paramètre une seule chaîne de caractères.

Pour terminer cette partie, nous mentionnons une dernière fonction qui peut être utile pour afficher des informations dans l'interface de After Effects. Elle nécessite une chaîne de caractères et affiche cette chaîne dans la palette "Informations". Il s'agit de la fonction write().

Il existe aussi son homologue writeLn() pour écrire sur plusieurs lignes et la fonction clearOutput() pour effacer le contenu de la palette.