Scripts : création de fenêtres pour vos scripts After Effects

Contents
1. Introduction	6. Buttons
2. Windows	7. Options
3. Groups	8. Example
4. Panels	9. Conclusion
5. Text

Introduction

La création d'une fenêtre pour un script est idéale lorsque vous avez besoin que l'utilisateur final saisisse des informations et affiche des instructions. Dans cet article, je vais passer en revue les bases de la création d'une fenêtre pour votre script AE à l'aide de javascript de base et d'Adobe Extendscript Toolkit CC.

Fenêtres

Pour réaliser votre vitrine, c'est très simple :

//New Window
var mainWindow = new Window("palette", "Title", undefined);

new Window() est l'argument pour créer la fenêtre. Ensuite, à l’intérieur, vous devez spécifier le type, le titre et les limites. Une fenêtre de palette convient aux scripts After Effects, et il est également recommandé de laisser les limites non définies, car la taille et la position peuvent être affectées ultérieurement.

Pour appeler votre fenêtre :

mainWindow.show();

Comme il n'y a actuellement rien dans la fenêtre, cela appellera simplement une petite fenêtre pour montrer qu'elle fonctionne.

Groupes

La prochaine chose à faire est de créer un objet pour héberger les informations de votre fenêtre.

Le "groupe" permet d'organiser des objets à l'intérieur de celui-ci. Avant mainWindow.show(), ajoutez cette ligne à votre script :

group01 = mainWindow.add("group", undefined, "Group 01");

Nous ajoutons le groupe à notre fenêtre principale, décrivant le type, les limites et les propriétés du texte. Puisque nous ajoutons un groupe, le premier argument est « groupe ». Encore une fois, vous pouvez laisser les limites indéfinies. Enfin, indiquez le nom que vous souhaitez donner au groupe. Ceci n'est pas affiché par défaut dans la fenêtre.

L'orientation par défaut des panneaux est par rangée. Si vous souhaitez changer cela en sorte de colonne, vous pouvez le faire en ajoutant ceci à votre script :

group01.orientation = "column";

Panneaux

Cependant, si vous fait souhaitez que le nom du groupe soit visible, vous pouvez envisager d'utiliser un objet "panel" à la place. Ce type d'objet est utile pour découper des parties de la fenêtre :

group02 = mainWindow.add("panel", undefined, "Group 02");

Il a les mêmes propriétés que l'objet "groupe", mais s'affiche légèrement différemment.

L'orientation par défaut des panneaux est par colonne. Si vous souhaitez modifier cela en sorte de ligne, vous pouvez le faire en ajoutant ceci à votre script :

group02.orientation = "row";

Texte

Il existe probablement 2 types de texte que vous souhaiteriez inclure dans votre script : le texte statique et le texte modifiable.

Texte statique
Le texte statique peut être utilisé pour les instructions destinées à l'utilisateur final. Ajoutez "statictext" à votre objet comme ceci :

//New Window
var mainWindow = new Window("palette", "Title", undefined);

Encore une fois, nous utilisons l'objet de contrôle add, avec le même type, les mêmes limites et les mêmes arguments de texte.

Texte modifiable
Le texte modifiable fournit un champ de zone de texte dans lequel l'utilisateur final peut saisir. Ceci est utile si notre script nécessite des informations de la part de l'utilisateur final, comme des calques de texte personnalisables. Ajoutez "edittext" à votre objet comme ceci :

mainWindow.show();

Il s’agit simplement d’un type d’objet différent. Le texte que nous fournissons dans l'argument texte se trouvera initialement dans la zone de texte, prêt à être supprimé et écrit par l'utilisateur final.

Comme vous pouvez le constater, la taille des cases n'étant pas définie, le texte dans la zone modifiable est légèrement coupé. Nous pouvons résoudre ce problème en définissant la taille après coup :

group01 = mainWindow.add("group", undefined, "Group 01");

Cela nous permet de rendre la taille de la zone de texte adaptable plus tard, si nous le souhaitons.

Boutons

Il est également probable que vous ayez besoin de boutons pour votre script, au moins pour donner à l'utilisateur final la possibilité de « exécuter » le script.

L'ajout d'un bouton est un processus similaire :

group01.orientation = "column";

Cela crée notre bouton.

Cependant, pour que notre bouton fasse quoi que ce soit, nous devrons indiquer à notre script quoi faire lorsque notre bouton est enfoncé. J'aime créer une fonction pour héberger toutes les tâches que je souhaite que le bouton accomplisse.

group02 = mainWindow.add("panel", undefined, "Group 02");

Ici, nous utilisons button01.onClick pour exécuter notre première fonction, où nous lui demandons d'exécuter app.beginUndoGroup("Tutorial") afin que l'annulation du script soit une seule action depuis After Effects. Ensuite, nous lui disons d'exécuter notre fonction completeTasks. En dessous, je définis la fonction completeTasks. Ici, incluez toutes les actions que vous souhaitez que votre bouton effectue (pour l'instant, le mien ne ferme que la fenêtre de script) et terminez la fonction en ajoutant app.endUndoGroup("Tutorial") pour fermer le groupe d'annulation.

J'entrerai plus en détail à ce sujet dans un prochain article.

Possibilités

D'autres options pour les objets de contrôle disponibles se trouvent dans le Guide des outils Javascript CC

Les objets tels que les cases à cocher, les menus déroulants, les boutons radio et les curseurs sont traités ici, pour n'en nommer que quelques-uns, et suivent des procédures similaires à l'ajout de texte ou de boutons.

Exemple

Connectons ce que nous avons appris sur Windows à l'article précédent et créons un exemple de script qui crée et ouvre une nouvelle composition.

//New Window
var mainWindow = new Window("palette", "Title", undefined);

Parcourons ce script.

Je commence par créer ma fenêtre et mes groupes. Group01 est mon "panneau", ajoutant le titre "description" au texte statique. Pendant ce temps, le reste de mes objets vont dans Group02, un objet "groupe". Puisque je veux que l'orientation du Groupe02 soit une colonne, je la définis ici.

Ensuite, je crée mes objets. Je commence avec mon texte statique à l'intérieur de Group01. Ensuite, je crée 2 objets edittext à l'intérieur de Group02, pour que l'utilisateur puisse spécifier la taille de la nouvelle composition qu'il souhaite créer, et je spécifie la taille de ces deux champs de texte. Enfin, je crée un bouton pour que le script puisse être exécuté par l'utilisateur final.

Une fois que j'ai créé toutes mes variables, je crée mes fonctions. J'ai d'abord défini ma fonction onClick pour mon bouton comme expliqué, en ouvrant le groupe d'annulation et en exécutant la fonction personnalisée completeTasks.

Je définis ensuite completeTasks. Tout d’abord, je dois utiliser parseInt() sur le texte des objets texte d’édition compWidth et compHeight. Cela les convertit du texte en nombres entiers, afin que le reste du script puisse comprendre les entrées. Une fois cela fait, je crée une nouvelle composition, en définissant la largeur et la hauteur sur les valeurs saisies par l'utilisateur. La composition est ensuite ouverte et devient la composition active, avant que la fenêtre de script ne se ferme et que la boucle d'annulation ne soit fermée.

L'exécution de ce script vous permet de créer une nouvelle composition définie sur les valeurs de largeur et de hauteur spécifiées dans les champs de texte.

Ce script peut être amélioré en ajoutant une alarme, si quelque chose qui n'est pas un entier est ajouté aux champs de texte (ou peut-être en définissant une valeur maximale), pour avertir l'utilisateur que le script a échoué. C’est quelque chose que j’aborderai plus en détail dans un autre article. Pour l'instant, s'il y a un caractère illégal dans le champ de texte, le script ne fonctionnera tout simplement pas tant que les champs de texte de largeur et de hauteur ne contiendront pas de chiffres.

Conclusion

Ceci conclut le guide du débutant sur la création de fenêtres pour les scripts After Effects à l'aide d'Adobe Extendscript Toolkit CC. Dans le prochain article, je couvrirai la création de différents types de calques pour vos compositions.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!