L'objet application: app
L'objet app permet l'accés aux données et aux fonctionnalités de l'application After Effects.
Les attributs de cet objet nous donneront accés à un certain nombre d'informations comme la version ou la langue utilisée et ses méthodes
permettront par exemple d'ouvrir/fermer un projet ou encore de purger la mémoire cache.
alert("Vous utilisez la version " + app.version);
alert("Version professionnelle : " + app.isProfessionalVersion);
Pour créer un nouveau projet nous utiliserons la méthode newProject(). Si un projet disons 'aaa.aep' est déjà ouvert,
une fenêtre s'affichera pour demander à l'utilisateur s'il souhaite effectuer une sauvegarde du projet.
app.newProject();
Nous pouvons également fermer un projet en utilisant la méthode close() sur un objet projet existant.
Il est possible de préciser les options suivantes pour les CloseOptions : PROMPT_TO_SAVE_CHANGES, DO_NOT_SAVE_CHANGES ou SAVE_CHANGES,
pour indiquer si nous devons poser la question à l'utilisateur ou bien ne pas sauvegarder le projet ou alors le sauvegarder automatiquement.
La syntaxe sera la suivante:
app.project.close(CloseOptions.PROMPT_TO_SAVE_CHANGES);
L'objet "project" est l'objet qu'on va retrouver dans pratiquement tous les scripts puisqu'il désigne le projet dans lequel nous travaillons. Il sera examiné plus en détail dans la partie suivante.
Attention toutefois car si ce projet n'existe pas, app.project retourne la valeur "null".
Dans le cas où le script agirait sur un projet existant, on pourrait retrouver par exemple une instruction de ce type pour récuperer le projet dans une variable "myProj" :
myProj = app.project;
La méthode open() quant à elle permettra d'ouvrir un projet. Si aucun fichier n'est précisé une boite de dialogue s'affichera pour permettre à l'utilisateur
d'aller chercher le projet souhaité.
app.open();
UndoGroup
Nous terminons cette partie avec une fonction qu'on retrouve dans la plupart
des scripts. Il s'agit de la création d'un groupe "Undo" qui permettra à l'utilisateur d'annuler l'ensemble des actions
du script comprises entre deux bornes 'begin/end'. L'annulation se fera par le menu "Edition>>Annuler...".
On doit préciser dans le 'begin' la chaîne de caractères qui s'affichera dans le menu.
app.beginUndoGroup("monScript.jsx");
.
.
.
app.endUndoGroup();
|
