Mode d'emploi | Adobe After Effects CS3 Manuel utilisateur

GUIDE DES SCRIPTS
© Copyright 2007 Adobe Systems Incorporated. Tous droits réservés.
Guide des scripts d’After Effects® d’Adobe® Creative Suite 3
Remarque : toutes les informations contenues dans le présent document sont la propriété d’Adobe Systems Incorporated. Toute
reproduction ou diffusion du présent document (que ce soit au format électronique ou sous une forme imprimée), en tout ou partie, sous
quelque forme ou par quelque moyen que ce soit, électronique, mécanique, photocopie, enregistrement ou autre, sans l’autorisation écrite
préalable d’Adobe Systems Incorporated, est strictement interdite. Le logiciel décrit dans ce document est cédé sous licence et ne peut être
utilisé et/ou copié que conformément aux conditions de cette licence.
Ce document et les informations qu’il contient sont fournis TELS QUELS, peuvent être modifiés sans préavis et ne constituent pas un
engagement de la part d’Adobe Systems Incorporated. Adobe Systems Incorporated ne peut être tenu pour responsable des erreurs ou
des inexactitudes, n’apporte aucune garantie (expresse, implicite ou statutaire) concernant cette publication et rejette expressément toute
garantie de qualité marchande, d’adaptation à un objectif donné et de non-respect des droits de tiers.
Toute référence à des noms de société dans les exemples n’a qu’une valeur explicative et n’a pas pour objet de citer des organisations réelles.
Adobe, le logo Adobe, After Effects, Photoshop et Bridge sont des marques ou des marques déposées d’Adobe Systems Incorporated aux
Etats-Unis et/ou dans d’autres pays.
Apple, Mac, Macintosh et Mac OS sont des marques d’Apple Computer, Inc., déposées aux Etats-Unis et dans d’autres pays. Microsoft et
Windows sont des marques ou des marques déposées de Microsoft Corporation aux Etats-Unis et dans d’autres pays. JavaScript et toutes
les marques contenant Java sont des marques ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays.
UNIX est une marque déposée de The Open Group.
Toutes les autres marques appartiennent à leurs propriétaires respectifs.
Si ce guide accompagne un logiciel assorti d’un contrat de licence, le guide et le logiciel dont il traite sont cédés sous licence et ne peuvent
être copiés ou utilisés que conformément aux conditions générales de cette licence. Sauf autorisation spécifiée dans la licence, aucune partie
de ce guide ne peut être reproduite, enregistrée ou transmise sous quelque forme que ce soit, par quelque moyen que ce soit, électronique,
mécanique, enregistrement ou autre, sans l’autorisation écrite préalable d’Adobe Systems Incorporated. Nous attirons votre attention sur le
fait que le contenu du présent guide est protégé par les lois sur la propriété intellectuelle et ce, même s’il n’accompagne pas un logiciel
assorti d’un contrat de licence.
Les informations contenues dans ce guide sont données à titre purement indicatif. Elles peuvent être modifiées sans préavis et ne
constituent pas un engagement de la part d’Adobe Systems Incorporated. Adobe Systems Incorporated ne peut être tenu pour responsable
des erreurs ou des inexactitudes apparaissant dans les informations fournies par ce guide.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, Etats-Unis.
Présentation
Le Guide des scripts d’After Effects explique comment gérer vos projets After Effects en créant des procédures à
l’aide de scripts. Cet ensemble de fonctions est disponible dans Adobe® After Effects® CS3 Professional.
La création de script au niveau système permet de simplifier votre structure de rendu et d’éviter les nombreuses
opérations de pointer-cliquer répétitives. Si vous avez déjà eu l’occasion d’utiliser des expressions ou d’autres
techniques de type JavaScript pour l’animation, ou de travailler avec la création de script système dans
AppleScript ou Visual Basic, vous percevrez rapidement l’étendue des possibilités offertes par la création
de script dans l’application After Effects. Avec un peu de pratique et une bonne connaissance du langage
JavaScript, vous pouvez prendre le contrôle de votre structure graphique.
Si vous êtes novice en matière de création de script
After Effects est un outil visuel comportant une interface graphique utilisateur dont les éléments vous sont
familiers, notamment les menus, les panneaux et les icônes. Cette interface est le moyen le plus accessible
de travailler avec l’application. La création de script est conçue pour les situations dans lesquelles cette
méthodologie implique une répétition fastidieuse ou de lourdes opérations de recherche et de tri qui
pourraient être automatisées. La création de script permet d’automatiser les tâches rébarbatives et répétitives.
Elle est également utile pour tirer parti de la puissance du rendu en réseau dans les cas où le dossier de contrôle
est moins puissant (et moins pratique à configurer). Pour obtenir des exemples d’actions pouvant être
effectuées par les scripts, reportez-vous à la section « Exemples », page 175.
Si vous êtes novice en matière de création de script, consultez le manuel Adobe Introduction to Scripting, qui
présente les concepts de base de la création de script et décrit les différents langages disponibles, y compris
JavaScript. JavaScript et les autres langages de création de script sont orientés objet ; ce manuel expose ainsi
les concepts de base de la programmation orientée objet et des modèles d’objet de document.
Même si vous n’avez aucunement l’intention d’apprendre le langage JavaScript, vous pouvez néanmoins
exploiter la puissance de la création de script par le biais de solutions tierces telles que Rush Network Render
Queue, une interface graphique utilisateur permettant de configurer des rendus distribués depuis tout
ordinateur du réseau sans devoir les configurer sur les machines de manière individuelle.
Les utilisateurs qui créent des scripts peuvent par ailleurs partager leurs scripts avec les autres utilisateurs
pour une mise en commun efficace des ressources. Il est fréquent que les grands studios emploient ce type
d’utilisateurs maîtrisant la création de script. Les utilisateurs plus novices peuvent quant à eux visiter des
forums tels que ceux accessibles à l’adresse suivante : ww w.a dob ef or ums .com .
A propos de ce guide
Ce guide est destiné aux utilisateurs chargés de la gestion d’une structure graphique (laquelle peut inclure
d’autres applications scriptables) et qui souhaitent créer des scripts pour personnaliser After Effects.
Cette fonctionnalité est également offerte par des solutions tierces de gestion de rendu en réseau. Ces produits
comportent des éléments logiciels conçus pour faciliter la gestion de ce processus. Il est ainsi possible de tirer
profit de cette fonctionnalité sans devoir procéder à une édition manuelle des scripts.
3
Présentation
Edition de scripts
4
Le cœur d’une application scriptable est le modèle d’objet. Lorsque vous utilisez Adobe After Effects, vous
créez des projets, des compositions et des éléments de file d’attente de rendu, ainsi que tous les éléments qu’ils
contiennent, c’est-à-dire le métrage, les images, les solides, les calques, les masques, les effets et les propriétés.
En terminologie de création de script, chacun de ces éléments est un objet. Ce guide décrit les objets JavaScript
définis pour des projets After Effects.
Une grande partie de ce que la création de script permet de réaliser peut également être effectuée par le
biais de l’interface utilisateur After Effects. Une connaissance approfondie de l’application elle-même est,
par conséquent, essentielle pour savoir comment utiliser cette fonctionnalité.
Le modèle d’objet d’After Effects est composé d’un projet, d’éléments, de compositions, de calques et
d’éléments de file d’attente de rendu. Chaque objet possède ses propres attributs particuliers et chaque objet
d’un projet After Effects possède sa propre identité (bien que tous ne soient pas accessibles pour l’écriture de
scripts). Vous devez maîtriser le modèle d’objet d’After Effects pour pouvoir créer des scripts.
La création de script dans After Effects repose sur ECMAScript (plus précisément, sur la 3e édition de la
norme ECMA-262). Pour plus d’informations sur cette norme, consultez le site www.ecma-international.org. Pour
exploiter le potentiel de la création de script, vous devez également comprendre la rédaction de script au niveau
système (pour une intégration avec AppleScript ou l’application en ligne de commande Terminal sur Mac OS et les
scripts de ligne de commande sur les systèmes Windows) et posséder une connaissance préalable de JavaScript.
REMARQUE : les objets JavaScript habituellement appelés « propriétés » sont appelés « attributs » dans ce guide,
afin d’éviter toute confusion avec la définition du terme « propriété » propre à After Effects (une valeur animable
d’un effet, d’un masque ou d’une transformation dans un calque spécifique).
Expressions
Bien que les expressions et l’interface de création de script d’After Effects utilisent toutes les deux le langage
JavaScript et aient accès à chacune des propriétés des calques, il s’agit de deux entités complètement différentes.
Alors que les expressions n’ont pas accès aux informations des scripts (comme les variables et les fonctions), un
script peut être rédigé pour créer ou éditer une expression.
Etant donné que les expressions et la création de script utilisent toutes les deux le langage JavaScript, la
connaissance de l’une de ces fonctions facilite la compréhension de l’autre.
Equations
Les équations ne font plus partie d’After Effects, cette fonctionnalité ayant été remplacée par la création
de script et les expressions. Tous les opérateurs mathématiques et logiques communs à ECMAScript sont
disponibles pour la création de script.
Par exemple, avec les expressions, il est possible de simuler le rebond d’une balle en appliquant des règles
mathématiques à un calque « balle ». Avec la création de script, vous pouvez créer une interface utilisateur
complète permettant d’animer une balle rebondissante et un calque d’ombre au moyen de critères entrés
par l’utilisateur.
Edition de scripts
After Effects inclut un éditeur JavaScript. Pour le démarrer, choisissez Fichier > Scripts > Ouvrir l’éditeur de
script. Cet éditeur et débogueur de script, appelé ExtendScript Toolkit, fournit une interface conviviale vous
permettant de créer et de tester vos propres scripts.
Vous pouvez utiliser tout éditeur de texte pour créer, éditer et enregistrer des scripts, mais il est recommandé de
choisir une application qui n’ajoute pas automatiquement des informations d’en-tête lors de l’enregistrement
des fichiers et qui enregistre avec l’encodage Unicode (UTF-8).
4
Présentation
Activation des fonctionnalités complètes de création de script
5
• Les applications Windows utiles pour l’édition de scripts incluent EM Editor ou le Bloc-notes (assurez-vous
de définir le codage UTF-8 dans les options d’enregistrement).
• Les applications Mac OS utiles pour l’édition de scripts incluent BBEdit ou TextEdit intégré à OS X
(assurez-vous de définir Unicode [UTF-8] comme type d’enregistrement dans les préférences).
Format JSX d’ExtendScript
After Effects prend en charge ExtendScript, l’implémentation étendue de JavaScript d’Adobe. ExtendScript est
utilisé par toutes les applications Adobe qui disposent d’une interface de script. Outre l’implémentation du
langage JavaScript conformément aux spécifications ECMA 262 et E4X ECMA 357, ExtendScript offre des
fonctionnalités et utilitaires supplémentaires :
ExtendScript Toolkit : Pour vous aider à développer, déboguer et tester vos scripts, ExtendScript offre un
environnement interactif de développement et de test, ExtendScript Toolkit. Cet environnement définit
également un objet de débogage global, l’objet dollar ($), ainsi qu’un utilitaire de génération de rapports pour
les éléments ExtendScript, l’interface Reflection d’ExtendScript.
Objets File et Folder : Dans la mesure où la syntaxe des chemins varie considérablement d’un système
d’exploitation à l’autre, Adobe ExtendScript définit des objets F i l e et Fo l der permettant d’offrir un accès
indépendant de la plate-forme au système de fichiers sous-jacent.
Module d’interface utilisateur ScriptUI : Le module ScriptUI d’ExtendScript permet de créer des éléments
d’interface utilisateur et d’interagir avec ces derniers. ScriptUI offre un modèle d’objet pour les fenêtres et les
éléments de contrôle d’interface utilisateur que vous pouvez utiliser pour créer une interface utilisateur pour
vos scripts.
Outils et utilitaires : ExtendScript comporte également des outils et des fonctionnalités tels qu’un utilitaire
de localisation qui permet de spécifier des chaînes d’interface utilisateur en plusieurs langues, ainsi que des
fonctions globales d’affichage de messages brefs dans des boîtes de dialogue (aler t , con f i r m et promp t ).
Communication interapplication : ExtendScript met en place un environnement commun de création de script
pour l’ensemble des applications Adobe et permet les communications interapplication par le biais des scripts.
Communication externe : ExtendScript offre un objet S o cke t qui vous permet de communiquer avec des
systèmes distants à partir de vos scripts After Effects.
Ces fonctionnalités, ainsi que plusieurs autres, sont décrites en détail dans le manuel JavaScript Tools Guide,
fourni avec After Effects et disponible à partir du Pôle de développement Adobe (http://www.adobe.fr/devnet/).
Les fichiers de script ExtendScript portent l’extension .j sx , une variation de l’extension .j s standard qui
caractérise normalement les fichiers JavaScript. Les scripts After Effects doivent être dotés de l’extension de
fichier .j sx pour pouvoir être correctement reconnus par l’application. Tout fichier texte au format UTF-8 et
portant l’extension .j sx est admis en tant que fichier ExtendScript.
Vous pouvez utiliser ExtendScript Toolkit pour exporter une version binaire d’un fichier ExtendScript portant
l’extension . js xb i n . Ce fichier binaire ne sera pas forcément utilisable avec toutes les fonctionnalités
d’intégration de script proposées par After Effects.
Activation des fonctionnalités complètes de création de script
Pour des raisons de sécurité, les fonctionnalités de création de script opérant en dehors de l’application
After Effects (telles que l’ajout et la suppression de fichiers et de dossiers sur des volumes, ou l’accès au réseau)
sont désactivées par défaut.
5
Présentation
Accès aux scripts et écriture des scripts
6
Pour activer ces fonctionnalités, choisissez Préférences > Général, puis sélectionnez « Autoriser les scripts
à écrire des fichiers et à accéder au réseau ». Vous pouvez alors effectuer les opérations suivantes :
• écrire dans des fichiers ;
• créer des dossiers et définir le dossier actif ;
• créer une connexion par socket (pour plus d’informations sur cet utilitaire JavaScript, consultez le manuel
JavaScript Tools Guide).
Adobe met à votre disposition un débogueur JavaScript complet, appelé ExtendScript Toolkit. Ce dernier est
désactivé par défaut de façon à ce que les utilisateurs non expérimentés ne le rencontrent pas. Lors de l’édition
ou de l’écriture de scripts, Toolkit permet de diagnostiquer les problèmes de script plus rapidement. Pour
activer Toolkit sur la machine locale en cas d’erreur de script, choisissez Préférences > Général, puis cochez
la case Activer le débogage JavaScript. Pour obtenir des informations détaillées sur ExtendScript Toolkit,
consultez le manuel JavaScript Tools Guide.
Toolkit ne fonctionne que lors de l’exécution d’un script, pas avec les expressions, même si les expressions
utilisent également JavaScript.
Accès aux scripts et écriture des scripts
Pour créer et modifier des scripts pour After Effects, vous pouvez utiliser ExtendScript Toolkit ou une
application externe d’édition de texte créant des fichiers avec l’encodage de texte Unicode UTF-8. Evitez
les applications telles que Microsoft Word qui ajoutent par défaut des informations d’en-tête aux fichiers ;
ces informations créent des erreurs de ligne 0 dans les scripts, ce qui empêche leur exécution.
Un script peut résider à tout endroit, mais pour apparaître dans le menu Scripts, il doit être sauvegardé
dans le dossier Scripts, lui-même situé dans le dossier de l’application After Effects.
L’application n’intègre pas de méthode permettant l’enregistrement dans un script d’une série d’actions
réalisées dans After Effects, comme cela est possible avec les scripts Adobe Photoshop®. Les scripts sont créés
en dehors d’After Effects, puis exécutés à l’intérieur ou à l’extérieur de ce programme au moyen d’une ligne
de commande, d’ExtendScript Toolkit ou d’un logiciel de gestion de rendu tiers.
Menu et dossier Scripts
Les scripts After Effects résident dans le dossier Scripts, situé dans le même dossier que votre fichier
d’application After Effects. Bien qu’un fichier de script puisse résider à un autre endroit, seuls les scripts
contenus dans ce dossier Scripts lors du démarrage de l’application figurent automatiquement dans le
menu Scripts.
Pour exécuter un script n’apparaissant pas dans le menu Scripts, sélectionnez Fichier > Scripts > Exécuter
le fichier de script, puis choisissez le script dans la boîte de dialogue Ouvrir. Une autre solution consiste à
envoyer un script à After Effects à partir d’ExtendScript Toolkit, d’une ligne de commande (sous Windows)
ou d’AppleScript (sous Mac OS).
Pour apparaître dans la boîte de dialogue Ouvrir, votre script doit être doté de l’extension de fichier .j sx .
Dossiers Shutdown (arrêt) et Startup (démarrage)
Le dossier Scripts contient deux sous-dossiers appelés Startup et Shutdown. After Effects exécute
automatiquement, dans l’ordre alphabétique, les scripts contenus dans ces dossiers lors du démarrage
et de la fermeture de l’application.
Vous pouvez placer dans le dossier Startup les scripts que vous souhaitez exécuter au démarrage de
l’application. Une fois l’application initialisée, ces scripts seront exécutés et tous les modules seront chargés.
6
Présentation
Accès aux scripts et écriture des scripts
7
La création de script partageant un environnement global, tout script exécuté au démarrage peut définir
des variables et des fonctions disponibles pour tous les scripts. Dans tous les cas de figure, les variables et les
fonctions, une fois définies en exécutant un script les contenant, sont conservées dans les scripts suivants au
cours de la même session After Effects. Une fois l’application fermée, toutes ces variables et fonctions définies
au niveau global sont supprimées. Il est essentiel de nommer les variables de façon unique afin de ne pas
remplacer par erreur une variable globale, censée être préservée pendant toute une session.
Des attributs peuvent également être ajoutés aux objets existants tels que l’objet Application (voir la section
« Objet Application », page 19) pour étendre l’application à d’autres scripts.
Les scripts contenus dans le dossier Shutdown sont exécutés au moment de la fermeture de l’application.
Ces exécutions sont réalisées une fois le projet fermé, mais avant la fermeture de toute autre application.
Menu Fenêtre et dossier ScriptUI Panels (panneaux ScriptUI)
Dans le dossier Scripts, vous pouvez créer un autre dossier nommé ScriptUI Panels. Utilisez ce dossier pour
les scripts dont l’interface utilisateur apparaît dans un panneau natif (et non dans une palette flottante, une
boîte de dialogue ou une fenêtre). L’avantage d’un panneau réside dans sa capacité à être ancré dans d’autres
panneaux, comme les panneaux Projet, Composition et Navigation, ce qui lui permet de paraître ainsi mieux
intégré à l’application. Tout comme les panneaux natifs, les scripts du dossier ScriptUI Panels sont accessibles
à partir du menu Fenêtre.
Au lieu de créer un objet Window et d’y intégrer des commandes, les scripts du dossier ScriptUI Panels
utilisent l’objet « this » représentant le panneau. Par exemple, le code suivant ajoute un bouton à un panneau :
v ar my Pan e l = t hi s ;
my Pan e l . a dd ( " b u t ton " , [ 1 0 , 1 0 , 1 0 0 , 3 0 ] , " To o l # 1" ) ;
my Pan e l .s how ( );
Si votre script crée son interface utilisateur dans une fonction, vous ne pouvez pas utiliser l’objet « this »
puisqu’il se rapporte à la fonction elle-même et non au panneau. Dans ce cas, vous devez utiliser l’objet « this »
en tant qu’argument de votre fonction. Par exemple :
f u n c t io n c re a teU I ( th i s O b j) {
v ar my Pan e l = t hi s O b j ;
my Pan e l . a dd ( " b u t ton " , [ 1 0 , 1 0 , 1 0 0 , 3 0 ] , " To o l # 1" ) ;
re tur n my Pan el ;
}
v ar my To ol sPane l = c reateUI (t hi s) ;
my To ol sPa n e l .sh ow () ;
Vous ne pouvez pas utiliser la commande de menu Fichier > Scripts > Exécuter le fichier de script pour
exécuter un script renvoyant à un objet « this ». Pour permettre à votre script de fonctionner avec un objet
Window (accessible à partir du menu Fichier > Scripts) ou avec un panneau natif (accessible à partir du menu
Fenêtre), vérifiez que l’objet « this » est bien un objet Panel. Par exemple :
f u n c t io n c re a teU I ( th i s O b j) {
v ar my Pan e l = ( t h i s O b j i n s t a n ce o f Pa n e l ) ? t h is O b j : n ew Wi n d ow ( " p a l e t te " , " My To o l s " ,
[100 , 10 0, 3 00, 3 00]);
my Pan e l . a dd ( " b u t ton " , [ 1 0 , 1 0 , 1 0 0 , 3 0 ] , " To o l # 1" ) ;
re tur n my Pan el ;
}
v ar my To ol sPane l = c reateUI (t hi s) ;
my To ol sPa n e l .sh ow () ;
7
Présentation
Envoi d’un script à After Effects à partir du système
8
Envoi d’un script à After Effects à partir du système
Si vous savez comment exécuter un script à partir de la ligne de commande sous Windows ou avec AppleScript,
vous pouvez envoyer un script directement à l’application After Effects ouverte pour que celle-ci l’exécute
automatiquement.
Inclusion de la création de script After Effects dans une ligne de commande (Windows)
Voici plusieurs exemples de commandes pour la ligne de commande Windows qui envoient un script
After Effects à l’application sans passer par l’interface utilisateur After Effects.
Dans le premier exemple, vous devez copier et coller votre script After Effects directement dans la ligne de
commande puis l’exécuter. Le texte du script s’affiche entre guillemets après la commande af ter f x.exe -s :
a ft er f x . e xe - s " a l e r t ( " You ju s t s en t a n a l e r t to A f ter E f f e c ts " ) "
Une autre solution consiste à spécifier l’emplacement du fichier JSX à exécuter. Par exemple :
a ft er f x . e xe - r c : \ my D o c u m e n t s \ S c r i p t s\ yo u r AE S c r i p t Here . j s x
a ft er f x . e xe - r " c : \ my D oc u m e n t s \ S c r i p t s\ S c r ip t Na m e w i th S pa ce s. js x"
Inclusion de la création de script After Effects dans un AppleScript (Mac OS)
Voici trois exemples de scripts AppleScript envoyant un fichier JSX existant contenant un script After Effects
à l’application sans utiliser l’interface utilisateur After Effects pour exécuter le script.
Dans le premier exemple, vous devez copier votre script After Effects directement dans l’éditeur de script puis
l’exécuter. Le texte du script s’affiche entre guillemets après la commande DoScript ; par conséquent, tout
guillemet contenu dans cette chaîne doit être précédé d’une barre oblique inversée servant de caractère
d’échappement, tel qu’indiqué ci-dessous :
te l l app l icat ion "Adobe Af ter Ef fe ct s CS 3 "
D o S c r ip t " al e r t( \ " Yo u jus t s e n t a n aler t to After Ef fec t s\") "
e n d te l l
Une autre solution consiste à afficher une boîte de dialogue demandant l’emplacement du fichier JSX à
exécuter, tel qu’indiqué ci-dessous :
s et t heF i l e to ch o o se fi l e
te l l app l icat ion "Adobe Af ter Ef fe ct s CS 3 "
D oS c r ip t th eF i l e
e n d te l l
Enfin, ce script est peut-être le plus utile lorsque vous travaillez directement sur l’édition d’un script JSX et
souhaitez l’envoyer à After Effects pour le tester ou l’exécuter. Pour l’utiliser efficacement, vous devez spécifier
l’application contenant le fichier JSX ouvert (dans cet exemple, il s’agit de TextEdit) ; si vous ne connaissez pas
le nom exact de l’application, tapez ce qui s’en approche le plus à la place de « TextEdit », et AppleScript vous
invitera à la localiser.
8
Présentation
Essais et dépannage
9
Mettez simplement en évidence le texte de script que vous souhaitez exécuter, puis activez cet AppleScript :
(*
T h i s s c r ip t sen d s th e c u r re n t s e l e c t i o n to A fter E ff e c ts as a s c r i pt .
*)
te l l a p p l i c a t i o n " Tex t E d it "
s e t t h e _ s c r i p t to s e l e c t i o n as text
e n d te l l
te l l app l icat ion "Adobe Af ter Ef fe ct s CS 3 "
a c t iva te
D o S c r ip t th e _ s c r i p t
e n d te l l
Pour plus d’informations sur l’utilisation d’AppleScript, reportez-vous au manuel AppleScript: the Definitive
Guide de Matt Neuberg (éditions O’Reilly & Associates) ou AppleScript 1-2-3 de Sal Soghoian (éditions
Peachpit Press).
Essais et dépannage
Tout script After Effects contenant une erreur empêchant son exécution complète génère un message d’erreur
dans l’application. Ce message inclut des informations sur la nature de l’erreur et la ligne du script sur laquelle
elle est survenue.
After Effects inclut par ailleurs un outil de débogage JavaScript. Pour plus de détails sur l’activation et l’utilisation
du débogueur, consultez la section relative à ExtendScript Toolkit du manuel JavaScript Tools Guide.
Autres ressources d’apprentissage de la création de script
Il existe de nombreuses ressources permettant d’approfondir ses connaissances de la création de script selon
la norme ECMA.
Le moteur de création de script After Effects prend en charge la 3e édition de la norme ECMA-262, y compris
ses conventions de notation et lexicales, ses types, objets, expressions et instructions.
Pour obtenir une liste complète des mots-clés et opérateurs inclus avec ECMAScript, reportez-vous au
document ECMA-262.pdf, disponible à l’adresse suivante : www.ecma-international.org/publications/
standards/Ecma-262.htm.
Les ouvrages traitant de JavaScript 1.2 sont également utiles à la compréhension du fonctionnement de la création
de script dans After Effects. L’ouvrage JavaScript, The Definitive Guide de David Flanagan (éditions O’Reilly)
constitue, en quelque sorte, une bible pour les utilisateurs de JavaScript. Une autre source tout à fait
recommandable est l’ouvrage JavaScript: A Beginner’s Guide de John Pollock (éditions Osborne). Ces deux ouvrages
contiennent des informations concernant en particulier les extensions de JavaScript pour les navigateurs Internet,
tout en offrant également des explications détaillées des principes de base de la création de script.
Il existe également des ouvrages sur l’utilisation d’AppleScript et la création de scripts de ligne de commande
Windows, ces deux solutions pouvant être utilisées pour envoyer des scripts à After Effects.
9
Présentation
Autres ressources d’apprentissage de la création de script
10
Variables JavaScript
La création de script partageant un environnement global, tout script exécuté au démarrage peut définir
des variables et des fonctions disponibles pour tous les scripts. Dans tous les cas de figure, les variables et les
fonctions, une fois définies en exécutant un script les contenant, sont conservées dans les scripts suivants au
cours de la même session After Effects. Une fois l’application fermée, toutes ces variables et fonctions définies
au niveau global sont supprimées. Il est essentiel de nommer les variables de façon unique de façon à ne pas
remplacer par erreur une variable globale, censée être préservée pendant toute une session.
Mots-clés et syntaxe d’instructions JavaScript
Bien qu’il ne soit pas possible de fournir une ressource exhaustive décrivant l’utilisation de JavaScript, les
tableaux ci-après présentent les mots-clés, les instructions, les opérateurs, la priorité et l’associativité.
Le tableau ci-dessous énumère et décrit tous les mots-clés et instructions reconnus par le moteur de création
de script After Effects.
Tableau 1
Mots-clés et syntaxe d’instructions
Mot-clé/Instruction
Description
b re a k
JavaScript standard ; quitte la boucle en cours d’exécution.
con t i nue
JavaScript standard ; arrête l’exécution de l’itération de la boucle en cours.
case
Libellé utilisé dans une instruction s w i tch .
def a ul t
Libellé utilisé dans une instruction s w i tch lorsqu’un libellé c a s e est introuvable.
do. ..w hile
Construction JavaScript standard. Similaire à la boucle w hi l e , excepté que l’évaluation de la
condition de boucle est effectuée à la fin de la boucle.
f al s e
Littéral correspondant au booléen false.
for
Construction de boucle JavaScript standard.
for.. .i n
Construction JavaScript standard. Fournit un moyen aisé d’appliquer une boucle à travers les
propriétés d’un objet.
f u n c t io n
Utilisé pour définir une fonction.
i f / if . . . e ls e
Constructions conditionnelles JavaScript standard.
new
Instruction de constructeur JavaScript standard.
nu l l
Attribué à une variable, un élément de tableau ou une propriété d’objet pour indiquer qu’il ou elle
ne contient pas de valeur autorisée.
re tur n
Moyen JavaScript standard de renvoyer une valeur à partir d’une fonction ou de quitter une fonction.
s w itch
Moyen JavaScript standard d’évaluer une expression et de tenter de faire correspondre la valeur de
l’expression à un libellé c a s e .
t hi s
Méthode JavaScript standard utilisée pour indiquer l’objet en cours.
t r ue
Littéral correspondant au booléen true.
un define d
Indique que la variable, l’élément de tableau ou la propriété d’objet n’a pas encore reçu de valeur.
v ar
Syntaxe JavaScript standard utilisée pour déclarer une variable locale.
w hi l e
Construction JavaScript standard. Similaire à la boucle do.. .w h i le , excepté que l’évaluation de la
condition de boucle est effectuée au début de la boucle.
w i th
Construction JavaScript standard utilisée pour spécifier un objet à utiliser dans les instructions dont
elle est suivie.
10
Présentation
Autres ressources d’apprentissage de la création de script
11
Opérateurs JavaScript
Les tableaux ci-après énumèrent et décrivent tous les opérateurs reconnus par le moteur de création de script
After Effects et indiquent la priorité et l’associativité de tous les opérateurs.
Tableau 2
Description des opérateurs
Opérateurs
Description
new
Alloue un objet.
de l e te
Annule l’allocation d’un objet.
t y p e of
Renvoie le type de données.
voi d
Renvoie la valeur indéfinie.
.
Membre de la structure.
[]
Elément de tableau.
()
Appel de fonction.
++
Pré- ou post-incrément.
––
Pré- ou post-décrément.
–
Négation ou soustraction unaire.
~
NOT au niveau bit.
!
NOT logique.
*
Produit.
/
Division.
%
Division modulo.
+
Addition.
<<
Décalage vers la gauche au niveau du bit.
>>
Décalage vers la droite au niveau du bit.
> >>
Décalage non signé vers la droite au niveau du bit.
<
Inférieur.
<=
Inférieur ou égal.
>
Supérieur.
>=
Supérieur ou égal.
==
Egal.
!=
Différent.
&
AND au niveau bit.
^
XOR au niveau bit.
|
OR au niveau bit.
&&
AND logique.
||
OR logique.
?:
Conditionnel (ternaire).
11
Présentation
Autres ressources d’apprentissage de la création de script
12
Opérateurs
Description
=
Attribution.
+=
Attribution avec l’opération d’addition.
–=
Attribution avec l’opération de soustraction.
*=
Attribution avec l’opération de multiplication.
/=
Attribution avec l’opération de division.
%=
Attribution avec l’opération de division modulo.
< <=
Attribution avec l’opération de décalage vers la gauche au niveau du bit.
> >=
Attribution avec opération de décalage vers la droite au niveau du bit.
> >> =
Attribution avec opération de décalage vers la droite non signée au niveau du bit.
&=
Attribution avec opération AND au niveau du bit.
^=
Attribution avec opération XOR au niveau du bit.
|=
Attribution avec opération OR au niveau du bit.
,
Evaluation multiple.
Tableau 3
Priorité des opérateurs
Opérateurs (de la priorité la plus élevée à la plus faible)
Associativité
[ ], () , .
gauche à droite
new, dele te , – ( n ég at ion una ire) , !, t y p e of , void , + +, ––
droite à gauche
*, /, %
gauche à droite
+ , – ( sou st r a c t i on )
gauche à droite
< <, >> , > >>
gauche à droite
< , < =, > , > =
gauche à droite
= =, !=
gauche à droite
&
gauche à droite
^
gauche à droite
|
gauche à droite
&&
gauche à droite
||
gauche à droite
?:
droite à gauche
= , /= , % =, << =, > > =, > > >= , &=, ^= , |= , += , –= , *=
droite à gauche
,
gauche à droite
12
Référence JavaScript
Ce chapitre énumère et décrit les classes, objets, méthodes, attributs et fonctions globales définis par After Effects.
Le moteur de création de script After Effects prend en charge ExtendScript, la version étendue de JavaScript
d’Adobe, qui implémente la 3e édition de la norme ECMA-262, y compris ses conventions de notation et
lexicales, ses types, objets, expressions et instructions. Pour obtenir une liste complète des mots-clés et
opérateurs inclus avec ECMAScript, reportez-vous au document E C M A- 2 6 2 . p d f , disponible à l’adresse
suivante : www.ecma-international.org/publications/standards/Ecma-262.htm. Pour avoir une vue générale
des mots-clés et instructions les plus courants disponibles en ECMA-262, reportez-vous à la section « Motsclés et syntaxe d’instructions JavaScript », page 10.
Modèle d’objet d’After Effects
Au fil de votre lecture de cette section de référence, qui reprend les objets par ordre alphabétique, vous pouvez
vous reporter aux schémas suivants pour avoir une vue générale de la position des différents objets dans la
hiérarchie et de leur correspondance dans l’interface utilisateur.
system
application
settings
folder
socket
item(s) peuvent être l’un des trois types d’élément suivants :
project
compItem
renderQueue
file
footageItem
OU
folderItem
OU
item(s)
layer(s)
item(s)
proxySource
renderQueueItem(s)
properties
mainSource
proxySource
mainSource & proxySource
peuvent être l’un des trois types d’élément suivants :
outputModule(s)
solidSource
color
OU
placeholderSource
OU
fileSource
file
Schéma hiérarchique des principaux objets de création de scripts After Effects
Notez que les objets File, Folder et Socket sont définis par ExtendScript et présentés dans le manuel JavaScript
Tools Guide. ExtendScript définit également le module ScriptUI, jeu d’objets de contrôle d’interface utilisateur
et de fenêtres, auquel peuvent accéder les scripts After Effects. Ces objets de contrôle sont également présentés
dans le manuel JavaScript Tools Guide.
La hiérarchie d’objets pour la création de script correspond à la hiérarchie de l’interface utilisateur.
13
Référence JavaScript
Modèle d’objet d’After Effects
14
L’application contient un panneau Projet qui affiche un projet. Le projet contient des compositions, contenant
elles-mêmes des calques. La source d’un calque peut être un fichier de métrage, un pseudo-élément ou un solide,
et figure également dans le panneau Projet. Chaque calque contient des paramètres appelés propriétés, qui
peuvent contenir des repères et des images clés. La file d’attente de rendu contient des éléments de file d’attente
de rendu, ainsi que des paramètres de rendu et des modules de sortie. Dans le contexte de la création de script,
toutes ces entités sont représentées par des objets.
REMARQUE : dans ce guide, pour éviter toute ambiguïté, le terme « attribut » fait référence aux propriétés des
objets JavaScript et le terme « propriété » ou « propriété AE » fait référence aux propriétés de calque After Effects.
Liste des objets
Le tableau suivant répertorie tous les objets par ordre alphabétique et renvoie aux pages correspondantes.
Objet
Description
« Fonctions globales », page 16
Fonctions disponibles au niveau global. Elles vous permettent d’afficher du texte destiné
au débogage de script et aident à convertir des secondes en images.
« Objet Application », page 19
Objet global unique, disponible via son nom (app ). Il donne accès aux paramètres
des objets et des applications au sein de l’application After Effects.
« Objet AVItem », page 32
Représente les fichiers audiovisuels importés dans After Effects.
« Objet AVLayer », page 39
Représente les calques qui contiennent des objets AVItem (calques de composition,
de métrage, de solide, de texte et de son).
« Objet CameraLayer », page 50
Représente un calque de caméra dans une composition.
« Objet Collection », page 51
Associe un jeu d’objets ou de valeurs en tant que groupe logique, et donne accès à ces
objets ou valeurs via un index.
14
Référence JavaScript
Modèle d’objet d’After Effects
15
Objet
Description
« Objet CompItem », page 52
Représente une composition, vous permet de la manipuler et d’obtenir des informations
sur elle.
« Objet FileSource », page 60
Décrit le métrage issu d’un fichier.
« Objet FolderItem », page 62
Représente un dossier du panneau Projet.
« Objet FootageItem », page 64
Représente un élément de métrage importé dans un projet, qui apparaît dans le
panneau Projet.
« Objet FootageSource », page 67
Décrit la source du fichier d’un métrage.
« Objet ImportOptions », page 73
Incorpore des options pour l’importation de fichiers dans After Effects.
« Objet Item », page 76
Représente un élément dans un projet qui apparaît dans le panneau Projet.
« Objet ItemCollection », page 79
Rassemble des éléments dans un projet.
« Objet KeyframeEase », page 81
Incorpore des valeurs de lissage d’images clés dans une propriété After Effects.
« Objet Layer », page 83
Classe de base pour les classes de calques.
« Objet LayerCollection », page 92
Rassemble des calques dans un projet.
« Objet LightLayer », page 97
Représente un calque de lumière dans une composition.
« Objet MarkerValue », page 98
Incorpore des valeurs de repère dans une propriété After Effects.
« Objet MaskPropertyGroup », page 102
Incorpore des attributs de masque dans un calque.
« Objet OMCollection », page 105
Rassemble des modules de sortie dans une file d’attente de rendu.
« Objet OutputModule », page 106
Représente un module de sortie pour une file d’attente de rendu.
« Objet PlaceholderSource », page 109
Décrit un pseudo-élément pour métrage.
« Objet Project », page 110
Représente un projet After Effects.
« Objet Property », page 119
Représente une propriété After Effects.
« Objet PropertyBase », page 141
Classe de base pour des classes de propriétés et de groupes de propriétés After Effects.
« Objet PropertyGroup », page 148
Représente un groupe de propriétés After Effects.
« Objet RenderQueue », page 153
Représente la file d’attente de rendu After Effects.
« Objet RenderQueueItem », page 156
Représente un élément de rendu dans une file d’attente de rendu.
« Objet RenderQueueItem », page 156
Rassemble des éléments de file d’attente de rendu dans une file d’attente de rendu.
« Objet RQItemCollection », page 163
Donne accès aux paramètres et préférences de l’application.
« Objet Shape », page 166
Incorpore la forme du contour d’un masque.
« Objet ShapeLayer », page 169
Représente un calque de forme dans une composition.
« Objet SolidSource », page 170
Décrit une couleur unie correspondant à la source d’un métrage.
« Objet System », page 171
Donne accès au système d’exploitation à partir de l’application.
« Objet TextDocument », page 173
Incorpore le texte dans un calque de texte.
« Objet TextLayer », page 174
Représente un calque de texte dans une composition.
15
Référence JavaScript
Fonctions globales
16
Fonctions globales
Ces fonctions, disponibles au niveau global, sont spécifiques à After Effects. Tout objet ou fonction JavaScript peut
appeler ces fonctions. Elles vous permettent d’afficher du texte JavaScript dans une zone de petite taille (3 lignes) du
panneau Info et de convertir des valeurs temporelles numériques en valeurs de type chaîne, et inversement.
Fonction globale
Description
cl e arO ut put ()
Efface le texte du panneau Info.
c u r re n t Fo r m a t To Ti m e ( )
Convertit une valeur temporelle de type chaîne en valeur temporelle numérique.
t i m eToCur ren t For m at ()
Convertit une valeur temporelle numérique en valeur temporelle de type chaîne.
w r ite( )
Ecrit du texte dans le panneau Info, sans ajout de saut de ligne.
w r ite L n ( )
Ecrit du texte dans le panneau Info, en ajoutant un saut de ligne à la fin.
Des fonctions globales supplémentaires pour les E/S utilisateur standard (aler t , con fi r m et promp t ) et
des fonctions statiques pour les E/S de fichier sont définies par ExtendScript. Pour plus d’informations,
reportez-vous au Guide de référence JavaScript d’Adobe Bridge®.
REMARQUE : les fonctions globales d’After Effects pour les boîtes de dialogue standard et les E/S de fichier sont
toujours prises en charge dans cette version, mais sont désormais obsolètes et ne seront pas prises en charge dans
les prochaines versions. Pour plus d’informations, reportez-vous à la documentation relative à After Effects 6.5.
Fonction globale clearOutput()
cl e arO ut put ()
Description
Efface la sortie dans le panneau Info.
Paramètres
Aucun.
Renvoi
Aucun.
Fonction globale currentFormatToTime()
c u r re n t Fo r m a t To Ti m e ( fo r m at te d Ti m e, f ps , is D ura t io n )
Description
Convertit une chaîne formatée d’instant d’image en nombre de secondes, selon une cadence d’image spécifiée.
Par exemple, si l’instant de l’image formatée est 0:00:12 (le format de chaîne exact est déterminé par un
paramètre de projet) et que la cadence d’image est de 24 i/s, l’instant sera 0,5 seconde (12/24). Si la cadence
d’image est de 30 i/s, l’instant sera 0,4 seconde (12/30).
Si l’instant est une durée, le décompte des images commence à partir de zéro (0). Sinon, les images sont décomptées
à partir de la première image du projet (voir la section « Attribut Project displayStartFrame », page 113).
16
Référence JavaScript
Fonctions globales
17
Paramètres
for m at ted Tim e
Valeur d’instant de l’image, chaîne spécifiant un nombre d’images selon le format d’affichage de l’instant
actuel du projet.
fps
Nombre d’images par seconde, valeur à virgule flottante.
i s D u r a ti o n
Facultatif. Lorsque ce paramètre est défini sur true, l’instant est une durée (mesurée à partir de l’image 0).
Lorsqu’il est défini sur false (valeur par défaut), l’instant est calculé à partir de la première image du projet.
Renvoi
Valeur à virgule flottante, nombre de secondes.
Fonction globale timeToCurrentFormat()
t i m eToCur ren t For m at (t im e , f p s , is D ura t i on )
Description
Convertit une valeur temporelle numérique (un nombre de secondes) en valeur temporelle d’image, c’est-àdire en une chaîne formatée qui indique l’image correspondant à cet instant, selon la cadence spécifiée. Par
exemple, si l’instant est 0,5 seconde et que la cadence d’image est de 24 i/s, l’image est 0:00:12 (lorsque le projet
est défini sur Display Timecode). Si la cadence est de 30 i/s, l’image est 00:00:15. Le format de la chaîne de code
temporel est défini par un paramètre de projet.
Si l’instant est une durée, le décompte des images commence à partir de zéro (0). Sinon, les images sont décomptées
à partir de la première image du projet (voir la section « Attribut Project displayStartFrame », page 113).
Paramètres
time
Nombre de secondes, valeur à virgule flottante.
fps
Nombre d’images par seconde, valeur à virgule flottante.
i s D u r a ti o n
Facultatif. Lorsque ce paramètre est défini sur true, l’instant est une durée (mesurée à partir de l’image 0).
Lorsqu’il est défini sur false (valeur par défaut), l’instant est calculé à partir de la première image du projet.
Renvoi
Chaîne dans le format d’affichage de l’instant actuel du projet.
Fonction globale write()
w r ite( te x t )
Description
Ecrit la sortie dans le panneau Info, sans ajout de saut de ligne.
Paramètres
tex t
Chaîne à afficher. Elle est tronquée lorsqu’elle est trop longue pour être affichée dans le panneau Info.
Renvoi
Aucun.
17
Référence JavaScript
Fonctions globales
18
Exemple
w r ite ( " T h i s text ap p e a r s i n In fo p a n e l " ) ;
w r ite ( " w it h m o re o n s a m e l i n e . " ) ;
Fonction globale writeLn()
w r ite L n ( t e x t)
Description
Ecrit la sortie dans le panneau Info, en ajoutant un saut de ligne à la fin.
Paramètres
tex t
Chaîne à afficher.
Renvoi
Aucun.
Exemple
w r ite l n ( " T h is tex t a pp e ars on f i r s t l i n e " ) ;
w r ite l n ( " T h is tex t a pp e ars on s e con d l i n e " );
18
Référence JavaScript
Objet Application
19
Objet Application
a pp
Description
Donne accès aux paramètres des objets et des applications au sein de l’application After Effects. L’objet global
unique est toujours disponible via son nom, ap p .
Les attributs de l’objet Application fournissent l’accès aux objets spécifiques dans After Effects. Les méthodes de
l’objet Application peuvent créer un projet, ouvrir un projet existant, contrôler le mode Dossier de contrôle,
vider la mémoire et quitter l’application After Effects. Lors de la fermeture de l’application After Effects, celle-ci
ferme le projet ouvert en demandant à l’utilisateur d’enregistrer ou d’ignorer les modifications, et crée un fichier
de projet comme nécessaire.
Attributs
Attribut
Référence
Description
proj ec t
« Attribut Application project », page 28 Projet After Effects en cours.
et « Objet Project », page 110
language
« Attribut Application language »,
page 24
vers i on
« Attribut Application version », page 30 Numéro de version de l’application After Effects.
b u i l dNa m e
« Attribut Application buildName »,
page 21
Nom de cette compilation de l’application.
b u i l dNu m b e r
« Attribut Application buildNumber »,
page 22
Numéro de cette compilation de l’application.
i s Wa tch Fo l der
« Attribut Application isWatchFolder »,
page 24
Lorsque cet attribut est défini sur true, l’application
locale est exécutée en mode Dossier de contrôle.
i s Ren d e r E n g i n e
« Attribut Application isRenderEngine », Lorsque cet attribut est défini sur true, l’application
page 24
After Effects locale est exécutée en tant que moteur
de rendu.
s e tt i n g s
« Attribut Application settings »,
page 30 et « Objet RQItemCollection »,
page 163
o n E r ror
« Attribut Application onError », page 26 Fonction de rappel appelée lorsqu’une erreur survient
dans l’application.
e x i t Cod e
« Attribut Application exitCode »,
page 24
Code numérique d’état utilisé lors de l’exécution d’un
script en externe (c’est-à-dire à partir d’une ligne de
commande ou d’AppleScript). Zéro (0) indique qu’aucune
erreur n’est survenue. Un nombre positif indique qu’une
erreur est survenue lors de l’exécution du script.
e xi t Af ter L a u n ch A n d Eva l
« Attribut Application
exitAfterLaunchAndEval », page 23
Lorsque cet attribut est défini sur true, l’application doit
rester ouverte après l’exécution d’un script à partir de la
ligne de commande sous Windows.
s avePro je c t On Cr as h
« Attribut Application
saveProjectOnCrash », page 29
Lorsque cet attribut est défini sur true, le projet est
enregistré au cas où l’application viendrait à se fermer
de façon inattendue.
m e m o r y In Us e
« Attribut Application memoryInUse »,
page 25
Mémoire utilisée par cette application.
Langue dans laquelle l’application est exécutée.
Paramètres de l’application pouvant être définis par le
biais de la création de script.
19
Référence JavaScript
Objet Application
20
Méthodes
Méthode
Référence
Description
newPro jec t ()
« Méthode Application newProject() »,
page 25
Crée un nouveau projet dans After Effects.
open()
« Méthode Application open() », page 26
Ouvre un projet ou une boîte de dialogue
Ouvrir le projet.
qui t ()
« Méthode Application quit() », page 28
Ferme l’application.
w atch Fo l der ( )
« Méthode Application watchFolder() »,
page 30
Démarre le mode Dossier de contrôle ; ne renvoie
rien tant que ce mode n’est pas désactivé.
p au se Wa tchFol de r ()
« Méthode Application
pauseWatchFolder() », page 27
Interrompt temporairement le processus de
dossier de contrôle en cours.
endWatch Folder()
« Méthode Application endWatchFolder() », Met fin au processus de dossier de contrôle en
page 23
cours.
p u r g e ()
« Méthode Application purge() », page 28
b eg i nUndoGroup()
« Méthode Application beginUndoGroup() », Regroupe les actions qui la suivent en une
page 21
seule étape pouvant être annulée.
endUndoGroup()
« Méthode Application endUndoGroup() »,
page 22
Termine un groupe d’annulation ; nécessaire
seulement lorsqu’un script contient plusieurs
groupes d’annulation.
b eg i nSup pres sD i al o g s( )
« Méthode Application
beginSuppressDialogs() », page 21
Commence la suppression des boîtes de
dialogue dans l’interface utilisateur.
e n d Su p p re s s D i a l o g s( )
« Méthode Application
endSuppressDialogs() », page 22
Met fin à la suppression de boîtes de dialogue
dans l’interface utilisateur.
s e tMemor yUsa geLi mi ts ()
« Méthode Application
setMemoryUsageLimits() », page 29
Définit les limites d’utilisation de mémoire,
telles que spécifiées dans les préférences
Mémoire et cache.
s e tS ave Preferen ces O n Qu it ( )
« Méthode Application
setSavePreferencesOnQuit() », page 30
Indique si les préférences doivent être
enregistrées lors de la fermeture de l’application.
a c t iva te( )
« Méthode Application activate() », page 20 Affiche la fenêtre principale d’After Effects au
premier plan.
s ch e dul e Tas k( )
« Méthode Application scheduleTask() »,
page 29
Planifie un script JavaScript pour une exécution
ultérieure.
c a n ce l Tas k( )
« Méthode Application cancelTask() »,
page 22
Annule une tâche planifiée.
p a r s e Sw a tch F i l e ( )
« Méthode Application parseSwatchFile() »,
page 27
Charge un échantillon de couleur à partir d’un
fichier Adobe Swatch Exchange (ASE).
Purge un type ciblé d’informations mises en
mémoire cache (reproduit les options de la
commande Purger du menu Edition).
Méthode Application activate()
a pp. ac t iv ate ()
Description
Ouvre la fenêtre principale de l’application, si elle apparaît sous forme réduite ou d’icône, et l’affiche au
premier plan.
Paramètres
Aucun.
Renvoi
Aucun.
20
Référence JavaScript
Objet Application
21
Méthode Application beginSuppressDialogs()
a pp. b e g i n Su pp re s s D ia l o g s ()
Description
Lance la suppression des boîtes de dialogue d’erreur de script dans l’interface utilisateur. Pour reprendre
l’affichage des boîtes de dialogue d’erreur, utilisez e n d Su p p re s s D i a l o g s( ) . Voir la section « Méthode
Application endSuppressDialogs() », page 22.
Paramètres
Aucun.
Renvoi
Aucun.
Méthode Application beginUndoGroup()
a p p. b e g i n Un d o Grou p( u n d oSt r in g )
Description
Marque le début d’un groupe d’annulation qui permet à un script de regrouper de façon logique toutes ses
actions sous la forme d’une seule action pouvant être annulée (via les options de menu Edition > Annuler/
Rétablir). Pour marquer la fin du groupe, utilisez la méthode endUndoGro up() . (Voir la section « Méthode
Application endUndoGroup() », page 22.)
Les paires b e g in Un d o Grou p( ) et endUndoGro up() peuvent être imbriquées. Les groupes dans les groupes
deviennent partie intégrante du plus grand groupe et seront annulés correctement. Dans ce cas, les noms des
groupes internes sont ignorés.
Paramètres
u n d o S t r in g
Texte qui apparaîtra pour la commande Annuler dans le menu Edition (c’est-à-dire « Annuler <u ndoS t r in g> »).
Renvoi
Aucun.
Attribut Application buildName
a pp. bu il d Nam e
Description
Nom de la compilation d’After Effects en cours d’exécution. Adobe utilise ce nom en interne à des fins d’essais
et de dépannage.
Type
Chaîne ; lecture seule.
21
Référence JavaScript
Objet Application
22
Attribut Application buildNumber
a pp. bu il d Num b er
Description
Numéro de la compilation d’After Effects en cours d’exécution. Adobe utilise ce numéro en interne à des fins
d’essais et de dépannage.
Type
Entier ; lecture seule.
Méthode Application cancelTask()
a pp. c an cel Ta sk ( t a s k I D)
Description
Supprime la tâche spécifiée de la file d’attente des tâches planifiées pour une exécution ultérieure.
Paramètres
t as kI D
Entier qui identifie la tâche, telle qu’elle est renvoyée par la méthode a pp. sch ed ul eTa sk ( ) .
Renvoi
Aucun.
Méthode Application endSuppressDialogs()
a pp. e n dSu pp re ss D ia l o g s ( ale r t )
Description
Met fin à la suppression des boîtes de dialogue d’erreur de script dans l’interface utilisateur. Les boîtes de dialogue
d’erreur s’affichent par défaut. Appelez cette méthode uniquement si la méthode b e g i n Suppres s D ia l og s () a été
appelée préalablement. Voir la section « Méthode Application beginSuppressDialogs() », page 21.
Paramètres
a l er t
Booléen ; lorsque ce paramètre est défini sur true, les erreurs survenues après l’appel de la méthode
b e g i n Suppres s D ia l og s () s’affichent dans une boîte de dialogue.
Renvoi
Aucun.
Méthode Application endUndoGroup()
a pp. en dUn doGrou p( )
Description
Marque la fin d’un groupe d’annulation commencé par la méthode app.b eg i nUndoGroup() . Vous pouvez
utiliser cette méthode pour placer une fin de groupe d’annulation au milieu d’un script si vous souhaitez
utiliser plusieurs groupes d’annulation pour un seul script.
Si vous n’utilisez qu’un seul groupe d’annulation pour un script donné, vous n’avez pas besoin d’utiliser cette
méthode. En son absence à la fin d’un script, le système fermera le groupe d’annulation automatiquement.
22
Référence JavaScript
Objet Application
23
Le fait d’appeler cette méthode sans avoir défini de méthode b eg i nUndoGroup() génère une erreur.
Paramètres
Aucun.
Renvoi
Aucun.
Méthode Application endWatchFolder()
a pp. en dWa tchFol der( )
Description
Met fin au mode Dossier de contrôle.
Paramètres
Aucun.
Renvoi
Aucun.
Voir aussi
« Méthode Application watchFolder() », page 30
« Méthode Application parseSwatchFile() », page 27
« Attribut Application isWatchFolder », page 24
Attribut Application exitAfterLaunchAndEval
a pp. exitAfter L aun chAnd Ev al
Description
Cet attribut n’est utilisé que lors de l’exécution d’un script à partir d’une ligne de commande sous Windows.
Lorsque l’application est lancée à partir de la ligne de commande, si l’indicateur de ligne de commande - r ou
- s est utilisé, l’application exécute un script (à partir d’un fichier ou d’une chaîne, respectivement).
Si cet attribut est défini sur true, After Effects quitte après l’exécution du script ; s’il est défini sur false, l’application
reste ouverte.
Cet attribut n’a d’effet que si After Effects est exécuté à partir d’une ligne de commande Windows. Il n’a aucun
effet sous Mac OS.
Type
Booléen ; lecture/écriture.
23
Référence JavaScript
Objet Application
24
Attribut Application exitCode
a pp. ex i tCo de
Description
Code numérique d’état utilisé lors de l’exécution d’un script en externe (c’est-à-dire à partir d’une ligne de
commande ou d’AppleScript).
• Sous Windows, lorsque After Effects est lancé à partir de la ligne de commande (à l’aide de la commande
a f ter fx ou a f ter f x – m ) et qu’un script est spécifié à l’aide de l’option – r ou – s , la valeur est renvoyée sur la
ligne de commande.
• Sous Mac OS, la valeur est renvoyée en tant que résultat de la commande AppleScript D oS c r ip t pour
chaque script.
Sous Mac OS comme sous Windows, la valeur est définie sur 0 (E X I T _ S U C C E S S ) au début de chaque
évaluation de script. En cas d’erreur lors de l’exécution du script, celui-ci peut définir cette valeur sur un
nombre entier positif indiquant l’erreur qui s’est produite.
Type
Entier ; lecture/écriture.
Exemple
a pp. ex i tCo de = 2 ; / / on qui t, i f v a lue is 2, a n er ror ha s o ccu r re d
Attribut Application isRenderEngine
a p p. is Ren d er E n g in e
Description
Cet attribut a la valeur true si l’application After Effects est exécutée en tant que moteur de rendu.
Type
Booléen ; lecture seule.
Attribut Application isWatchFolder
a pp. is WatchFol der
Description
Cet attribut a la valeur true si la boîte de dialogue Dossier de contrôle est affichée actuellement et si l’application
est en train de contrôler un dossier pour le rendu.
Type
Booléen ; lecture seule.
Attribut Application language
a pp. l an g u ag e
Description
Langue dans laquelle After Effects est exécuté.
24
Référence JavaScript
Objet Application
25
Type
Valeur énumérée L a n g u ag e ; lecture seule. L’une des suivantes :
L a n g u a ge . E N G L I S H
L a n g u a ge . F R E N C H
L a n g u a ge . G E R M AN
L a n g u a ge . I TAL I A N
L a n g u a ge . JA PA N E S E
L a n g u a ge . S PAN I S H
Exemple
v ar l a n g = a pp. l a n g u ag e ;
if (lang == Language.ENGLISH)
a l er t( " Af te r E ff e c ts i s r u n n i n g i n E n g l i sh . " ) ;
e l s e if ( l a n g = = L a n g u a g e . F R E N C H )
a l er t ( " Af te r E ff e c ts i s r u n n i n g i n Fren ch. " ) ;
e l se
a l er t ( " Af te r E ff e c ts i s n o t r u n n in g in E n g l is h o r Fre n ch . " ) ;
Attribut Application memoryInUse
a p p. m e m o r yIn Use
Description
Nombre d’octets de mémoire actuellement utilisés par cette application.
Type
Nombre ; lecture seule.
Méthode Application newProject()
a pp. n ew Proje c t( )
Description
Crée un nouveau projet dans After Effects, en reproduisant la commande de menu Fichier > Créer > Nouveau
projet.
Si le projet en cours a été modifié, l’utilisateur est invité à l’enregistrer. Si l’utilisateur ferme la boîte de dialogue
Enregistrer sans enregistrer, le nouveau projet n’est pas créé et la méthode renvoie une valeur nulle. Utilisez
a pp. pro je c t .cl o se( C l os eO p t i on s. D O _ N OT _ S AV E _ C H AN G E S ) pour fermer le projet en cours avant d’en
ouvrir un nouveau. Voir la section « Méthode Project close() », page 112.
Paramètres
Aucun.
Renvoi
Un nouvel objet Project ou une valeur nulle si aucun nouveau projet n’est créé.
Exemple
a pp. pro je c t .cl o se( C l os eO p t i on s. D O _ N OT _ S AV E _ C H AN G E S );
a pp. n ew Proje c t( );
25
Référence JavaScript
Objet Application
26
Attribut Application onError
a pp. on E r ror
Description
Nom d’une fonction de rappel qui est appelée lorsqu’une erreur se produit. En créant une fonction et en
l’attribuant à cet attribut, il est possible de réagir aux erreurs systématiquement. Vous pouvez, par exemple,
fermer et redémarrer l’application, et noter l’erreur dans un fichier journal si elle est survenue en cours de
rendu. Voir la section « Méthode RenderQueue render() », page 154.
La chaîne d’erreur et une chaîne de gravité sont transmises à la fonction de rappel. Aucune valeur ne doit être
renvoyée.
Type
Chaîne de nom de fonction ou valeur nulle si aucune fonction n’est attribuée ; lecture/écriture.
Exemple
f u n c t io n e r r ( e r r St r i n g ) {
a l er t( er rS t r in g );
}
a pp. on E r ror = er r ;
Méthode Application open()
a pp. op en ()
a pp. op en (f i l e)
Description
Ouvre un projet.
Paramètres
file
Facultatif. Objet ExtendScript File pour le fichier de projet à ouvrir. S’il n’est pas fourni, la méthode invite
l’utilisateur à sélectionner un fichier de projet.
Renvoi
Un nouvel objet Project pour le projet spécifié ou une valeur nulle si l’utilisateur ferme la boîte de dialogue
Ouvrir sans effectuer de sélection.
Exemple
v ar my _file = new File (". ./my_folder/my_test .a ep");
i f (my _ fi l e . ex i st s) {
n e w _ p ro j e c t = a p p.o p e n ( my _ f i l e ) ;
i f (n e w _ proj e c t) {
a l er t( new _ proje c t.f i le.n ame) ;
}
}
26
Référence JavaScript
Objet Application
27
Méthode Application parseSwatchFile()
a pp. pa rse Sw atchF i l e( file )
Description
Charge des données d’échantillon de couleur à partir d’un fichier Adobe Swatch Exchange (ASE).
Paramètres
file
Spécification du fichier, qui est un objet ExtendScript F i l e .
Renvoi
Les données de l’échantillon, au format suivant :
d at a. m ajo r Ver si o n
Numéro de version ASE.
d at a. m in or Vers ion
d at a. v al u e s
Tableau de valeurs Swa tchVa lue .
Swa tchVa lue .t y p e
L’un des types suivants : RGB, C MY K , L AB, Gr ay
Swa tchVa lue .r
Lorsque t y p e = " RG B " , les valeurs de couleur comprises dans la plage [0.0..1.0].
Swa tchVa lue .g
0, 0, 0 correspond à la valeur Black.
Swa tchVa lue .b
Swa tchVa lue .c
Lorsque t y p e = " C M YK " , les valeurs de couleur comprises dans la plage [0.0..1.0].
Swa tchVa lue .m
0, 0, 0, 0 correspond à la valeur White.
Swa tchVa lue .y
Swa tchVa lue .k
Swa tchVa lue .L
Lorsque t y p e = " L AB " , les valeurs de couleur.
Swa tchVa lue .a
L est compris dans la plage [0.0..1.0]. a et b sont compris dans la plage [-128.0..+128.0]
Swa tchVa lue .b
Swa tchVa lue .va lue
0, 0, 0 correspond à la valeur Black.
Lorsque t y p e = " Gr ay" , va lue est compris dans la plage [0.0..1.0].
0.0 correspond à la valeur Black.
Méthode Application pauseWatchFolder()
a pp. pa useWatchFo lder( p au s e)
Description
Interrompt temporairement ou reprend la recherche d’éléments de rendu dans le dossier de contrôle cible.
Paramètres
p au se
True permet d’interrompre et false de reprendre.
Renvoi
Aucun.
27
Référence JavaScript
Objet Application
28
Voir aussi
« Attribut Application isWatchFolder », page 24
« Méthode Application watchFolder() », page 30
« Méthode Application endWatchFolder() », page 23
Attribut Application project
a pp. pro je c t
Description
Projet en cours. Voir la section « Objet Project », page 110.
Type
Objet Project ; lecture seule.
Méthode Application purge()
a pp. pu rg e( tar ge t )
Description
Purge de la mémoire les données inutilisées des types spécifiés. Reproduit les options de la commande Purger
du menu Edition.
Paramètres
t arg e t
Type d’élément à purger de la mémoire ; valeur énumérée Pu rg eTa rg et , l’une des suivantes :
• Pur g e Ta r ge t . A L L _ C AC HE S : purge toutes les données qu’After Effects a mises en mémoire
cache dans la mémoire physique.
• Purg e Tar ge t .UN D O _ C AC H E S : purge toutes les données enregistrées dans le cache d’annulation.
• Pur g e Tar ge t . S NA P S HOT _ C AC H E S : purge toutes les données mises en cache en tant
qu’instantanés de composition/calque.
• Pur g e Ta r ge t . I M AG E _ C AC H E S : purge toutes les données d’image enregistrées.
Renvoi
Aucun.
Méthode Application quit()
a pp. qui t( )
Description
Ferme l’application After Effects.
Paramètres
Aucun.
Renvoi
Aucun.
28
Référence JavaScript
Objet Application
29
Attribut Application saveProjectOnCrash
a pp. saveProj ec tO nCr a sh
Description
Lorsque cet attribut est défini sur true (valeur par défaut), After Effects tente d’afficher une boîte de dialogue
qui vous permet d’enregistrer le projet en cours lorsqu’une erreur provoquant la fermeture inopinée de
l’application se produit. Lorsqu’il est défini sur false, cette boîte de dialogue disparaît et l’application se ferme
sans que le projet ne soit enregistré.
Type
Booléen ; lecture/écriture.
Méthode Application scheduleTask()
a pp. sch ed ul eTa sk ( st r in g To Ex e cut e, de lay, re p e at )
Description
Planifie le JavaScript spécifié pour une exécution ultérieure.
Paramètres
s t r i n g ToE xe c ute
Chaîne contenant le JavaScript à exécuter.
de l ay
Durée d’attente (en millisecondes) avant l’exécution du JavaScript. Valeur à virgule flottante.
rep e at
Lorsque ce paramètre est défini sur true, répète l’exécution du script, en respectant le délai spécifié entre
chaque exécution. Lorsqu’il est défini sur false, le script n’est exécuté qu’une seule fois.
Renvoi
Nombre entier, identificateur unique de cette tâche, pouvant permettre d’annuler la tâche via la méthode
a pp. c an cel Ta sk ( ) .
Méthode Application setMemoryUsageLimits()
a pp. se t Mem o r y Us ag eL im i t s( im a geC a c he Pe rc e n t a ge, m ax imu m Me m o r y Pe rce n t age )
Description
Définit les limites d’utilisation de mémoire, telles que spécifiées dans les préférences Mémoire et cache.
Pour les deux valeurs, si la mémoire vive installée est inférieure à une quantité donnée (n giga-octets), la
valeur correspond à un pourcentage de la mémoire vive installée ; sinon, elle correspond à un pourcentage de n.
La valeur de n est : 2 Go pour Windows 32 bits, 4 Go pour Windows 64 bits, 3,5 Go pour Mac OS.
Paramètres
i m a ge Ca chePercen ta g e
Valeur à virgule flottante ; pourcentage de mémoire assigné au cache image.
m a x im u m Me m o r y Pe rcen t a ge
Valeur à virgule flottante ; pourcentage d’utilisation maximale de mémoire.
Renvoi
Aucun.
29
Référence JavaScript
Objet Application
30
Méthode Application setSavePreferencesOnQuit()
a pp. se t S avePref eren ces On Q ui t (d oS av e)
Description
Définit ou supprime l’indicateur qui détermine si les préférences doivent être enregistrées à la fermeture de
l’application.
Paramètres
doS ave
Lorsque ce paramètre est défini sur true, les préférences sont enregistrées à la
fermeture de l’application. Lorsqu’il est défini sur false, elles ne sont pas enregistrées.
Renvoi
Aucun.
Attribut Application settings
a pp. se t ti n g s
Description
Paramètres en cours. Voir la section « Objet Settings », page 164.
Type
Objet Settings ; lecture seule.
Attribut Application version
a pp. versi on
Description
Chaîne alphanumérique indiquant la version d’After Effects en cours d’exécution.
Type
Chaîne ; lecture seule.
Exemple
v ar ver = a p p. vers i o n ;
a l er t( " T h i s m a chi n e is r un n in g versi o n " + ver + " o f Af ter E f fe c t s . " ) ;
Méthode Application watchFolder()
a pp. wa tchFol der( f o l d e r_ o b j e c t _t o _ w a t c h)
Description
Démarre un processus de dossier de contrôle (rendu en réseau) pointant vers un dossier spécifié.
Paramètres
fo l de r _ o b j e c t _ to _ wa tch
Objet ExtendScript Folder que le dossier doit contrôler.
30
Référence JavaScript
Objet Application
31
Renvoi
Aucun.
Exemple
v ar t heFolder = new Folder(“c: /too l”);
a pp. wa tchFolder(theFolder);
Voir aussi
« Méthode Application endWatchFolder() », page 23
« Méthode Application parseSwatchFile() », page 27
« Attribut Application isWatchFolder », page 24
31
Référence JavaScript
Objet AVItem
32
Objet AVItem
a pp. pro je c t .i tem ( i n d e x)
Description
L’objet AVItem fournit l’accès aux attributs et aux méthodes des fichiers audiovisuels importés dans After Effects.
• AVItem est une sous-classe d’Item. Toutes les méthodes et tous les attributs d’Item, outre ceux énumérés
ci-dessous, sont disponibles lorsque vous utilisez AVItem. Voir la section « Objet Item », page 76.
• AVItem est la classe de base de CompItem et de FootageItem, de sorte que les attributs et les méthodes
AVItem sont également disponibles lors de l’utilisation des objets CompItem et FootageItem. Voir les
sections « Objet CompItem », page 52 et « Objet FootageItem », page 64.
Attributs
Attribut
Référence
Description
name
« Attribut AVItem name », page 35
Nom de l’objet, tel qu’affiché dans le panneau Projet.
w i dt h
« Attribut AVItem width », page 38
Largeur de l’élément.
h eig h t
« Attribut AVItem height », page 34
Hauteur de l’élément.
p i xel As p e c t
« Attribut AVItem pixelAspect », page 35
Format des pixels de l’élément.
f r a m eRa te
« Attribut AVItem frameRate », page 34
Cadence d’image de l’élément.
f r a m eD ur a t i on
« Attribut AVItem frameDuration », page 33
Durée d’image de l’élément.
du r at i on
« Attribut AVItem duration », page 33
Durée totale de l’élément.
u s e Prox y
« Attribut AVItem useProxy », page 38
Lorsque cet attribut est défini sur true, une source de
doublure est utilisée pour cet élément.
prox y S ou rce
« Attribut AVItem proxySource », page 35
Objet FootageItem utilisé en tant que doublure pour
l’élément.
time
« Attribut AVItem time », page 38
Instant actuel de l’élément.
u s e dIn
« Attribut AVItem usedIn », page 38
Objets CompItem qui utilisent cet élément.
h as Vi de o
« Attribut AVItem hasVideo », page 34
Lorsque cet attribut est défini sur true, l’élément possède
un composant vidéo.
h as Au di o
« Attribut AVItem hasAudio », page 34
Lorsque cet attribut est défini sur true, l’élément possède
un composant audio.
fo o t ag e M is s in g
« Attribut AVItem footageMissing », page 33
Lorsque cet attribut est défini sur true, l’élément est
introuvable ou il s’agit d’un pseudo-élément.
Méthodes
Méthode
Référence
Description
s e tProxy ( )
« Méthode AVItem setProxy() », page 36
Définit une doublure pour l’élément.
s e tProxyWi thS e quence( )
« Méthode AVItem setProxyWithSequence() »,
page 37
Définit une séquence comme doublure
pour l’élément.
s e tProxyWi thS o lid ( )
« Méthode AVItem setProxyWithSolid() »,
page 37
Définit un solide comme doublure pour
l’élément.
s e tProxyWi thP l a ceh older( )
« Méthode AVItem setProxyWithPlaceholder() », Définit un pseudo-élément comme
page 36
doublure pour l’élément.
s e tProxy ToNon e ( )
« Méthode AVItem setProxyToNone() », page 36
Supprime la doublure pour l’élément.
32
Référence JavaScript
Objet AVItem
33
Attribut AVItem duration
a pp. pro je c t .i tem ( in d e x) .d u r a ti o n
Description
Renvoie la durée, en secondes, de l’élément. Les éléments de métrage fixe ont une durée de 0.
• Dans un objet CompItem, la valeur est liée à la du rée de la composition. Elle est accessible en lecture/écriture.
• Dans un objet FootageItem, la valeur est liée à la d u r é e de l’objet m a i n S o u rce . Elle est accessible en lecture seule.
Type
Valeur à virgule flottante comprise dans la plage [0.0..10800.0] ; lecture/écriture pour un objet CompItem ;
lecture seule dans les autres cas.
Attribut AVItem footageMissing
a pp. pro je c t .i tem ( in d e x) .fo o t ag e M is s i n g
Description
Lorsque cet attribut est défini sur true, l’AVItem est un pseudo-élément ou représente un métrage avec
un fichier source introuvable. Dans ce cas, le chemin du fichier source manquant se trouve dans l’attribut
m i s s i n g Fo ot a g e Pat h de l’objet du fichier source de l’élément de métrage. Voir les sections « Attribut
FootageItem mainSource », page 65 et « Attribut FileSource missingFootagePath », page 60.
Type
Booléen ; lecture seule.
Attribut AVItem frameDuration
a pp. pro je c t .i tem ( in d e x) .f r a m e D u r at i on
Description
Renvoie la longueur, en secondes, d’une image pour cet AVItem. Réciproque de fr ameR ate . Lorsque cet
attribut est défini, la réciproque est automatiquement définie comme une nouvelle valeur de f r a m eRa te .
Cet attribut renvoie la réciproque de f r a m eRa te , qui est susceptible d’être différente d’une valeur que vous
avez définie, si cette valeur n’est pas divisible régulièrement par 1,0 (par exemple, 0,3). En raison de limitations
numériques, (1 / ( 1 / 0,3)) est proche de 0,3 mais n’est pas égal à 0,3.
Si l’AVItem est un FootageItem, cette valeur est liée à l’objet m a i n S o u rce , et est en lecture seule. Pour la
modifier, définissez l’attribut con f or m Fr a m e R ate de l’objet m ai n S ource . Cela permet de définir les valeurs
f r a m eRa te et f r am e D u r a t ion du FootageItem.
Type
Valeur à virgule flottante comprise dans la plage [1/99.. 1.0] ; lecture seule pour un FootageItem, lecture/écriture
dans les autres cas.
33
Référence JavaScript
Objet AVItem
34
Attribut AVItem frameRate
a pp. pro je c t .i tem ( in d e x) .f r a m eRa te
Description
Cadence d’image de l’AVItem, en nombre d’images par seconde. Réciproque de l’attribut f r a m e D u r at i o n .
Lorsque cet attribut est défini, sa réciproque est automatiquement définie comme une nouvelle valeur
f r a m eD ur a t i on .
• Dans un CompItem, la valeur est liée à l’attribut f r a m eRa te de la composition et est en lecture/écriture.
• Dans un FootageItem, la valeur est liée à l’attribut fr ame Rate de l’objet m a i n S o u rce et est en lecture seule.
Pour la modifier, définissez l’attribut con fo r m Fr a m e R ate de l’objet m a i n S o u rce . Cela permet de définir les
valeurs f r a m eRa te et f r am e D u r a t ion du FootageItem.
Type
Valeur à virgule flottante comprise dans la plage [1.0..99.0] ; lecture seule pour un FootageItem, lecture/écriture
dans les autres cas.
Attribut AVItem hasAudio
a pp. pro je c t .i tem ( in d e x) .h as Au di o
Description
Lorsque cet attribut a la valeur true, l’AVItem possède un composant audio.
• Dans un CompItem, la valeur est liée à la composition.
• Dans un FootageItem, la valeur est liée à l’objet m a in S o u rce .
Type
Booléen ; lecture seule.
Attribut AVItem hasVideo
a pp. pro je c t .i tem ( in d e x) .h as Vi de o
Description
Lorsque cet attribut a la valeur true, l’AVItem possède un composant audio.
• Dans un CompItem, la valeur est liée à la composition.
• Dans un FootageItem, la valeur est liée à l’objet m a in S o u rce .
Type
Booléen ; lecture seule.
Attribut AVItem height
a pp. pro je c t .i tem ( in d e x) .h ei g h t
Description
Hauteur de l’élément, en pixels.
• Dans un CompItem, la valeur est liée à la composition. Elle est en lecture/écriture.
• Dans un FootageItem, la valeur est liée à l’objet m a in S o u rce . Elle est en lecture/écriture uniquement si
l’objet m a in S ou rce est un SolidSource. Dans les autres cas, elle est en lecture seule.
Type
Nombre entier compris dans la plage de valeurs [1...30000] ; lecture/écriture, sauf dans les cas indiqués.
34
Référence JavaScript
Objet AVItem
35
Attribut AVItem name
a pp. pro je c t .i tem ( in d e x) .n a m e
Description
Nom de l’élément, tel qu’affiché dans le panneau Projet.
• Dans un FootageItem, la valeur est liée à l’objet m a i n S o u rce . Si l’objet m ai n S ource est un FileSource, cette
valeur contrôle le nom d’affichage qui apparaît dans le panneau Projet, mais n’affecte pas le nom de fichier.
Type
Chaîne ; lecture/écriture.
Attribut AVItem pixelAspect
a pp. pro je c t .i tem ( in d e x) .p i xel As p e c t
Description
Format des pixels de l’élément.
• Dans un CompItem, la valeur est liée à la composition.
• Dans un FootageItem, la valeur est liée à l’objet m a in S o u rce .
Certaines valeurs p i xe lAs p e c t sont connues d’After Effects et sont stockées/extraites avec précision. Ces
valeurs sont celles de la série {1 , 0. 9, 1 .2, 1 .07 , 1. 42, 2 , 0. 95, 1.9} . Les autres valeurs peuvent présenter de
légères erreurs d’arrondi lorsque vous les définissez ou que vous les extrayez. Par conséquent, la valeur que
vous extrayez après la définition peut être légèrement différente de celle que vous avez fournie.
Type
Valeur à virgule flottante comprise dans la plage [0.01..100.0] ; lecture/écriture.
Attribut AVItem proxySource
a pp. pro je c t .i tem ( in d e x) .p roxy S o u rce
Description
FootageSource utilisé comme doublure. L’attribut est en lecture seule. Pour le modifier, appelez l’une des méthodes
AVItem qui modifient la source de la doublure : se tProx y () , se tProx y Wi th S equ ence( ) , s e tProx yWi th S oli d( ) ou
s e t Proxy Wi thP l a ce h o l der ( ) .
Type
Objet FootageSource ; lecture seule.
35
Référence JavaScript
Objet AVItem
36
Méthode AVItem setProxy()
a pp. pro je c t .i tem ( in d e x) . s e tProxy ( file )
Description
Définit un fichier comme doublure de cet AVItem. Charge le fichier spécifié dans un nouvel objet FileSource,
définit celui-ci comme la valeur de l’attribut prox y S ou rce et définit u s e Prox y sur true. Cette méthode ne
conserve pas les paramètres d’interprétation mais utilise les préférences utilisateur. Si le fichier comporte une
couche alpha non identifiée et si la préférence utilisateur spécifie d’afficher un message demandant à l’utilisateur
ce qu’il souhaite faire, la méthode évalue l’interprétation alpha au lieu de la demander à l’utilisateur.
Cette action est différente de ce qui se produit lorsque vous définissez la source principale d’un FootageItem,
mais ces deux actions s’effectuent comme dans l’interface utilisateur.
Paramètres
file
Objet ExtendScript File pour le fichier à utiliser en tant que doublure.
Renvoi
Aucun.
Méthode AVItem setProxyToNone()
a pp. pro je c t .i tem ( in d e x) . s e tProxy To No n e ()
Description
Supprime la doublure de cet AVItem, définit prox y S ource sur une valeur nulle et u s e Prox y sur fa l se .
Paramètres
Aucun.
Renvoi
Aucun.
Méthode AVItem setProxyWithPlaceholder()
a pp. pro je c t .i tem ( in d e x) .s e tProxy Wi th Pl a ceh ol der( n am e , w id t h , he ig h t , f ram e R at e, durat ion )
Description
Crée un objet PlaceholderSource avec les valeurs spécifiées, définit celui-ci en tant que valeur de l’attribut
prox y S ou rce et définit u s e Prox y sur true. Cette méthode ne conserve pas les paramètres d’interprétation mais
utilise les préférences utilisateur.
REMARQUE : il n’existe pas de moyen direct de définir un pseudo-élément en tant que doublure dans l’interface
utilisateur ; ce comportement se produit lorsqu’une doublure a été définie, puis déplacée ou supprimée.
Paramètres
name
Chaîne contenant le nom du nouvel objet.
w i dt h, heig ht
Dimensions du pseudo-élément, en pixels. Nombre entier compris dans la plage [4..30000].
f r a m eRa te
Nombre d’images par seconde. Nombre entier compris dans la plage [1..99].
du r at i on
Durée totale, en secondes (3 heures max.). Nombre entier compris dans la plage [0.0..10800.0].
Renvoi
Aucun.
36
Référence JavaScript
Objet AVItem
37
Méthode AVItem setProxyWithSequence()
a pp. pro je c t .i tem ( in d e x) .se tProxyWith S equence( file, forc eAlphabe t ical )
Description
Définit une séquence de fichiers en tant que doublure de cet AVItem, avec l’option permettant de forcer l’ordre
alphabétique. Charge la séquence de fichiers spécifiée dans un nouvel objet FileSource, définit celui-ci comme
la valeur de l’attribut prox y S ource et définit u se Prox y sur true. Cette méthode ne conserve pas les paramètres
d’interprétation mais utilise les préférences utilisateur. Si un fichier comporte une couche alpha non identifiée
et si la préférence utilisateur spécifie d’afficher un message demandant à l’utilisateur ce qu’il souhaite faire, la
méthode évalue l’interprétation alpha au lieu de la demander à l’utilisateur.
Paramètres
file
Objet ExtendScript File pour le premier fichier de la séquence.
force Alp ha b e t ic a l
Lorsque ce paramètre est true, l’option Ordre alphabétique doit être utilisée.
Renvoi
Aucun.
Méthode AVItem setProxyWithSolid()
a pp. pro je c t .i tem ( in d e x) .s e tProxyWith S olid ( c ol or, n am e , w id t h, he i g h t , p ix e lAsp ec t)
Description
Crée un objet SolidSource avec les valeurs spécifiées, définit celui-ci en tant que valeur de l’attribut
prox y S ou rce et définit u s e Prox y sur true. Cette méthode ne conserve pas les paramètres d’interprétation
mais utilise les préférences utilisateur.
REMARQUE : l’interface utilisateur n’offre aucun moyen de définir un solide comme doublure ; cette fonction
n’est disponible que par le biais de la création de script.
Paramètres
co lor
Couleur du solide, tableau de trois valeurs à virgule flottante, [R, V, B], comprises dans la plage [0.0..1.0].
name
Chaîne contenant le nom du nouvel objet.
w i dt h, heig ht
Dimensions du pseudo-élément, en pixels. Nombre entier compris dans la plage [1...30000].
p i xel As p e c t
Format des pixels du solide. Valeur à virgule flottante comprise dans la plage [0.01... 100.0].
Renvoi
Aucun.
37
Référence JavaScript
Objet AVItem
38
Attribut AVItem time
a pp. pro je c t .i tem ( in d e x) .t i m e
Description
Instant courant de l’élément lorsqu’il est prévisualisé directement à partir du panneau Projet. Cette valeur
correspond à un nombre de secondes. Utilisez la méthode globale t i m eTo Cur ren t Fo r m a t pour la convertir
en une valeur de type chaîne exprimant l’instant en termes d’images. Voir la section « Fonction globale
timeToCurrentFormat() », page 17.
Ne définissez pas cette valeur pour un FootageItem dont la valeur m a i n S o u rce est fixe (ite m .m a i n S o u rce . i s S t i l l
est true).
Type
Valeur à virgule flottante ; lecture/écriture.
Attribut AVItem usedIn
a pp. pro je c t .i tem ( in d e x) .u se dIn
Description
Toutes les compositions qui utilisent cet AVItem.
Veuillez noter que la valeur du tableau est copiée suite à une extraction. Par conséquent, elle n’est pas
automatiquement mise à jour. Si vous récupérez cette valeur, puis que vous l’ajoutez dans une autre
composition, vous devez de nouveau extraire la valeur pour obtenir un tableau incluant le nouvel élément.
Type
Tableau d’objets CompItem ; lecture seule.
Attribut AVItem useProxy
a pp. pro je c t .i tem ( in d e x) .u seProx y
Description
Lorsque cet attribut est true, une doublure est utilisée pour l’élément. Il est défini sur true par toutes les
méthodes S e t Prox y et sur false par la méthode S e tProxy ToNon e () .
Type
Booléen ; lecture/écriture.
Attribut AVItem width
a pp. pro je c t .i tem ( in d e x) .w i d th
Description
Largeur de l’élément, en pixels.
• Dans un CompItem, la valeur est liée à la composition. Elle est en lecture/écriture.
• Dans un FootageItem, la valeur est liée à l’objet m a in S o u rce . Elle est en lecture/écriture uniquement si
l’objet m a in S ou rce est un SolidSource. Dans les autres cas, elle est en lecture seule.
Type
Nombre entier compris dans la plage de valeurs [1...30000] ; lecture/écriture, sauf dans les cas indiqués.
38
Référence JavaScript
Objet AVLayer
39
Objet AVLayer
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x )
Description
L’objet AVLayer fournit une interface aux calques contenant des objets AVItem (calques de composition, de
métrage, de solide, de texte et de son).
• AVLayer est une sous-classe de Layer. Toutes les méthodes et tous les attributs de Layer, outre ceux énumérés
ci-dessous, sont disponibles lorsque vous utilisez AVLayer. Voir la section « Objet Layer », page 83.
• AVLayer est une classe de base de TextLayer. Ainsi, les attributs et les méthodes AVLayer sont disponibles
lorsque vous utilisez des objets TextLayer. Voir la section « Objet TextLayer », page 174.
Propriétés AE
Les différents types de calque ont des propriétés AE différentes. AVLayer possède les propriétés et groupes de
propriétés suivants :
Ma r ker
Tim e Remap
Mot i on Tr a ckers
Ma sk s
Effects
Tr an s for m
Anchor Point
Pos i t i on
S c al e
Orientation
X Rot at i on
Y Rot at i o n
Rot at i o n
O p a ci t y
L ayer S t y l e s
Ma ter i al O p t i on s
C as ts S h a dow s
L i g ht Tr a n s m i ss i on
Acce p ts S h a dows
Acce p ts L i g h ts
Ambi ent
D i ff us e
S p e c u l ar
Shininess
Met al
Aud i o
Aud i o Le ve l s
Exemple
Si le premier élément du projet est un CompItem et si le premier calque de ce CompItem est un AVLayer, le code
suivant définit la qualité (qua l i t y ) du calque, son instant de début (s ta r t Ti m e ) et son point d’entrée (i n Poin t ).
v ar f i r s t L aye r = a p p. p ro je c t .i te m ( 1 ) . l ayer (1 ) ;
first L ayer.qu alit y = L ayerQ ualit y.B EST;
f i r s t L aye r. s t a r t Ti m e = 1 ;
f i r s t L aye r. i n Po i n t = 2 ;
39
Référence JavaScript
Objet AVLayer
40
Attributs
Attribut
Référence
Description
s o u rce
« Attribut AVLayer source », page 47
Elément source pour ce calque.
i s Na m e Fro m S o u rce
« Attribut AVLayer isNameFromSource », Lorsque cet attribut est true, le calque ne
page 46
possède pas de nom explicitement défini, mais
contient une source nommée.
h eig h t
« Attribut AVLayer height », page 46
Hauteur du calque.
w i dt h
« Attribut AVLayer width », page 49
Largeur du calque.
a ud io E n ab l ed
« Attribut AVLayer audioEnabled »,
page 42
Lorsque cet attribut est true, l’audio du calque
est activé.
mo tionBlu r
« Attribut AVLayer motionBlur »,
page 46
Lorsque cet attribut est true, le flou
directionnel du calque est activé.
e f fe c t sAc t ive
« Attribut AVLayer effectsActive »,
page 44
Lorsque cet attribut est true, les effets du
calque sont actifs.
adju st mentLayer
« Attribut AVLayer adjustmentLayer »,
page 41
Lorsque cet attribut est true, il s’agit d’un
calque d’effets.
g u id e L ayer
« Attribut AVLayer guideLayer », page 45 Lorsque cet attribut est true, il s’agit d’un
calque repère.
t hree DL ayer
« Attribut AVLayer threeDLayer »,
page 48
Lorsque cet attribut est true, il s’agit d’un
calque 3D.
t hree DPer Cha r
« Attribut AVLayer threeDPerChar »,
page 48
Lorsque cet attribut a la valeur true, la
projection 3D est définie caractère par
caractère sur ce calque de texte.
can S et Col l ap se Tr ans for ma tion
« Attribut AVLayer
canSetCollapseTransformation »,
page 44
Lorsque cet attribut est true, il est permis de
modifier la valeur de
col l a ps e Tr a n sf or m a t i o n .
co l l ap s e Tr an s fo r m at i on
« Attribut AVLayer
collapseTransformation », page 44
Lorsque cet attribut est true, la condensation
des transformations est activée.
f r a m e Bl e n di n g
« Attribut AVLayer frameBlending »,
page 45
Lorsque cet attribut est true, l’interpolation est
activée.
f r a m e Bl e n di n g Ty p e
« Attribut AVLayer
frameBlendingType », page 45
Il s’agit du type d’interpolation appliqué au
calque.
c a n S e t Ti m e Rem a p E n a bl e d
« Attribut AVLayer
canSetTimeRemapEnabled », page 44
Lorsque cet attribut est true, il est permis de
modifier la valeur de t i m e Rem a p E n a b l e d .
t i m eRem ap E n ab l e d
« Attribut AVLayer
timeRemapEnabled », page 48
Lorsque cet attribut est true, le remappage
temporel est activé pour ce calque.
h as Au di o
« Attribut AVLayer hasAudio », page 45
Lorsque cet attribut est true, le calque contient
un composant audio.
a ud io Ac t ive
« Attribut AVLayer audioActive »,
page 41
Lorsque cet attribut est true, le composant
audio du calque est actif à l’instant courant.
b l endi ngMo de
« Attribut AVLayer blendingMode »,
page 42
Mode de fusion du calque.
preser veTr a n spa rency
« Attribut AVLayer
preserveTransparency », page 46
Lorsque cet attribut est true, l’option Préserver
la transparence est activée.
t r ackMat teTy p e
« Attribut AVLayer trackMatteType »,
page 49
Si le calque comporte un cache par approche,
cet attribut indique la manière dont il est
appliqué.
i s Tr a ck Ma tte
« Attribut AVLayer isTrackMatte »,
page 46
Lorsque cet attribut est true, le calque est
utilisé comme cache par approche pour le
calque sous-jacent.
40
Référence JavaScript
Objet AVLayer
41
Attribut
Référence
Description
h as Tr a ck Ma tte
« Attribut AVLayer hasTrackMatte »,
page 45
Lorsque cet attribut est true, le calque
immédiatement supérieur est utilisé comme
cache par approche sur ce calque.
qu a l i t y
« Attribut AVLayer quality », page 47
Paramètre de qualité du calque.
a utoO r i en t
« Attribut AVLayer autoOrient », page 42 Il s’agit du type d’orientation automatique
appliqué au calque.
Méthodes
Méthode
Référence
Description
a udio Ac t iveAtTime()
« Méthode AVLayer
audioActiveAtTime() », page 42
Signale si le composant audio de ce
calque est actif à un instant donné.
c al c u l ate Tr a n s for m From Poi n t s( )
« Méthode AVLayer
calculateTransformFromPoints() »,
page 43
Calcule une transformation à partir d’un
ensemble de points de ce calque.
rep l a c e S o u rce ( )
« Méthode AVLayer replaceSource() »,
page 47
Modifie l’élément source pour ce calque.
s o u rce Rec t AtTi m e ( )
« Méthode AVLayer
sourceRectAtTime() », page 47
Extrait le rectangle source d’un calque.
Attribut AVLayer adjustmentLayer
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ) . a d j u s t m e n t L ayer
Description
True, s’il s’agit d’un calque d’effets.
Type
Booléen ; lecture/écriture.
Attribut AVLayer audioActive
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). aud i oAc t ive
Description
True si le composant audio du calque est actif à l’instant courant.
Pour que la valeur soit true, aud i oEna ble d doit également être true, aucun autre calque comportant de l’audio
ne doit être isolé sauf si ce calque l’est aussi, et l’instant donné doit être compris entre le p o i n t d ’ e n t r é e et le
p o i n t d e s o r t i e de ce calque.
Type
Booléen ; lecture seule.
41
Référence JavaScript
Objet AVLayer
42
Méthode AVLayer audioActiveAtTime()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). aud i oAc t iveAt Ti m e (t im e )
Description
Renvoie true si le composant audio de ce calque est actif à l’instant spécifié.
Pour que cette méthode renvoie true, a ud i oE n a bl e d doit également être true, aucun autre calque comportant
de l’audio ne doit être isolé sauf si ce calque l’est aussi, et l’instant donné doit être compris entre le p o in t
d ’ e n t r é e et le p o i n t de s o r t i e de ce calque.
Paramètres
time
L’instant, en secondes. Valeur à virgule flottante.
Renvoi
Booléen.
Attribut AVLayer audioEnabled
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). aud i oEna bl e d
Description
Lorsque cet attribut est true, l’audio du calque est activé. Cette valeur correspond à la commande d’activation/
désactivation du composant audio dans le panneau Montage.
Type
Booléen ; lecture/écriture.
Attribut AVLayer autoOrient
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). autoO r i en t
Description
Il s’agit du type d’orientation automatique à appliquer au calque.
Type
Valeur énumérée Auto Or i en tTy p e ; lecture/écriture. L’une des suivantes :
AutoO r ien t Ty p e.A LO N G _ PAT H
AutoO r ien t Ty p e. C A M E R A _ O R _ P O I N T _ O F _ I N T E RE S T
AutoO r ien t Ty p e.N O _ AUTO _ O R I E N T
Attribut AVLayer blendingMode
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). bl end i ngMo de
Description
Mode de fusion du calque.
42
Référence JavaScript
Objet AVLayer
43
Type
Valeur énumérée Bl en d i n g Mo de ; lecture/écriture. L’une des suivantes :
Bl e n d in g Mod e .AD D
Bl e n d in g Mod e .AL PH A _ A DD
Bl e n d in g Mod e .C L A S S I C _ C O LOR _ BUR N
Bl e n d in g Mod e .C L A S S I C _ C O LOR _ D O D G E
Bl e n d in g Mod e .C L A S S I C _ D I F F E R E N C E
Bl e n d in g Mod e .C O LOR
Bl e n d in g Mod e .C O LOR _ BUR N
Bl e n d in g Mod e .C O LOR _ D O D G E
Bl e n d in g Mod e .DA N C I N G _ DI S S OLV E
Bl e n d in g Mod e .DA R K E N
Bl e n d in g Mod e .DA R K E R _ C OLO R
Bl e n d in g Mod e .D I F F E R E N C E
Bl e n d in g Mod e .D I S SO LVE
Bl e n d in g Mod e .E XC LUS I ON
Bl e n d in g Mod e .H A R D _ L I G HT
Bl e n d in g Mod e .H A R D _ M I X
Bl e n d in g Mod e .H UE
Bl e n d in g Mod e .L I G H T E N
Bl e n d in g Mod e .L I G H T E R _ C O LOR
Bl e n d in g Mod e .L I N E A R _ BU R N
Bl e n d in g Mod e .L I N E A R _ D O D G E
Bl e n d in g Mod e .L I N E A R _ L I G H T
Bl e n d in g Mod e .LU M I N E S C E N T _ PR E M U L
Bl e n d in g Mod e .LU M I N O S I T Y
Bl e n d in g Mod e .M ULT I PLY
Bl e n d in g Mod e .N O R M A L
Bl e n d in g Mod e .OV E R L AY
Bl e n d in g Mod e .PI N _ L I G H T
Bl e n d in g Mod e .S AT U RAT I O N
Bl e n d in g Mod e .S C R E E N
Bl e n d in g Mod e .S I L H OU E T E _ AL PH A
Bl e n d in g Mod e .S I L H OU E T T E _ LUM A
Bl e n d in g Mod e .S O F T _ L I G HT
Bl e n d in g Mod e .S T E N C I L _ A L PHA
Bl e n d in g Mod e .S T E N C I L _ LUM A
B l e n d in g Mod e . V I V I D _ L I G H T
Méthode AVLayer calculateTransformFromPoints()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). c al c ul ateTr an s for m From Poi n ts ( p o i n t To p L e f t , p o i n t To pRig h t ,
p o i n t B ot to m Ri g ht )
Description
Calcule une transformation à partir d’un ensemble de points de ce calque.
Paramètres
p o i n tTop Lef t
Coordonnées du point supérieur gauche sous forme de tableau, [x , y, z ] .
p o i n tTop R i g ht
Coordonnées du point supérieur droit sous forme de tableau, [x , y, z ] .
p o i n tB o ttom R i g h t
Coordonnées du point inférieur droit sous forme de tableau, [ x , y, z ] .
43
Référence JavaScript
Objet AVLayer
44
Renvoi
Un objet avec les propriétés de transformation définies.
Exemple
v ar n ew L ayer = com p.l ayers. ad d (n e wFoo ta ge );
n ew L ayer. th re eD L ayer = t r u e;
n e w L aye r. bl e n d i n g Mo de = B l en d i n g Mo d e . AL P H A _ A D D ;
v ar t r an s for m = n ew L ayer.c a l c ul ateTr a n s f o r m From Po i n t s ( t l , t r, bl ) ;
for(var sel in transform) {
n ew L ayer. t r a n sf or m [ se l ]. se tVa lue (t r an sfor m [s el ] ) ;
}
Attribut AVLayer canSetCollapseTransformation
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). c an S e tCo l l a ps eTr an sfor m at i on
Description
True s’il est permis de modifier la valeur de l’attribut col l a ps e Tr a n sf or m a t i o n sur ce calque.
Type
Booléen ; lecture seule.
Attribut AVLayer canSetTimeRemapEnabled
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). canSe tTi meRemapE nabled
Description
True s’il est permis de modifier la valeur de l’attribut t i m e Rem a p E n a bl e d sur ce calque.
Type
Booléen ; lecture seule.
Attribut AVLayer collapseTransformation
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). col l apse Tr a n sfor mation
Description
True si la condensation des transformations est activée pour ce calque.
Type
Booléen ; lecture/écriture.
Attribut AVLayer effectsActive
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). eff ec ts Ac t ive
Description
True si les effets du calque sont activés, comme l’indique l’icône <f> dans l’interface utilisateur.
Type
Booléen ; lecture/écriture.
44
Référence JavaScript
Objet AVLayer
45
Attribut AVLayer frameBlending
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). fr ame Bl end i n g
Description
True si l’interpolation est activée pour ce calque.
Type
Booléen ; lecture seule.
Attribut AVLayer frameBlendingType
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). fr ame Bl end i n gTy p e
Description
Type d’interpolation à effectuer lorsque l’interpolation est activée pour le calque.
Type
Valeur énumérée Fr a m eBl en d in g Ty p e ; lecture/écriture. L’une des suivantes :
Fr am e Bl en d i n g Ty p e. FRAM E _ MI X
Fr a m e Bl e n d i n g Ty p e . N O _ F R A M E _ B L E N D
Fr a m e Bl e n d i n g Ty p e . PI X E L _ M OT I O N
Attribut AVLayer guideLayer
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). guideL ayer
Description
True si le calque est un calque repère.
Type
Booléen ; lecture/écriture.
Attribut AVLayer hasAudio
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). has Aud i o
Description
True si le calque contient un composant audio, que ce composant audio soit activé ou isolé (option Solo).
Type
Booléen ; lecture seule.
Attribut AVLayer hasTrackMatte
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). has Tr a ckMat te
Description
True si le calque supérieur à ce calque est utilisé comme cache par approche sur ce calque. Lorsque cet attribut
est true, la valeur t r a ckMat teTy p e de ce calque définit la façon dont le cache est appliqué.
Type
Booléen ; lecture seule.
45
Référence JavaScript
Objet AVLayer
46
Attribut AVLayer height
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). heig ht
Description
Hauteur du calque, en pixels.
Type
Virgule flottante ; lecture seule.
Attribut AVLayer isNameFromSource
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). is Name FromS o urce
Description
True si le calque ne possède pas de nom explicitement défini, mais contient une source nommée. Dans ce cas,
laye r. n am e possède la même valeur que laye r. so urce. n am e .
False si le calque possède un nom explicitement défini ou si le calque ne possède pas de source.
Type
Booléen ; lecture seule.
Attribut AVLayer isTrackMatte
a pp. pro je c t .i tem ( in d e x) l ayer ( i n d e x) .i s Tr ackMa tte
Description
True si le calque est utilisé en tant que cache par approche pour le calque inférieur.
Type
Booléen ; lecture seule.
Attribut AVLayer motionBlur
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). mot i onBlur
Description
True si le flou directionnel est activé pour le calque.
Type
Booléen ; lecture/écriture.
Attribut AVLayer preserveTransparency
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). pre s er veTr an s p aren c y
Description
True si l’option Préserver la transparence est activée pour le calque.
Type
Booléen ; lecture/écriture.
46
Référence JavaScript
Objet AVLayer
47
Attribut AVLayer quality
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). qual i t y
Description
Niveau de qualité selon lequel le calque doit s’afficher.
Type
Valeur énumérée L ayer Q u a l it y ; lecture/écriture. L’une des suivantes :
LayerQu alit y.B EST
L ayer Q u al i t y. D RA F T
L ayer Q u al i t y. W I R E F RA M E
Méthode AVLayer replaceSource()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). rep l a ce S ource ( n e w S ource , f i xE x pre ss i on s )
Description
Remplace la source pour ce calque.
Paramètres
n e w S o u rce
Nouvel objet AVItem source.
f i xE x pres si o n s
Tr ue pour adapter les expressions à la nouvelle source, f al s e dans le cas contraire. Notez que
cette fonctionnalité peut solliciter de nombreuses ressources ; utilisez-la uniquement en fin
d’opération en cas de remplacement d’une grande quantité de métrage. Voir aussi « Méthode
Project autoFixExpressions() », page 111.
Renvoi
Aucun.
Attribut AVLayer source
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). so urce
Description
AVItem source pour ce calque. La valeur est nulle dans un calque de texte. Utilisez AVL ayer.rep la ceS ource()
pour modifier la valeur.
Type
Objet AVItem ; lecture seule.
Méthode AVLayer sourceRectAtTime()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). so urceRe c tAt Ti me (t im e T, e x te n t s )
Description
Extrait les limites du rectangle du calque à l’index d’instant spécifié, corrigées selon le contenu du calque de texte
ou de forme. Utilisez cette méthode pour écrire du texte correctement aligné sur la ligne de base, par exemple.
47
Référence JavaScript
Objet AVLayer
48
Paramètres
t i m eT
Index d’instant, en secondes. Valeur à virgule flottante.
extents
Tr ue pour inclure les extensions, f al s e dans le cas contraire. Les extensions s’appliquent aux
calques de forme et servent à augmenter la taille des limites du calque si nécessaire.
Renvoi
Un objet JavaScript avec quatre attributs, [ top, le ft , w i dt h, h ei g h t] .
Attribut AVLayer threeDLayer
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). th re eD Layer
Description
True s’il s’agit d’un calque 3D.
Type
Booléen ; lecture/écriture.
Attribut AVLayer threeDPerChar
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). th re eD PerChar
Description
True si l’option d’activation de la projection 3D caractère par caractère est définie pour ce calque, ce qui
permet d’animer ses caractères indépendamment du plan du calque de texte. S’applique uniquement aux
calques de texte.
Type
Booléen ; lecture/écriture.
Attribut AVLayer timeRemapEnabled
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). t im eRemap E na b le d
Description
True si le remappage temporel est activé pour ce calque.
Type
Booléen ; lecture/écriture.
48
Référence JavaScript
Objet AVLayer
49
Attribut AVLayer trackMatteType
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). t r a ck Ma tte Ty p e
Description
Si le calque comporte un cache par approche, spécifie la manière dont ce dernier sera appliqué.
Type
Valeur énumérée Tr a ck Ma tte Ty p e ; lecture/écriture. L’une des suivantes :
Tr a ck Mat teTy p e. AL PH A
Tr a ck Mat teTy p e. AL PH A_ I N VE RT E D
Tr a ck Mat teTy p e. LUM A
Tr a ck Ma t teTy p e . LU M A _ I N V E RT E D
Tr a ck Mat teTy p e. N O_ T RAC K _ MAT T E
Attribut AVLayer width
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x ). w i d th
Description
Largeur du calque, en pixels.
Type
Virgule flottante ; lecture seule.
49
Référence JavaScript
Objet CameraLayer
50
Objet CameraLayer
a pp. pro je c t .i tem ( in d e x) .l ayer(i n de x )
Description
L’objet CameraLayer représente un calque de caméra dans une composition. Vous pouvez le créer en utilisant
la méthode a dd C am er a de l’objet LayerCollection ; voir la section « Méthode LayerCollection addCamera() »,
page 93. Pour accéder à cet objet dans la collection de calques d’un élément, vous pouvez utiliser son numéro
d’index ou encore une chaîne de nom.
• CameraLayer est une sous-classe de Layer. Toutes les méthodes et tous les attributs de Layer sont disponibles
lorsque vous utilisez CameraLayer. Voir la section « Objet Layer », page 83.
Propriétés AE
CameraLayer ne définit aucun autre attribut, mais possède des propriétés AE différentes de celles des autres
types de calque. Il dispose des propriétés et des groupes de propriétés suivants :
Ma r ker
Tr an s for m
Poi n t of In teres t
Pos i t i on
S c al e
Orientation
X Rot at i on
Y Rot at i o n
Rot at i o n
O p a ci t y
C a m e r a O p t i on s
Zoom
D ep th of F i e ld
Foc u s D i st an ce
Blu r Le ve l
50
Référence JavaScript
Objet Collection
51
Objet Collection
De la même façon qu’un tableau, une collection regroupe un jeu d’objets ou de valeurs en tant que groupe
logique, et fournit un accès à ces objets ou valeurs via un index. La plupart des objets collection sont toutefois
en lecture seule. Vous ne leur attribuez pas les objets vous-même. Leur contenu est automatiquement mis à
jour au fil des créations ou suppressions d’objets.
La numérotation d’index d’une collection commence par 1, et non par 0.
Objets
Objet
Référence
Description
ItemCol l ec t i on
« Objet ItemCollection », page 79
Tous les éléments (fichiers importés, dossiers, solides, etc.) se
trouvant dans le panneau Projet.
L ayer Co l l e c t i on
« Objet LayerCollection », page 92
Tous les calques d’une composition.
O MCol l ec t i on
« Objet OMCollection », page 105
Tous les éléments de modules de sortie du projet.
RQ Item Col le c t ion
« Objet RenderQueueItem »,
page 156
Tous les éléments de file d’attente de rendu du projet.
Attributs
length
Nombre d’objets contenus dans la collection.
Méthodes
[]
Extrait un objet de la collection par le biais de son numéro d’index. Le premier objet se situe
à l’index 1.
51
Référence JavaScript
Objet CompItem
52
Objet CompItem
a pp. pro je c t .i tem ( i n d e x)
a pp. pro je c t .i tem s [ inde x ]
Description
L’objet CompItem représente une composition et vous permet de la manipuler et d’obtenir des informations
sur elle. Accédez aux objets d’un projet en utilisant leur numéro d’index dans la collection d’éléments Item .
• CompItem est une sous-classe d’AVItem, lui-même sous-classe d’Item. Toutes les méthodes et tous les
attributs d’AVItem et d’Item, outre ceux énumérés ci-dessous, sont disponibles lorsque vous utilisez
CompItem. Voir les sections « Objet AVItem », page 32 et « Objet Item », page 76.
Exemple
Etant donné que le premier élément du projet est un CompItem, le code suivant affiche deux alertes.
La première affiche le nombre de calques contenus dans le CompItem, et la deuxième le nom du dernier
calque du CompItem.
v ar f i r s t Co m p = a p p. p ro je c t .i te m ( 1 ) ;
a l er t ( " nu m b e r o f l ayer s i s " + f i r s t Co m p.num L aye r s ) ;
a l er t( " n a m e of l a st l ayer i s " + f i rs t Co m p.l ayer ( f i r s t Com p.n u m L aye rs ) . n a m e ) ;
Attributs
Attribut
Référence
Description
f r a m eD ur a t i on
« Attribut CompItem frameDuration »,
page 55
Durée d’une seule image.
wor k Area St ar t
« Attribut CompItem workAreaStart »,
page 59
Heure de début de la zone de travail.
wor k Area D ur a ti on
« Attribut CompItem
workAreaDuration », page 59
Durée de la zone de travail.
nu m L ayers
« Attribut CompItem numLayers »,
page 56
Nombre de calques contenus dans la composition.
h id eS hy L ayers
« Attribut CompItem hideShyLayers »,
page 55
Lorsque cet attribut est true, les calques discrets
s’affichent dans le panneau Montage.
mo tionBlu r
« Attribut CompItem motionBlur »,
page 56
Lorsque cet attribut est true, le flou directionnel est
activé pour cette composition.
d r a ft 3 d
« Attribut CompItem draft3d », page 54
Lorsque cet attribut est true, le mode Ebauche 3D est
activé pour le panneau Composition.
f r a m e Bl e n di n g
« Attribut CompItem frameBlending »,
page 54
Lorsque cet attribut est true, le filtrage temporel est
activé pour cette composition.
preser veNeste d Fr a m eRa te
« Attribut CompItem
preserveNestedFrameRate », page 56
Lorsque cet attribut est true, la cadence d’image des
compositions imbriquées est préservée.
preser veNeste d Resolut i on « Attribut CompItem
preserveNestedResolution », page 57
Lorsque cet attribut est true, la résolution des
compositions imbriquées est préservée.
b g Co lor
« Attribut CompItem bgColor », page 53 Couleur de fond de la composition.
a c t iveC am er a
« Attribut CompItem activeCamera »,
page 53
Calque de caméra actif.
52
Référence JavaScript
Objet CompItem
53
Attribut
Référence
Description
d i sp l ay S ta r t Ti m e
« Attribut CompItem displayStartTime », Modifie l’affichage de l’heure de début dans le
page 54
panneau Montage.
res o lut i o n Fa c to r
« Attribut CompItem resolutionFactor », Facteur par lequel la résolution x et y du panneau
page 57
Composition est sous-échantillonnée.
s hu t ter A n g l e
« Attribut CompItem shutterAngle »,
page 58
Angle obturateur de la caméra.
s hu t ter P h a se
« Attribut CompItem shutterPhase »,
page 58
Phase d’obturateur de la caméra.
l ayer s
« Attribut CompItem layers », page 56
« Objet LayerCollection », page 92
Calques de la composition.
s e l e c te d L ayer s
« Attribut CompItem selectedLayers »,
page 58
Calques sélectionnés de la composition.
s e l e c t e d Pro p e r t i e s
« Attribut CompItem
selectedProperties », page 58
Propriétés sélectionnées de la composition.
renderer
« Attribut CompItem renderer »,
page 57
Module externe de rendu à utiliser pour le rendu de
cette composition.
renderers
« Attribut CompItem renderers »,
page 57
Ensemble des modules externes de rendu disponibles.
Méthodes
Méthode
Référence
Description
du pl i c ate( )
« Méthode CompItem duplicate() », page 54
Crée et renvoie un doublon de cette composition.
l ayer ()
« Méthode CompItem layer() », page 55
Obtient un calque à partir de cette composition.
Attribut CompItem activeCamera
a pp. pro je c t .i tem ( in d e x) .a c t iveC am er a
Description
Il s’agit de la caméra active, c’est-à-dire du calque de caméra activé se trouvant au premier plan. La valeur
renvoyée est nulle si la composition ne contient aucun calque de caméra activé.
Type
Objet CameraLayer ; lecture seule.
Attribut CompItem bgColor
a pp. pro je c t .i tem ( in d e x) .b g Co l or
Description
Couleur de fond de la composition. Les trois valeurs du tableau définissent les composantes rouge, vert et bleu
de la couleur.
Type
Tableau contenant trois valeurs à virgule flottante, [R, V, B], comprises dans la plage [0.0..1.0] ; lecture/écriture.
53
Référence JavaScript
Objet CompItem
54
Attribut CompItem displayStartTime
a pp. pro je c t .i tem ( in d e x) .d i sp l ay S ta r t Ti m e
Description
Heure définie en tant que début de la composition, en secondes. Elle est équivalente à la valeur Code temporel
initial ou Première image définie dans la boîte de dialogue Paramètres de composition.
Type
Valeur à virgule flottante comprise dans la plage [0.0...86339.0] (25 heures moins 1 seconde) ; lecture/écriture.
Attribut CompItem draft3d
a pp. pro je c t .i tem ( in d e x) .d r a ft 3 d
Description
Lorsque cet attribut est true, le mode Ebauche 3D est activé pour le panneau Composition. Sa valeur correspond
à celle du bouton Ebauche 3D du panneau Composition.
Type
Booléen ; lecture/écriture.
Méthode CompItem duplicate()
a pp. pro je c t .i tem ( in d e x) .d u p li c a te ( )
Description
Crée et renvoie un doublon de cette composition, contenant les mêmes calques que l’original.
Paramètres
Aucun.
Renvoi
Objet CompItem.
Attribut CompItem frameBlending
a pp. pro je c t .i tem ( in d e x) .f r a m e Bl e n d in g
Description
Lorsque cet attribut est true, l’interpolation est activée pour cette composition. Sa valeur correspond à celle
du bouton d’interpolation dans le panneau Composition.
Type
Booléen ; si true, l’interpolation d’images est activée ; lecture/écriture.
54
Référence JavaScript
Objet CompItem
55
Attribut CompItem frameDuration
a pp. pro je c t .i tem ( in d e x) .f r a meD ur at i on
Description
Durée d’une image, exprimée en secondes. Il s’agit de l’inverse de la valeur f r am e R a te (images par seconde).
Type
Virgule flottante ; lecture/écriture.
Attribut CompItem hideShyLayers
a pp. pro je c t .i tem ( in d e x) .h id eS hy L ayers
Description
Lorsque cet attribut est true, seuls les calques pour lesquels s hy est défini sur false s’affichent dans le panneau
Montage. Lorsqu’il est false, tous les calques sont visibles, y compris ceux pour lesquels la valeur s hy est true.
Correspond à la valeur du bouton Masquer calques discrets du panneau Composition.
Type
Booléen ; lecture/écriture.
Méthode CompItem layer()
a pp. pro je c t .i tem ( in d e x) .l ayer (i n de x )
a pp. pro je c t .i tem ( in d e x) .l ayer (o t he rLaye r, re l In de x )
a pp. pro je c t .i tem ( in d e x) .l ayer (n a m e)
Description
Renvoie un objet Layer, pouvant être spécifié à l’aide d’un nom, d’une position d’index dans ce calque ou
d’une position d’index relative à un autre calque.
Paramètres
i n dex
Numéro d’index du calque souhaité dans cette composition. Nombre entier compris dans la
plage [1...numLayers], où nu m Lay e r s correspond au nombre de calques de la composition.
—ou—
otherL ayer
Objet Layer dans cette composition. La valeur re l In dex est ajoutée à la valeur d’index de
ce calque afin de trouver la position du calque souhaité.
rel In dex
Position du calque souhaité, relative à o t h e r L ayer . Nombre entier compris dans la plage
[1–oth erL ayer. in d ex .. . numLayers–o ther L ayer.index ], où n u m Lay e r s correspond
au nombre de calques de la composition.
Cette valeur est ajoutée à la valeur otherL ayer afin d’obtenir l’index absolu du calque à
renvoyer.
—ou—
name
Chaîne contenant le nom du calque souhaité.
55
Référence JavaScript
Objet CompItem
56
Renvoi
Objet Layer.
Attribut CompItem layers
a pp. pro je c t .i tem ( in d e x) .l ayers
Description
Objet LayerCollection qui contient tous les objets Layer des calques de cette composition. Voir la section « Objet
LayerCollection », page 92.
Type
Objet LayerCollection ; lecture seule.
Attribut CompItem motionBlur
a pp. pro je c t .i tem ( in d e x) .m o t io n B lu r
Description
Lorsque cet attribut est true, le flou directionnel est activé pour la composition. Sa valeur correspond à celle
du bouton Flou directionnel du panneau Composition.
Type
Booléen ; lecture/écriture.
Attribut CompItem numLayers
a pp. pro je c t .i tem ( in d e x) .nu m L ayers
Description
Nombre de calques contenus dans la composition.
Type
Entier ; lecture seule.
Attribut CompItem preserveNestedFrameRate
a pp. pro je c t .i tem ( in d e x) .preser veNe ste d Fr a m eR ate
Description
Lorsque cet attribut est true, la cadence d’image des compositions imbriquées est préservée dans la
composition en cours. Correspond à la valeur de l’option « Préserver la cadence (compositions imbriquées
ou en file d’attente de rendu) » de l’onglet Avancé de la boîte de dialogue Paramètres de composition.
Type
Booléen ; lecture/écriture.
56
Référence JavaScript
Objet CompItem
57
Attribut CompItem preserveNestedResolution
a pp. pro je c t .i tem ( in d e x) .preser veNe ste d Resolut i on
Description
Lorsque cet attribut est true, la résolution des compositions imbriquées est préservée dans la composition en
cours. Correspond à la valeur de l’option « Préserver la résolution (compositions imbriquées) » de l’onglet
Avancé de la boîte de dialogue Paramètres de composition.
Type
Booléen ; lecture/écriture.
Attribut CompItem renderer
a pp. pro je c t .i tem ( in d e x) .renderer
Description
Module externe de rendu à utiliser pour le rendu de cette composition, comme indiqué dans l’onglet Avancé de
la boîte de dialogue Paramètres de composition. Les valeurs autorisées sont les membres de c om p It e m.ren derers .
Type
Chaîne ; lecture/écriture.
Attribut CompItem renderers
a pp. pro je c t .i tem ( in d e x) .renderers
Description
Modules externes de rendu disponibles. Les chaînes des membres correspondent aux modules installés,
comme indiqué dans l’onglet Avancé de la boîte de dialogue Paramètres de composition.
Type
Tableau de chaînes ; lecture seule.
Attribut CompItem resolutionFactor
a pp. pro je c t .i tem ( in d e x) .res o lut i o n Fa c to r
Description
Facteurs de résolution de sous-échantillonnage de x et y pour le rendu de la composition.
Les deux valeurs du tableau indiquent le nombre de pixels à ignorer lors de l’échantillonnage. Le premier
numéro détermine l’échantillonnage horizontal, le second l’échantillonnage vertical. La résolution intégrale
est [1,1], la demi-résolution [2,2] et la résolution d’un quart [4,4]. La valeur par défaut est [1,1].
Type
Tableau de deux entiers compris dans la plage de valeurs [1..99] ; lecture/écriture.
57
Référence JavaScript
Objet CompItem
58
Attribut CompItem selectedLayers
a pp. pro je c t .i tem ( in d e x) .s e l e c te d L ayer s
Description
Tous les calques sélectionnés de cette composition. Il s’agit d’un tableau qui a zéro (0) pour base (le premier
objet se situe à l’index 0).
Type
Tableau d’objets Layer ; lecture seule.
Attribut CompItem selectedProperties
a pp. pro je c t .i tem ( in d e x) .s e l e c t e d Pro p e r t i e s
Description
Toutes les propriétés sélectionnées (objets Property et PropertyGroup) dans cette composition. La première
propriété se situe à l’index 0.
Type
Tableau d’objets Property et PropertyGroup ; lecture seule.
Attribut CompItem shutterAngle
a pp. pro je c t .i tem ( in d e x) .s hu t ter A n g l e
Description
Réglage de l’angle obturateur pour la composition. Ce réglage correspond au paramètre Angle obturateur de
l’onglet Avancé de la boîte de dialogue Paramètres de composition.
Type
Nombre entier compris dans la plage [0...720] ; lecture/écriture.
Attribut CompItem shutterPhase
a pp. pro je c t .i tem ( in d e x) .s hu t ter P h a se
Description
Réglage de la phase d’obturateur pour la composition. Ce réglage correspond au paramètre Phase d’obturateur
de l’onglet Avancé de la boîte de dialogue Paramètres de composition.
Type
Nombre entier compris dans la plage [–360...360] ; lecture/écriture.
58
Référence JavaScript
Objet CompItem
59
Attribut CompItem workAreaDuration
a pp. pro je c t .i tem ( in d e x) .wor k Area D ur a t ion
Description
Durée de la zone de travail, en secondes. Il s’agit de la différence entre l’instant du point de début et l’instant
du point de fin de la zone de travail Composition.
Type
Virgule flottante ; lecture/écriture.
Attribut CompItem workAreaStart
a pp. pro je c t .i tem ( in d e x) .wor k Area St ar t
Description
Moment, en secondes, où la zone de travail Composition commence.
Type
Virgule flottante ; lecture/écriture.
59
Référence JavaScript
Objet FileSource
60
Objet FileSource
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce
a pp. pro je c t .i tem ( in d e x) .p roxySo urce
Description
L’objet FileSource décrit le métrage issu d’un fichier.
• FileSource est une sous-classe de FootageSource. Toutes les méthodes et tous les attributs de FootageSource,
outre ceux énumérés ci-dessous, sont disponibles lorsque vous utilisez FileSource. Voir la section « Objet
FootageSource », page 67.
Attributs
Attribut
Référence
Description
f i le
« Attribut FileSource file », page 60
Fichier qui définit cette ressource.
m i s s i n g Fo ot a g e Pat h
« Attribut FileSource
missingFootagePath », page 60
Fichier contenant le métrage absent de cette ressource.
Méthodes
Méthode
Référence
Description
rel o a d ()
« Méthode FileSource reload() », page 61
Recharge la ressource du fichier, s’il s’agit d’un
m a i n S o u rce d’un FootageItem.
Attribut FileSource file
a pp. pro je c t .i tem ( i n d e x) .m a i n S o u rce .f il e
a pp. pro je c t .i tem ( i n d e x) .p roxy S o u rce . fi l e
Description
Objet ExtendScript File pour le fichier définissant cette ressource. Pour modifier la valeur :
• Si ce FileSource est un p roxy S o u rce d’un AVItem, appelez se t Prox y ( ) ou s e tProxyWi thS equence( ) .
• Si ce FileSource est un m a i n S o u rce d’un FootageItem, appelez rep l a ce( ) ou repla ceWith S equence() .
Type
Objet File ; lecture seule.
Attribut FileSource missingFootagePath
a pp. pro je c t .i tem ( i n d e x) . m a i n S o u rce . f il e .m i s s i n g Fo o t a g e Pat h
a pp. pro je c t .i tem ( i n d e x) .p roxy S o u rce . fi l e .m is s in g Fo o t ag e Pa th
Description
Chemin et nom de fichier du métrage absent de cette ressource. Voir aussi la section « Attribut AVItem
footageMissing », page 33.
Type
Chaîne ; lecture seule.
60
Référence JavaScript
Objet FileSource
61
Méthode FileSource reload()
a pp. pro je c t .i tem ( i n d e x) . m a i n S o u rce . f il e .m a i n S o u rce. re l o ad ( )
Description
Recharge la ressource du fichier. Cette méthode peut uniquement être appelée sur un m a i n S o u rce , et non sur
un p roxy S o u rce .
Paramètres
Aucun.
Renvoi
Aucun.
61
Référence JavaScript
Objet FolderItem
62
Objet FolderItem
a pp. pro je c t .FolderItem
Description
L’objet FolderItem correspond à un dossier de votre panneau Projet. Il peut contenir différents types
d’éléments (métrage, compositions, solides), ainsi que d’autres dossiers.
Exemple
Etant donné que le deuxième élément du projet est un FolderItem, le code suivant génère une alerte pour
chaque élément de niveau supérieur dans le dossier, en affichant son nom.
v ar secondItem = app.proj ec t. item(2 );
if ( !(secondItem inst anceof Fo lderItem) ) {
a l er t("problem: se cond item is no t a folder");
} else {
for ( i = 1 ; i <= s econd Item.nu m Item s; i + +) {
a l er t ( " i tem nu m b e r " + i + " w i t h in t h e f o l d e r i s n a m e d "
+ se cond Item .item( i) .n ame) ;
}
}
Attributs
Attribut
Référence
Description
i te m s
« Attribut FolderItem items », page 63
Contenu de ce dossier.
nu m Item s
« Attribut FolderItem numItems », page 63
Nombre d’éléments contenus dans ce dossier.
Méthode
Référence
Description
i te m ( )
« Méthode FolderItem item() », page 62
Récupère un élément du dossier.
Méthodes
Méthode FolderItem item()
a pp. pro je c t .i tem ( i n d e x) .i te m
Description
Renvoie l’élément de niveau supérieur de ce dossier à la position d’index spécifiée. Notez que la notion de
« niveau supérieur » fait référence aux niveaux à l’intérieur du dossier, mais pas nécessairement dans le projet.
Paramètres
i n dex
Nombre entier, numéro d’index de l’élément à récupérer. Le premier élément se situe à l’index 1.
Renvoi
Objet Item.
62
Référence JavaScript
Objet FolderItem
63
Attribut FolderItem items
a pp. pro je c t .i tem ( i n d e x) .i te m s
Description
Objet ItemCollection qui contient un objet Item représentant le contenu de niveau supérieur de ce dossier.
Contrairement à ItemCollection dans l’objet Project, cette collection contient uniquement les éléments de
niveau supérieur du dossier. Le niveau supérieur dans le dossier ne correspond pas au niveau supérieur dans
le projet. Seuls les éléments situés au niveau supérieur du dossier racine se retrouvent également au niveau
supérieur dans le projet.
Type
Objet ItemCollection ; lecture seule.
Attribut FolderItem numItems
a pp. pro je c t .i tem ( i n d e x) . nu m It e m s
Description
Nombre d’éléments contenus dans la collection d’élé m ents (fold e r Ite m . i tem s. l e n g t h ).
Si le dossier contient un autre dossier, seul le FolderItem pour ce dossier est pris en compte. Les sous-éléments
qu’il contient sont ignorés.
Type
Entier ; lecture seule.
63
Référence JavaScript
Objet FootageItem
64
Objet FootageItem
a pp. pro je c t .i tem ( i n d e x)
a pp. pro je c t .i tem s [ inde x ]
Description
L’objet FootageItem représente un élément de métrage importé dans un projet, qui apparaît dans le panneau
Projet. Il est possible d’accéder à ces objets dans la collection d’éléments Item d’un projet en utilisant leur
numéro d’index.
• FootageItem est une sous-classe d’AVItem, lui-même sous-classe d’Item. Toutes les méthodes et tous les
attributs d’AVItem et d’Item, outre ceux énumérés ci-dessous, sont disponibles lorsque vous utilisez
FootageItem. Voir les sections « Objet AVItem », page 32 et « Objet Item », page 76.
Attributs
Attribut
Référence
Description
f i le
« Attribut FootageItem file », page 64
Fichier source du métrage.
m a i n S o u rce
« Attribut FootageItem mainSource », page 65
Tous les paramètres liés à l’élément de métrage.
Méthodes
Méthode
Référence
Description
rep l ace( )
« Méthode FootageItem replace() »,
page 65
Remplace un fichier de métrage par un autre fichier
de métrage.
replaceWit hP laceho lder( )
« Méthode FootageItem
replaceWithPlaceholder() », page 65
Remplace un fichier de métrage par un objet
pseudo-élément.
replaceWit hSe quence()
« Méthode FootageItem
replaceWithSequence() », page 66
Remplace un fichier de métrage par une séquence
d’images.
rep l a ce Wi t h S o l i d ()
« Méthode FootageItem
replaceWithSolid() », page 66
Remplace un fichier de métrage par un solide.
Attribut FootageItem file
a pp. pro je c t .i tem ( i n d e x) .f i l e
Description
Objet ExtendScript File pour le fichier source du métrage.
Si le m a i n S o u rce du FootageItem est un FileSource, ce fichier est le même que Fo ot a geIt e m .ma inS ource. file .
Sinon, la valeur est nulle.
Type
Objet File ; lecture seule.
64
Référence JavaScript
Objet FootageItem
65
Attribut FootageItem mainSource
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce
Description
Source du métrage, objet qui contient tous les paramètres liés à cet élément de métrage, y compris ceux
habituellement accessibles par le biais de la boîte de dialogue Interpréter un métrage. L’attribut est en lecture
seule. Pour modifier sa valeur, appelez l’une des méthodes FootageItem « replace ».
Reportez-vous à la section « Objet FootageSource », page 67 et aux trois types d’objets différents :
• « Objet SolidSource », page 170
• « Objet FileSource », page 60
• « Objet PlaceholderSource », page 109
S’il s’agit d’un objet FileSource et que la valeur de f o o ta ge Mi ss i n g est true, le chemin d’accès au fichier de
métrage manquant se trouve dans l’attribut F i l eS ou rce.m i s s in g Fo ota g ePa th . Voir les sections « Attribut
AVItem footageMissing », page 33 et « Attribut FileSource missingFootagePath », page 60.
Type
Objet FootageSource ; lecture seule.
Méthode FootageItem replace()
a pp. pro je c t .i tem ( in d e x) .rep lace( file )
Description
Remplace la source de ce FootageItem par le fichier spécifié. En plus de charger le fichier, la méthode crée
un nouvel objet FileSource pour le fichier et définit m a i n S o u rce sur cet objet. Dans le nouvel objet source,
elle définit les attributs n a m e , w i dt h , heig ht , fr ame D ur a t ion et dur at i on (voir la section « Objet AVItem »,
page 32) en fonction du contenu du fichier.
La méthode préserve les paramètres d’interprétation de l’objet m a i n S o u rce précédent. Si le fichier spécifié
comporte une couche alpha non identifiée, la méthode évalue l’interprétation alpha.
Paramètres
file
Objet ExtendScript File pour le fichier à utiliser en tant que source principale du métrage.
Méthode FootageItem replaceWithPlaceholder()
a pp. pro je c t .i tem ( in d e x) .replaceWit hPla ceho l der( n am e , w id t h, he i g ht, fra m eR a te , d ura t i on )
Description
Remplace la source de ce FootageItem par le pseudo-élément spécifié. Crée un nouvel objet
PlaceholderSource, définit ses valeurs à partir des paramètres et définit m a in S o u rce sur cet objet.
Paramètres
name
Chaîne contenant le nom du pseudo-élément.
w i dt h
Largeur du pseudo-élément, en pixels. Nombre entier compris dans la plage [4..30000].
h eig h t
Hauteur du pseudo-élément, en pixels. Nombre entier compris dans la plage [4..30000].
65
Référence JavaScript
Objet FootageItem
66
f r a m eRa te
Cadence du pseudo-élément. Valeur à virgule flottante comprise dans la plage [1.0..99.0].
du r at i on
Durée du pseudo-élément, en secondes. Valeur à virgule flottante comprise dans la plage [0.0..10800.0].
Méthode FootageItem replaceWithSequence()
a pp. pro je c t .i tem ( in d e x) .replaceWit hSe quence( f i l e , fo rce Al p h a b e t i c a l )
Description
Remplace la source de ce FootageItem par la séquence d’images spécifiée. En plus de charger le fichier, la
méthode crée un nouvel objet FileSource pour le fichier et définit m a i n S o u rce sur cet objet. Dans le nouvel
objet source, elle définit les attributs n a m e , w i d th , h ei g h t , f r a m eD ur a t i on et d u r a t io n (voir la section « Objet
AVItem », page 32) en fonction du contenu du fichier.
La méthode préserve les paramètres d’interprétation de l’objet m a i n S o u rce précédent. Si le fichier spécifié
comporte une couche alpha non identifiée, la méthode évalue l’interprétation alpha.
Paramètres
file
Objet ExtendScript File pour le premier fichier de la séquence à utiliser en tant que source
principale du métrage.
force Alp ha b e t ic a l
Lorsque ce paramètre est true, l’option Ordre alphabétique doit être utilisée.
Méthode FootageItem replaceWithSolid()
a pp. pro je c t .i tem ( in d e x) . re p l a ceWit h S o l i d ( colo r, n am e , w idt h, h e ig ht, pi xe l As p e c t)
Description
Remplace la source de ce FootageItem par le solide spécifié. Crée un nouvel objet SolidSource, définit ses
valeurs à partir des paramètres et définit m ai n S ource sur cet objet.
Paramètres
co lor
Couleur du solide, tableau de trois valeurs à virgule flottante, [R, V, B], comprises dans la plage [0.0..1.0].
name
Chaîne contenant le nom du solide.
w i dt h
Largeur du solide, en pixels. Nombre entier compris dans la plage [4..30000].
h eig h t
Hauteur du solide, en pixels. Nombre entier compris dans la plage [4..30000].
p i xel As p e c t
Format des pixels du solide. Valeur à virgule flottante comprise dans la plage [0.01..100.0].
66
Référence JavaScript
Objet FootageSource
67
Objet FootageSource
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce
a pp. pro je c t .i tem ( in d e x) .p roxySo urce
Description
L’objet FootageSource contient des informations décrivant la source d’un métrage. Il est utilisé en tant que
m a i n S o u rce d’un FootageItem ou en tant que prox y S ou rce d’un CompItem ou d’un FootageItem. Voir les
sections « Objet FootageItem », page 64 et « Objet CompItem », page 52.
• FootageSource correspond à la classe de base de SolidSource. Ainsi, les attributs et les méthodes FootageSource
sont disponibles lorsque vous utilisez des objets SolidSource. Voir la section « Objet SolidSource », page 170.
Attributs
Attribut
Référence
Description
h as Al p ha
« Attribut FootageSource hasAlpha »,
page 70
Lorsque cet attribut est true, une séquence ou une
doublure de métrage inclut une couche alpha.
a l pha Mod e
« Attribut FootageSource alphaMode », Mode d’une couche alpha.
page 68
premu l Col or
« Attribut FootageSource
premulColor », page 71
i nver t A l pha
« Attribut FootageSource invertAlpha », Lorsque cet attribut est true, une couche alpha
page 70
d’une séquence de métrage ou d’une doublure
doit être inversée.
i s St i l l
« Attribut FootageSource isStill »,
page 70
Lorsque cet attribut est true, le métrage est une
image fixe.
f i e l d S e p a r a t i on Ty p e
« Attribut FootageSource
fieldSeparationType », page 69
Type de séparation de trame.
h ig hQ ua l it y F ie l dS epa r a ti on
« Attribut FootageSource
highQualityFieldSeparation », page 70
Définit la façon dont les trames doivent être
séparées dans un métrage non fixe.
rem ovePu l l dow n
« Attribut FootageSource
removePulldown », page 72
Type de conversion du métrage.
l o op
« Attribut FootageSource loop »,
page 71
Nombre de boucles d’une séquence d’images.
n a t iveFr a m e R a te
« Attribut FootageSource
nativeFrameRate », page 71
Cadence native du métrage.
d i sp l ay Fr am e R ate
« Attribut FootageSource
displayFrameRate », page 68
Cadence effective telle qu’affichée et rendue par
After Effects dans les compositions.
con f or m Fr a m e R a te
« Attribut FootageSource
conformFrameRate », page 68
Cadence à laquelle le métrage doit se conformer.
Couleur à prémultiplier.
Méthodes
Méthode
Référence
Description
gu essAlph aMo de()
« Méthode FootageSource
guessAlphaMode() », page 69
Evalue le paramètre alph aMo de .
g u e ss Pu l l dow n ()
« Méthode FootageSource
guessPulldown() », page 69
Evalue le paramètre pu l l dow n Ty p e .
67
Référence JavaScript
Objet FootageSource
68
Attribut FootageSource alphaMode
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .alp haMo de
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. alph aMo de
Description
L’attribut alphaMode de la footageSource définit la façon dont les informations alpha contenues dans le
métrage doivent être interprétées. Si hasAlpha est false, cet attribut est sans effet.
Type
Valeur énumérée Al p haMo de ; lecture/écriture. L’une des suivantes :
Alph aMo de. IGNOR E
Alph aMo de. STRAI GH T
Alph aMo de. PR EMU LTIPLIED
Attribut FootageSource conformFrameRate
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .con for m Fr am eRa te
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. confor mFr ameR ate
Description
Cadence d’image à utiliser à la place de la valeur n a t iveFr a m e Ra te . Si cet attribut est défini sur 0, la valeur
n a t iveFr a m e R a te est utilisée à la place.
Vous ne devez pas définir cette valeur si Fo o t a g e S o u rce . i s S t i l l est true. Vous ne devez pas définir cette valeur
sur 0 si rem ovePul l dow n n’est pas défini sur Pu l l dow n P h a se . O F F. Si la valeur est 0 lorsque vous définissez
rem ovePu l l dow n sur une valeur différente de Pul ldow n Ph as e.O F F, cette valeur est automatiquement définie
sur la valeur de n a t iveFr a m e R a te .
Type
Valeur à virgule flottante comprise dans la plage [0.0.. 99.0] ; lecture/écriture.
Attribut FootageSource displayFrameRate
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .d is p l ay Fr a m e R ate
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. di s pl ay Fr ame Ra te
Description
Cadence effective telle qu’affichée et rendue par After Effects dans les compositions.
Si rem ovePu l l dow n est égal à Pul l dow n P has e. OF F, cela équivaut à la valeur confor mFr ameR ate (si elle est
différente de zéro) ou à la valeur n a t iveFr a m e R a te (si confor mFr ame Rate est égal à 0). Si rem ove Pu l l dow n
est différent de Pul l dow n P ha se .OF F, cela équivaut à la valeur con f or m Fr a m e R a te * 0,8, la cadence réelle après
suppression d’une image sur cinq.
Type
Valeur à virgule flottante comprise dans la plage [0.0.. 99.0] ; lecture seule.
68
Référence JavaScript
Objet FootageSource
69
Attribut FootageSource fieldSeparationType
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .f ie l d S epa r a t ion Ty p e
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. fie ld S ep ar at ionTy p e
Description
Définit la façon dont les trames doivent être séparées dans un métrage non fixe.
Vous ne devez pas définir cet attribut si i s S t il l est true. Vous ne devez pas définir cette valeur sur
F i e l d S e p a r a t i o n Ty p e . O F F si rem ove Pul l dow n est différent de Pul l dow n Ph as e.O F F.
Type
Valeur énumérée F ie l d S epa r a t ion Ty p e ; lecture/écriture. L’une des suivantes :
F i e l d S e p a r a t i o n Ty p e . O F F
F i e l d S e p a r a t i o n Ty p e . U PPE R _ F I E L D _ F I R S T
F i e l d S e p a r a t i o n Ty p e . LOW E R _ F I E L D _ F I R S T
Méthode FootageSource guessAlphaMode()
a pp. pro je c t .i tem ( in d e x) .m a i n S ource .g ue ss Al pha Mod e( )
a pp. pro je c t .i tem ( in d e x) .proxySo urce. g uessAlphaMo de ()
Description
Définit a l pha Mod e , p re m u l Col o r et inver tAl ph a sur les évaluations les plus précises pour cette source de
métrage. Si h as Al pha est false, aucun changement n’est effectué.
Paramètres
Aucun.
Renvoi
Aucun.
Méthode FootageSource guessPulldown()
a pp. pro je c t .i tem ( in d e x) .m a i n S ource .g ue ss Pu l l dow n ( m e t ho d )
a pp. pro je c t .i tem ( in d e x) . p rox y S o u rc e . g u e s s Pu l l d ow n (m e t h o d )
Description
Définit f i e l d S e p a r a t i o n Ty p e et rem ovePul ldow n sur les évaluations les plus précises pour cette source de
métrage. Si i s S t il l est true, aucun changement n’est effectué.
Paramètres
method
Méthode à utiliser pour l’estimation. Valeur énumérée Pul ld ow n Me th od , l’une des suivantes :
Pul l d ow n Met h o d. PU L L D OW N _ 3 _ 2
Pul l dow n Met ho d. ADVANCE _24P
Renvoi
Aucun.
69
Référence JavaScript
Objet FootageSource
70
Attribut FootageSource hasAlpha
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .ha sAlph a
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. hasAlpha
Description
Lorsque cet attribut est défini sur true, le métrage possède un composant alpha. Dans ce cas, les attributs
a l pha Mod e , i nver t A l pha et p re mu l Col o r ont des valeurs valides. Lorsqu’il est défini sur false, ces attributs
n’ont pas d’importance pour le métrage.
Type
Booléen ; lecture seule.
Attribut FootageSource highQualityFieldSeparation
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .h i g hQ u a l i t y F i e l dS e p a r a t i o n
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. h i g h Qu a l i t y F i e l d S e p a r a t i on
Description
Lorsque cet attribut est défini sur true, After Effects utilise des algorithmes particuliers pour déterminer la
façon d’effectuer une séparation de trame haute qualité.
Vous ne devez pas définir cet attribut si i s S t il l a la valeur true ou si f ie l d S e p ar a t ion Ty p e est
F i e l d S e p a r a t i o n Ty p e . O F F.
Type
Booléen ; lecture/écriture.
Attribut FootageSource invertAlpha
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .i nver t Al p h a
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. inver tAl ph a
Description
Lorsque cet attribut est true, une couche alpha d’une séquence de métrage ou d’une doublure doit être
inversée.
Cet attribut n’est valide qu’en présence d’une couche alpha. Si h as Al pha a la valeur false ou que alp haMo de
est Alpha Mo de.I GN ORE , cet attribut est ignoré.
Type
Booléen ; lecture/écriture.
Attribut FootageSource isStill
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .i sS t i l l
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. is S t il l
Description
Lorsque cet attribut est défini sur true, le métrage est fixe. Lorsqu’il est défini sur false, le métrage possède un
composant temporel.
70
Référence JavaScript
Objet FootageSource
71
Les fichiers JPEG, les solides et les pseudo-éléments d’une durée de 0 sont des métrages fixes. Les fichiers de
films, les fichiers son, les séquences et les pseudo-éléments d’une durée différente de zéro sont des métrages
non fixes.
Type
Booléen ; lecture seule.
Attribut FootageSource loop
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .l o o p
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. lo op
Description
Nombre de lectures consécutives du métrage lors de son utilisation dans une composition.
Vous ne devez pas définir cet attribut si i s S t il l est true.
Type
Nombre entier compris dans la plage [1.. 9999] ; la valeur par défaut est 1 ; lecture/écriture.
Attribut FootageSource nativeFrameRate
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .nat iveFr ame Rate
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. n a t iveFr a m e R a te
Description
Cadence native du métrage.
Type
Virgule flottante ; lecture/écriture.
Attribut FootageSource premulColor
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .premul Co l or
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. premul Col or
Description
Couleur à prémultiplier. Cet attribut n’est valide que si a l pha Mod e est défini sur alph aMo de. PR EMU LTIPLIED .
Type
Tableau de trois valeurs à virgule flottante, [ R , G , B ] , comprises dans la plage [0.0..1.0] ; lecture/écriture.
71
Référence JavaScript
Objet FootageSource
72
Attribut FootageSource removePulldown
a pp. pro je c t .i tem ( in d e x) . m a i n S o u rce .rem ove Pu l l dow n
a pp. pro je c t .i tem ( in d e x) .p roxySo urce. rem ovePul l dow n
Description
Manière dont les conversions doivent être supprimées lorsque la séparation de trame est utilisée.
Vous ne devez pas définir cet attribut si i s S t il l est true. Vous ne devez pas définir cet attribut sur une valeur
différente de Pul l dow n Ph a s e . O F F si f ie l dS epa r a ti on Ty p e est F ie l dS epa r a ti on Ty p e. OF F.
Type
Valeur énumérée Pul l dow n P has e ; lecture/écriture. L’une des suivantes :
Pul l dow n Ph a s e . Re m ove Pu l l dow n . O F F
Pul l dow n Ph a s e . Re m ove Pu l l dow n . WS S W W
Pul l dow n Ph a s e . Re m ove Pu l l dow n . S S W W W
Pul l dow n Ph a s e . Re m ove Pu l l dow n . S W W WS
Pul l dow n Ph a s e . Re m ove Pu l l dow n . W W WSS
Pul l dow n Ph a s e . Re m ove Pu l l dow n . W WS S W
Pul l dow n Ph a s e . Re m ove Pu l l dow n . WS S W W _ 2 4 P_ A DVA N C E
Pul l d ow n Ph a s e . Re m ove Pu l l d ow n . S S W W W _ 2 4P _ A DVAN C E
Pul l dow n Ph a s e . Re m ove Pu l l dow n . S W W WS _ 2 4 P_ A DVA N C E
Pul l dow n Ph a s e . Re m ove Pu l l dow n . W W WSS _ 2 4 P_ A DVA N C E
Pul l dow n Ph a s e . Re m ove Pu l l dow n . W WS S W _ 2 4 P_ A DVA N C E
72
Référence JavaScript
Objet ImportOptions
73
Objet ImportOptions
n e w Im p o r t O p t i on s ( ) ;
n e w Im p o r t O p t i on s ( file ) ;
Description
L’objet ImportOptions incorpore les options utilisées pour importer un fichier à l’aide des méthodes
Pro jec t .i m p or t F il e . Voir la section « Méthode Project importFile() », page 113.
Le constructeur prend un paramètre facultatif, un objet ExtendScript File pour le fichier. S’il n’est pas fourni,
vous devez définir explicitement la valeur de l’attribut f i l e avant d’utiliser l’objet avec la méthode i m p o r t F i l e .
Par exemple :
n e w Im p o r t O p t i on s ( ) . f i l e = n e w F i l e ( "my f i le . p s d " ) ;
Attributs
Attributs
Référence
Description
i m p o r tAs
« Attribut ImportOptions importAs »,
page 74
Type de fichier à importer.
s e qu e n ce
« Attribut ImportOptions sequence »,
page 75
Lorsque cet attribut est défini sur true, importe une séquence
de fichiers plutôt qu’un seul fichier.
force Alp ha b e ti c a l
« Attribut ImportOptions
forceAlphabetical », page 74
Lorsque cet attribut est défini sur true, l’option Ordre
alphabétique est définie.
f i le
« Attribut ImportOptions file », page 74
Fichier à importer ou premier fichier de la séquence à importer.
Méthodes
Méthode
Référence
Description
c a n Im p or t As ( )
« Méthode ImportOptions
canImportAs() », page 73
Limite l’entrée à un type de fichier particulier.
Méthode ImportOptions canImportAs()
imp or t O p t i ons . c a n Im p or t As( t y p e)
Description
Indique si le fichier peut être importé en tant que source d’un type d’objet particulier. Si la méthode renvoie
true, vous pouvez définir le type donné en tant que valeur de l’attribut i m p o r tAs . Voir la section « Attribut
ImportOptions importAs », page 74.
Paramètres
type
Type de fichier pouvant être importé. Valeur énumérée Im p or tAs Ty p e
; l’une des suivantes :
Im p o r t AsTy p e . C OM P
Im p o r t AsTy p e . F O OTAG E
Im p o r t AsTy p e . C OM P_ C ROP PE D_ L AY E R S
Im p o r t AsTy p e . PRO J E C T
Renvoi
Booléen.
73
Référence JavaScript
Objet ImportOptions
74
Exemple
v ar i o = n e w Im p o r t O p ti o n s (F i l e ( “c :\ \ myF i l e . ps d ” )) ;
i f io. c an Im p o r t As (Im p o r tAs Ty p e .C O M P ) ;
i o.i m p o r tAs = Im p o r tAs Ty p e.C O M P;
Attribut ImportOptions file
imp or t O p t i ons . f i l e
Description
Fichier à importer. Si un fichier est défini dans le constructeur, vous pouvez y accéder via cet attribut.
Type
Objet ExtendScript File ; lecture/écriture.
Attribut ImportOptions forceAlphabetical
imp or t O p t i ons .f orce Al pha b e t ic a l
Description
Lorsque cet attribut est défini sur true, produit le même effet que lorsque l’option Ordre alphabétique de la
boîte de dialogue Fichier > Importer > Fichier est activée.
Type
Booléen ; lecture/écriture.
Attribut ImportOptions importAs
imp or t O p t i ons .imp or tAs
Description
Type d’objet pour lequel le fichier importé sert de source. Avant de le définir, utilisez c a n Im p o r t As pour vérifier
qu’un fichier donné peut être importé en tant que source du type d’objet donné. Voir la section « Méthode
ImportOptions canImportAs() », page 73.
Type
Valeur énumérée Im p or tAs Ty p e ; lecture/écriture. L’une des suivantes :
Im p o r tAs Ty p e .C O M P _ C RO PPE D _ L AYE R S
Im p o r tAs Ty p e .F O OTAG E
Im p o r tAs Ty p e .C O M P
Im p o r tAs Ty p e .P ROJ E C T
74
Référence JavaScript
Objet ImportOptions
75
Attribut ImportOptions sequence
imp or t O p t i ons .s e quence
Description
Lorsque cet attribut est défini sur true, une séquence est importée ; sinon, un fichier seul est importé.
Type
Booléen ; lecture/écriture.
75
Référence JavaScript
Objet Item
76
Objet Item
a pp. pro je c t .i tem ( i n dex )
a pp. pro je c t .i te m s [ in d ex ]
Description
L’objet Item représente un élément pouvant apparaître dans le panneau Projet.
Le premier élément se situe à l’index 1.
• Item est la classe de base d’AVItem et de FolderItem, eux-mêmes classes de base de plusieurs autres types
d’élément. Ainsi, les attributs et les méthodes Item sont disponibles lorsque vous utilisez ces types
d’élément. Voir les sections « Objet AVItem », page 32 et « Objet FolderItem », page 62.
Attributs
Attributs
Référence
Description
name
« Attribut Item name », page 77
Nom de l’objet, tel qu’affiché dans le panneau Projet.
com m e n t
« Attribut Item comment », page 77
Chaîne descriptive.
id
« Attribut Item id », page 77
Identificateur unique pour cet élément.
p aren tFol de r
« Attribut Item parentFolder », page 77
Dossier parent de cet élément.
s e l e c te d
« Attribut Item selected », page 78
Lorsque cet attribut est défini sur true, cet élément est
actuellement sélectionné.
t y p e Na m e
« Attribut Item typeName », page 78
Type d’élément.
Méthode
Référence
Description
rem ove( )
« Méthode Item remove() », page 78
Supprime l’élément du projet.
Méthodes
Exemple
L’exemple suivant obtient le deuxième élément du projet et vérifie qu’il s’agit d’un dossier. Il supprime ensuite
du dossier tout élément de niveau supérieur n’étant pas actuellement sélectionné. Il vérifie par ailleurs, pour
chaque élément du dossier, que le parent est correctement défini sur le dossier adéquat.
v ar my Folder = a pp.proje c t.item (2);
i f (my Fo ld e r. t y p e Nam e ! = " Fo l d e r " ) {
a l er t( " e r ro r : s e con d i te m i s n o t a fo ld e r " );
}
e l se {
v ar nu mInFolder = my Fo lder.numItems;
/ / A lw ay s r u n l o o p s b a ck wa rds w h en del e t i n g th i n g s:
f o r ( i = n u m In Fo l d e r ; i > = 1 ; i- - ) {
v ar c ur Item = my Fol d er. item (i ) ;
i f ( c ur Item .p aren tFol der != myFol der ) {
a l er t( "er ror w i th in A E : t he p arent Fold er i s no t s et cor re c t ly") ;
}
e l se {
i f ( ! c u rIte m . s e l e c t e d & & c u r Item . t y p eNam e = = " Fo ot a g e " ) {
/ / fo un d a n u n se l e c te d s o l i d .
c u r Item . rem ove ( ) ;
}
}
}
}
76
Référence JavaScript
Objet Item
77
Attribut Item comment
a pp. pro je c t .i tem ( in d e x) .comm en t
Description
Chaîne contenant un commentaire, d’une taille maximale de 15 999 octets après toute conversion d’encodage.
Ce commentaire est uniquement destiné à l’utilisateur ; il n’influe aucunement sur l’apparence et le
comportement de l’élément.
Type
Chaîne ; lecture/écriture.
Attribut Item id
a pp. pro je c t .i tem ( in d e x) . i d
Description
Numéro d’identification unique et persistant utilisé en interne pour identifier un élément entre les sessions.
La valeur de l’ID ne change pas lorsque le projet est enregistré dans un fichier et rechargé ultérieurement.
Toutefois, lorsque vous importez ce projet dans un autre projet, de nouveaux ID sont attribués à tous les
éléments du projet importé. L’ID ne s’affiche pas n’importe où dans l’interface utilisateur.
Type
Entier ; lecture seule.
Attribut Item name
a pp. pro je c t .i te m ( i n dex ) .n a m e
Description
Nom de l’élément, tel qu’affiché dans le panneau Projet.
Type
Chaîne ; lecture/écriture.
Attribut Item parentFolder
a pp. pro je c t .i tem ( in d e x) .p arent Fold er
Description
Objet FolderItem du dossier qui contient cet élément. Si cet élément se trouve au niveau supérieur du projet,
il s’agit du dossier racine du projet (app.proj ec t. ro otFolder ). Vous pouvez utiliser la méthode a dd Fol der
d’ItemCollection pour ajouter un nouveau dossier et définir cette valeur pour placer des éléments dans le
nouveau dossier. Voir la section « Méthode ItemCollection addFolder() », page 80.
Type
Objet FolderItem ; lecture/écriture.
77
Référence JavaScript
Objet Item
78
Exemple
Le script suivant crée un nouvel objet FolderItem dans le panneau Projet et y place des compositions.
/ / c re a t e a n e w Fol d e r Ite m i n p ro j e c t , w i t h n a m e “co m p s”
v ar compFolder = app.proj ec t. items. a ddFo l der(“com ps” );
/ / m ove a l l com p o s i t i o n s i n t o n e w f o l d e r by s e t t in g
/ / com p Ite m’s p a ren t Fol d e r to “com p s” f o l d e r
for ( v a r i = 1 ; i <= a p p.p ro j e c t . num Item s ; i + +) {
i f (a pp. pro j e c t . i tem ( i ) i n s ta n ce o f C om pIte m )
a pp. pro je c t .i tem( i ). pa rent Fol der = compFol d er ;
}
Méthode Item remove()
a pp. pro je c t .i tem ( in d e x) .remove()
Description
Supprime cet élément du projet et du panneau Projet. Si l’élément est un FolderItem, tous les éléments contenus
dans le dossier sont également supprimés du projet. Aucun fichier ou dossier n’est supprimé du disque.
Paramètres
Aucun.
Renvoi
Aucun.
Attribut Item selected
a pp. pro je c t .i tem ( in d e x) .s ele c ted
Description
Lorsque cet attribut est défini sur true, cet élément est sélectionné. Plusieurs éléments peuvent être
sélectionnés simultanément. Définissez cet attribut sur true pour que le programme sélectionne l’élément
ou sur false pour qu’il le désélectionne.
Type
Booléen ; lecture/écriture.
Attribut Item typeName
a pp. pro je c t .i tem ( in d e x) .t y p eName
Description
Nom du type d’élément lisible par l’utilisateur ; par exemple : « Folder », « Footage » ou « Composition ».
Type
Chaîne ; lecture seule.
78
Référence JavaScript
Objet ItemCollection
79
Objet ItemCollection
a pp. pro je c t .i tem s
Description
L’objet ItemCollection représente une collection d’éléments. L’ItemCollection appartenant à un objet Project
contient tous les objets Item correspondant aux éléments du projet. L’ItemCollection appartenant à un objet
FolderItem contient tous les objets Item correspondant aux éléments de ce dossier.
• ItemCollection est une sous-classe de Collection. Toutes les méthodes et tous les attributs de Collection, outre
ceux énumérés ci-dessous, sont disponibles lorsque vous utilisez ItemCollection. Voir la section « Objet
Collection », page 51.
Méthodes
Méthode
Référence
Description
a d dCom p ( )
« Méthode ItemCollection addComp() »,
page 79
Crée un nouvel objet CompItem et l’ajoute à la collection.
a d dFol der( )
« Méthode ItemCollection addFolder() »,
page 80
Crée un nouvel objet FolderItem et l’ajoute à la collection.
Méthode ItemCollection addComp()
a pp. pro j e c t . i te m Co l l e c t i o n.a d dCom p ( n am e , w id t h, he i g ht, pi xe l As p e c t, du ra t io n , fram e R ate )
Description
Crée une nouvelle composition. Crée et renvoie un nouvel objet CompItem et l’ajoute à cette collection.
Si l’ItemCollection appartient au projet ou au dossier racine, le p a ren t Fol d e r du nouvel élément est le dossier
racine. Si l’ItemCollection appartient à n’importe quel autre dossier, le p aren tFol de r du nouvel élément est ce
FolderItem .
Paramètres
name
Chaîne contenant le nom de la composition.
w i dt h
Largeur de la composition, en pixels. Nombre entier compris dans la plage [4..30000].
h eig h t
Hauteur de la composition, en pixels. Nombre entier compris dans la plage [4..30000].
p i xel As p e c t
Format des pixels de la composition. Valeur à virgule flottante comprise dans la plage [0.01..100.0].
du r at i on
Durée de la composition, en secondes. Valeur à virgule flottante comprise dans la plage [0.0..10800.0].
f r a m eRa te
Cadence d’image de la composition. Valeur à virgule flottante comprise dans la plage [1.0..99.0]
Renvoi
Objet CompItem.
79
Référence JavaScript
Objet ItemCollection
80
Méthode ItemCollection addFolder()
a pp. pro j e c t . i te m Co l l e c t i o n.a d dFol der( n a m e )
Description
Crée un nouveau dossier. Crée et renvoie un nouvel objet FolderItem et l’ajoute à cette collection.
Si l’ItemCollection appartient au projet ou au dossier racine, le p aren t Fol d er du nouveau dossier est le dossier
racine. Si l’ItemCollection appartient à n’importe quel autre dossier, le p aren t Fol d er du nouveau dossier est
ce FolderItem .
Pour placer des éléments dans le dossier, définissez l’attribut p aren tFol de r de l’objet Item ; voir la section
« Attribut Item parentFolder », page 77.
Paramètres
name
Chaîne contenant le nom du dossier.
Renvoi
Objet FolderItem.
Exemple
Le script suivant crée un nouvel objet FolderItem dans le panneau Projet et y place des compositions.
/ / c re a t e a n e w Fol d e r Ite m i n p ro j e c t , w i t h n a m e “co m p s”
v ar compFolder = app.proj ec t. items. a ddFo l der(“com ps” );
/ / m ove a l l com p o s i t i o n s i n t o n e w f o l d e r by s e t t in g
/ / com p Ite m’s p a ren t Fol d e r to “com p s” f o l d e r
for ( v a r i = 1 ; i <= a p p.p ro j e c t . num Item s ; i + +) {
i f (a pp. pro j e c t . i tem ( i ) i n s ta n ce o f C om pIte m )
a pp. pro je c t .i tem( i ). pa rent Fol der = compFol d er ;
}
80
Référence JavaScript
Objet KeyframeEase
81
Objet KeyframeEase
my Ke y = n ew Ke y f r am e E as e( s p e e d, i n f l u e n c e );
Description
L’objet KeyframeEase incorpore les paramètres de lissage d’image clé de la propriété AE d’un calque. Le lissage
d’image clé est déterminé par les valeurs de vitesse et d’influence définies à l’aide de la méthode
s e t Te m p or al E a se AtKe y de la propriété. Voir la section « Méthode Property setTemporalEaseAtKey() », page 137.
Le constructeur crée un objet KeyframeEase. Les deux paramètres sont requis.
• s p e e d : valeur à virgule flottante. Définit l’attribut s p e e d .
• i n f lu en ce : valeur à virgule flottante comprise dans la plage [0.1..100.0]. Définit l’attribut i n f lu e n ce .
Exemple
L’exemple suivant suppose que la propriété spatiale Position possède plus de deux images clés.
v ar e a s e In = n e w Ke y fr am e E as e ( 0 .5 , 5 0 ) ;
v ar e a s e Out = n e w Ke y fr am e E as e ( 0 .7 5 , 8 5 ) ;
v ar my Pos i t i o n Pro p e r t y = a p p. p ro je c t . i te m ( 1) .l ayer (1 ).p rop er t y (" Po si t i on " )
my Pos i t i o n Pro p e r t y. se tTem p o r a l E as e At Ke y ( 2 , [ e a se In ], [ e a se Ou t ] ) ;
L’exemple suivant définit Scale, propriété temporelle à deux ou trois dimensions. Pour les propriétés 2D et 3D,
vous devez définir une valeur de lissage à l’approche (ea se In ) et une valeur de lissage à l’éloignement
(easeO ut ) pour chaque dimension.
v ar e a s e In = n e w Ke y fr am e E as e ( 0 .5 , 5 0 ) ;
v ar e a s e Out = n e w Ke y fr am e E as e ( 0 .7 5 , 8 5 ) ;
v ar my S c a l e Prop e r t y = a p p. p ro je c t .i te m ( 1 ) . l ayer (1 ) . p rop e r t y ( " S c a l e " )
my Sca l eProp er t y.se tTempor alEa s eAt Ke y (2, [ea se In, ea seIn , easeIn ], [ea seO ut, ea seO ut , ea seO ut ]);
Attributs
Attribut
Référence
Description
speed
« Attribut KeyframeEase speed », page 82
Paramètre de vitesse d’une image clé.
i n f lu e n ce
« Attribut KeyframeEase influence », page 81
Paramètre d’influence d’une image clé.
Attribut KeyframeEase influence
my Ke y. in flu en ce
Description
Valeur de l’influence de l’image clé, comme indiqué dans la boîte de dialogue Vélocité d’image clé.
Type
Valeur à virgule flottante comprise dans la plage [0.1..100.0] ; lecture/écriture.
81
Référence JavaScript
Objet KeyframeEase
82
Attribut KeyframeEase speed
my Ke y. sp ee d
Description
Valeur de la vitesse de l’image clé. Les unités dépendent du type de l’image clé et s’affichent dans la boîte de
dialogue Vélocité d’image clé.
Type
Valeur à virgule flottante ; lecture/écriture.
82
Référence JavaScript
Objet Layer
83
Objet Layer
a pp. pro je c t .i tem ( in d e x) .l ayer(i n de x )
Description
L’objet Layer fournit l’accès aux calques contenus dans des compositions. Il est accessible à partir de la
collection de calques d’un élément, via un numéro d’index ou une chaîne de nom.
• Layer est la classe de base de CameraLayer, TextLayer, LightLayer et AVLayer. Ainsi, les attributs et les
méthodes Layer sont disponibles lorsque vous utilisez les différents types de calque. Voir les sections « Objet
AVLayer », page 39, « Objet CameraLayer », page 50, « Objet LightLayer », page 97 et « Objet TextLayer »,
page 174.
Les calques contiennent des propriétés AE, en plus de leurs attributs et méthodes JavaScript. Pour des
exemples d’accès aux propriétés dans des calques, reportez-vous à la section « Objet PropertyBase », page 141.
Exemple
Si le premier élément du projet est un CompItem, l’exemple suivant désactive le premier calque de cette
composition et le renomme. Il peut par exemple permettre de désactiver une icône de la composition.
v ar f i r s t L aye r = a p p. p ro je c t .i te m ( 1 ) . l ayer (1 ) ;
f i r st L aye r.en a bl e d = f al s e ;
first L ayer.na m e = "D isa ble d Layer";
Attributs
Attribut
Référence
Description
i n dex
« Attribut Layer index », page 87
Position d’index du calque.
name
« Attribut Layer name », page 89
Nom du calque.
p aren t
« Attribut Layer parent », page 89
Parent de ce calque.
time
« Attribut Layer time », page 91
Instant courant du calque.
s ta r t Ti m e
« Attribut Layer startTime », page 91
Instant de début du calque.
s t retch
« Attribut Layer stretch », page 91
Extension temporelle du calque, en pourcentage.
i n Poi n t
« Attribut Layer inPoint », page 87
Point d’entrée du calque.
o u t Po i n t
« Attribut Layer outPoint », page 89
Point de sortie du calque.
e n a bl e d
« Attribut Layer enabled », page 86
Lorsque cet attribut est défini sur true, le calque est activé.
solo
« Attribut Layer solo », page 91
Lorsque cet attribut est défini sur true, le calque est isolé.
s hy
« Attribut Layer shy », page 90
Lorsque cet attribut est défini sur true, le calque est
discret.
l o cke d
« Attribut Layer locked », page 87
Lorsque cet attribut est défini sur true, le calque est
verrouillé.
h as Vi de o
« Attribut Layer hasVideo », page 87
Lorsque cet attribut est défini sur true, le calque
contient un composant vidéo.
a c t ive
« Attribut Layer active », page 84
Lorsque cet attribut est défini sur true, le calque est
actif à l’instant courant.
nu l l L aye r
« Attribut Layer nullLayer », page 89
Lorsque cet attribut est défini sur true, il s’agit d’un
calque nul.
s e l e c t e d Pro p e r t i e s
« Attribut Layer selectedProperties », page 90
Toutes les propriétés AE sélectionnées dans le calque.
com m e n t
« Attribut Layer comment », page 85
Commentaire descriptif pour le calque.
83
Référence JavaScript
Objet Layer
84
Attribut
Référence
Description
con t a i n i n g Com p
« Attribut Layer containingComp », page 85
Composition contenant ce calque.
i s Na m e S e t
« Attribut Layer isNameSet », page 87
Lorsque cet attribut est défini sur true, le nom du
calque a été explicitement défini.
Méthodes
Méthode
Référence
Description
rem ove( )
« Méthode Layer remove() », page 90
Supprime le calque de la composition.
m oveToB e g i n n i n g ( )
« Méthode Layer moveToBeginning() »,
page 88
Déplace le calque vers le haut de la composition (en
position de premier calque).
m oveToE n d ( )
« Méthode Layer moveToEnd() »,
page 88
Déplace le calque vers le bas de la composition (en position
de dernier calque).
moveAfter()
« Méthode Layer moveAfter() », page 88 Déplace le calque sous un autre calque.
m oveB e f ore( )
« Méthode Layer moveBefore() »,
page 88
Déplace le calque au-dessus d’un autre calque.
du pl i c ate( )
« Méthode Layer duplicate() », page 86
Duplique le calque.
copy ToCom p ( )
« Méthode Layer copyToComp() »,
page 86
Copie le calque vers le haut (le début) d’une autre
composition.
a c t iveAtTim e()
« Méthode Layer activeAtTime() »,
page 85
Indique si ce calque est actif à un instant donné.
s e tPare n t Wi th Ju m p ( )
« Méthode Layer
setParentWithJump() », page 90
Définit un nouveau parent pour ce calque.
a pp ly Pre se t( )
« Méthode Layer applyPreset() »,
page 85
Applique au calque une collection nommée de paramètres
d’animation.
Attribut Layer active
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). ac t ive
Description
Lorsque cet attribut est défini sur true, le composant vidéo du calque est actif à l’instant courant.
Pour que sa valeur soit true, le calque doit être activé, aucun autre calque ne doit être isolé, sauf si ce calque
l’est aussi, et l’instant donné doit être compris entre le point d’entrée (i n Poin t ) et le point de sortie (o u t Po i n t )
de ce calque.
Dans un calque audio, cette valeur n’est jamais true ; il existe un attribut aud i oAc t ive distinct dans l’objet
AVLayer.
Type
Booléen ; lecture seule.
84
Référence JavaScript
Objet Layer
85
Méthode Layer activeAtTime()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). ac t ive At Ti m e( t i m e)
Description
Renvoie true si ce calque est actif à l’instant spécifié. Pour que la valeur soit true, le calque doit être activé,
aucun autre calque ne doit être isolé, sauf si ce calque l’est aussi, et l’instant donné doit être compris entre le
point d’entrée (i n Poi n t ) et le point de sortie (o ut Poi n t ) de ce calque.
Paramètres
time
Temps, en secondes. Valeur à virgule flottante.
Renvoi
Booléen.
Méthode Layer applyPreset()
a pp app.proj ec t. item (i n de x ). l ayer( in d e x) .a pp lyPres e t( pre s e t Na m e );
Description
Applique au calque la collection spécifiée de paramètres d’animation (une animation prédéfinie). Les fichiers
d’animation prédéfinie se trouvent dans le dossier Presets. Les utilisateurs peuvent créer de nouvelles
animations prédéfinies via l’interface utilisateur.
Paramètres
pres e tNam e
Objet ExtendScript File du fichier contenant l’animation prédéfinie.
Renvoi
Aucun.
Attribut Layer comment
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). co m m e n t
Description
Commentaire descriptif pour le calque.
Type
Chaîne ; lecture/écriture.
Attribut Layer containingComp
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). con ta in in g Com p
Description
Composition contenant ce calque.
Type
Objet CompItem ; lecture seule.
85
Référence JavaScript
Objet Layer
86
Méthode Layer copyToComp()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). copy To Com p( intoComp)
Description
Copie le calque dans la composition spécifiée. Le calque d’origine reste inchangé. Crée un nouvel objet Layer
avec les mêmes valeurs que ce dernier, et place ce nouvel objet au début de la collection de calques (l ayers )
dans l’objet CompItem cible. Extrayez la copie en utilisant intoComp.layer(1 ) .
Effectuer une copie dans un calque modifie les positions d’index des calques déjà présents dans la composition
de destination. Cela équivaut à copier et coller un calque via l’interface utilisateur.
Paramètres
i n toC om p
Composition de destination et objet CompItem.
Renvoi
Aucun.
Méthode Layer duplicate()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). dup l i c ate ()
Description
Duplique le calque. Crée un nouvel objet Layer dans lequel toutes les valeurs sont identiques à celles de ce
calque. Elle produit le même résultat que la sélection d’un calque dans l’interface utilisateur suivie de la
sélection de la commande Edition > Dupliquer, excepté que la sélection dans l’interface utilisateur ne change
pas lorsque vous appelez cette méthode.
Paramètres
Aucun.
Renvoi
Objet Layer.
Attribut Layer enabled
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). en ab l ed
Description
Lorsque cet attribut est défini sur true, le calque est activé ; sinon, sa valeur est false. Correspond à l’état du
bouton Vidéo correspondant au calque dans le panneau Montage.
Type
Booléen ; lecture/écriture.
86
Référence JavaScript
Objet Layer
87
Attribut Layer hasVideo
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). has Vi deo
Description
Lorsque cet attribut est défini sur true, le calque possède un bouton Vidéo (icône en forme d’œil) dans le
panneau Montage ; sinon, sa valeur est false.
Type
Booléen ; lecture seule.
Attribut Layer index
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). in dex
Description
Position d’index du calque.
Type
Nombre entier compris dans la plage [1..num L ayers ] ; lecture seule.
Attribut Layer inPoint
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). in Poi n t
Description
Point d’entrée du calque, exprimé en secondes.
Type
Valeur à virgule flottante comprise dans la plage [-10800.0..10800.0] (+/- 3 heures) ; lecture/écriture.
Attribut Layer isNameSet
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). is Nam e S et
Description
True si la valeur de l’attribut Nam e a été définie explicitement et non automatiquement à partir de la source.
Type
Booléen ; lecture seule.
Attribut Layer locked
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). l ocked
Description
Lorsque cet attribut est défini sur true, le calque est verrouillé ; sinon, sa valeur est false. Correspond à la
commande d’activation/de désactivation du verrouillage dans le panneau Calque.
Type
Booléen ; lecture/écriture.
87
Référence JavaScript
Objet Layer
88
Méthode Layer moveAfter()
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). moveAf ter( laye r)
Description
Déplace ce calque à une position suivant immédiatement (au-dessous) le calque spécifié.
Paramètres
l ayer
Calque cible, objet Layer dans la même composition.
Renvoi
Aucun.
Méthode Layer moveBefore()
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). moveB efore( l ay e r)
Description
Déplace ce calque à une position précédant immédiatement (au-dessus) le calque spécifié.
Paramètres
l ayer
Calque cible, objet Layer dans la même composition.
Renvoi
Aucun.
Méthode Layer moveToBeginning()
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). moveTo Be g i nning()
Description
Déplace ce calque à la toute première position de la pile de calques (premier calque).
Paramètres
Aucun.
Renvoi
Aucun.
Méthode Layer moveToEnd()
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). moveTo End ()
Description
Déplace ce calque à la toute dernière position de la pile de calques (dernier calque).
Paramètres
Aucun.
Renvoi
Aucun.
88
Référence JavaScript
Objet Layer
89
Attribut Layer name
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). name
Description
Nom du calque. Par défaut, il s’agit du même nom que celui de la source (lequel ne peut pas être modifié dans
le panneau Calque), mais vous pouvez le modifier.
Type
Chaîne ; lecture/écriture.
Attribut Layer nullLayer
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). nul l Layer
Description
Lorsque cet attribut est défini sur true, le calque a été créé en tant qu’objet nul ; sinon, sa valeur est false.
Type
Booléen ; lecture seule.
Attribut Layer outPoint
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). outPoint
Description
Point de sortie du calque, exprimé en secondes.
Type
Valeur à virgule flottante comprise dans la plage [-10800.0..10800.0] (+/- 3 heures) ; lecture/écriture.
Attribut Layer parent
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). pa rent
Description
Parent de ce calque ; peut être nul.
Les valeurs de décalage sont calculées de manière à compenser toute transformation supérieure dans
la hiérarchie. Ainsi, lorsque vous définissez le parent, il n’y a aucun déplacement apparent dans la
transformation du calque. Si, par exemple, la rotation du nouveau parent est de 30 degrés, une rotation
de -30 degrés est appliquée au calque enfant.
Pour définir le parent sans modifier les valeurs de transformation du calque enfant, utilisez la méthode
s et Paren t Wi th Jum p .
Type
Objet Layer ou valeur nulle ; lecture/écriture.
89
Référence JavaScript
Objet Layer
90
Méthode Layer remove()
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). remove ()
Description
Supprime le calque spécifié de la composition.
Paramètres
Aucun.
Renvoi
Aucun.
Attribut Layer selectedProperties
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). se l ec te d Prop er t ie s
Description
Tableau contenant tous les objets Property et PropertyGroup actuellement sélectionnés dans le calque.
Type
Tableau d’objets PropertyBase ; lecture seule.
Méthode Layer setParentWithJump()
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). se t ParentWit hJu m p( n e w Pa re nt )
Description
Définit le parent de ce calque sur le calque spécifié, sans modifier les valeurs de transformation du calque
enfant. Un déplacement de rotation, de translation ou de mise à l’échelle du calque enfant peut être apparent,
car les valeurs de transformation de ce calque sont combinées à celles de ses prédécesseurs.
Si vous ne souhaitez pas que le calque enfant se déplace, définissez l’attribut p a ren t directement. Dans ce cas,
un décalage est calculé et défini dans les trames de transformation du calque enfant afin d’empêcher le
déplacement de se produire.
Paramètres
n e w Pa re n t
Objet Layer dans la même composition.
Renvoi
Aucun.
Attribut Layer shy
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). shy
Description
Lorsque cet attribut est défini sur true, le calque est discret, ce qui signifie qu’il est masqué dans le panneau
Calque si l’option Masquer calques discrets de la composition est activée.
Type
Booléen ; lecture/écriture.
90
Référence JavaScript
Objet Layer
91
Attribut Layer solo
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). so lo
Description
Lorsque cet attribut est défini sur true, le calque est isolé ; sinon, sa valeur est false.
Type
Booléen ; lecture/écriture.
Attribut Layer startTime
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). st ar tTi m e
Description
Heure de début du calque, exprimée en secondes.
Type
Valeur à virgule flottante comprise dans la plage [-10800.0..10800.0] (+/- 3 heures) ; lecture/écriture.
Attribut Layer stretch
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). st re tch
Description
Extension temporelle du calque, exprimée en pourcentage. Une valeur de 100 n’applique aucune extension.
Les valeurs comprises entre 0 et 1 sont définies sur 1. Les valeurs comprises entre -1 et 0 (0 exclus) sont
définies sur -1.
Type
Valeur à virgule flottante comprise dans la plage [-9900.0..9900.0] ; lecture/écriture.
Attribut Layer time
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). t im e
Description
Instant courant du calque, exprimé en secondes.
Type
Valeur à virgule flottante ; lecture seule.
91
Référence JavaScript
Objet LayerCollection
92
Objet LayerCollection
a pp. pro je c t .i tem ( i n d e x) .l ayers
Description
L’objet LayerCollection représente un ensemble de calques. La LayerCollection appartenant à un objet
CompItem contient tous les objets Layer pour les calques de la composition. Les méthodes de l’objet
Collection vous permettent de manipuler la liste des calques.
• LayerCollection est une sous-classe de Collection. Toutes les méthodes et tous les attributs de Collection, outre
ceux énumérés ci-dessous, sont disponibles lorsque vous utilisez LayerCollection. Voir la section « Objet
Collection », page 51.
Exemple
Partant du principe que le premier élément du projet est un CompItem et que le second est un AVItem, le code
suivant permet d’afficher le nombre de calques dans la collection de calques de CompItem, d’ajouter un
nouveau calque basé sur un AVItem du projet et d’afficher le nouveau nombre de calques.
v ar f i r s t Co m p = a p p. p ro je c t .i te m ( 1 ) ;
v ar l ayer Co l l e c t ion = fi r s t Co m p.l ayer s;
a l er t ( " nu m b e r o f l ayer s b efore i s " + l ayer Co l l e c t i o n . l e n g t h ) ;
v ar a n AVItem = a pp.proje c t.i tem (2 );
l ayer Co l l e c t ion . a d d (a n AVIte m ) ;
a l er t ( " nu m b e r o f l ayer s a f ter i s " + l ayer C o l l e c t i o n . l e n g t h ) ;
Méthodes
Méthode
Référence
Description
a d d( )
« Méthode LayerCollection add() »,
page 93
Crée un nouveau AVLayer et l’ajoute à cette collection.
a d dNul l ( )
« Méthode LayerCollection addNull() »,
page 94
Crée un nouveau calque nul et l’ajoute à cette collection.
a d dS o li d ( )
« Méthode LayerCollection addSolid() », Crée un nouveau calque, un FootageItem avec un SolidSource, et
page 94
l’ajoute à cette collection.
a d dTex t( )
« Méthode LayerCollection addText() »,
page 95
Crée un nouveau calque de texte et l’ajoute à cette collection.
a d dCamer a( )
« Méthode LayerCollection
addCamera() », page 93
Crée un nouveau calque de caméra et l’ajoute à cette collection.
a d dL i g ht ()
« Méthode LayerCollection addLight() », Crée un nouveau calque de lumière et l’ajoute à cette collection.
page 93
a d dS ha p e( )
« Méthode LayerCollection
addShape() », page 94
Crée un nouveau calque de forme et l’ajoute à cette collection.
by Na m e( )
« Méthode LayerCollection byName() »,
page 95
Extrait l’objet calque portant le nom spécifié.
pre co m p o s e ( )
« Méthode LayerCollection
precompose() », page 96
Rassemble les calques spécifiés dans une nouvelle composition.
92
Référence JavaScript
Objet LayerCollection
93
Méthode LayerCollection add()
a pp. pro je c t .i tem ( i n d e x) .l ayers .a d d (ite m , du ra t io n )
Description
Crée un nouvel objet AVLayer contenant l’élément spécifié et l’ajoute à cette collection.
Cette méthode génère une exception si l’élément ne peut pas être ajouté en tant que calque à cette composition.
Paramètres
i te m
Objet AVItem de l’élément à ajouter.
du r at i on
Facultatif, durée en secondes d’un calque fixe, valeur à virgule flottante. Utilisé uniquement si l’élément
contient une partie de métrage fixe. N’affecte ni les films, ni les séquences, ni l’audio.
Défini, ce paramètre détermine la du rée du nouveau calque. Sinon, la du rée est définie en fonction des
préférences utilisateur. Par défaut, la durée est identique à celle du CompItem. Pour spécifier une valeur
préférée, choisissez Edition > Préférences > Importer (Windows) ou After Effects > Préférences > Importer
(Mac OS), puis sélectionnez les options désirées dans la zone Métrage fixe.
Renvoi
Objet AVLayer.
Méthode LayerCollection addCamera()
a pp. pro je c t .i tem ( i n d e x) .layers .a d d Cam er a( n a m e , c e nt e r Po i n t)
Description
Crée un nouveau calque de caméra et ajoute l’objet CameraLayer à cette collection.
Paramètres
name
Chaîne contenant le nom du nouveau calque.
cen terPoi n t
Centre de la nouvelle caméra, tableau de valeurs à virgule flottante [x, y]. Permet de définir les valeurs
initiales x et y de la propriété Point ciblé de la nouvelle caméra. La valeur z est égale à 0.
Renvoi
Objet CameraLayer.
Méthode LayerCollection addLight()
a pp. pro je c t .i tem ( i n d e x) .l ayers .a d d L ig h t ( n a m e , c e n t e r Po i n t )
Description
Crée un nouveau calque de lumière et ajoute l’objet LightLayer à cette collection.
Paramètres
name
Chaîne contenant le nom du nouveau calque.
cen terPoi n t
Centre de la nouvelle lumière, tableau de valeurs à virgule flottante [x, y].
Renvoi
Objet LightLayer.
93
Référence JavaScript
Objet LayerCollection
94
Méthode LayerCollection addNull()
a pp. pro je c t .i tem ( i n d e x) . l ayers . a d d Nu l l ( durat io n )
Description
Crée un nouveau calque nul et ajoute l’objet AVLayer à cette collection. Cela revient à sélectionner la
commande Calque > Créer > Objet nul.
Paramètres
du r at i on
Facultatif, durée en secondes d’un calque fixe, valeur à virgule flottante.
Défini, ce paramètre détermine la du rée du nouveau calque. Sinon, la du rée est définie en fonction des
préférences utilisateur. Par défaut, la durée est identique à celle du CompItem. Pour spécifier une valeur préférée,
choisissez Edition > Préférences > Importer (Windows) ou After Effects > Préférences > Importer (Mac OS), puis
sélectionnez les options désirées dans la zone Métrage fixe.
Renvoi
Objet AVLayer.
Méthode LayerCollection addShape()
a pp. pro je c t .i tem ( i n d e x) .l ayers .a d d Sh ap e ()
Description
Crée un nouvel objet ShapeLayer pour un nouveau calque de forme vide. Utilisez l’objet ShapeLayer pour
ajouter des propriétés, telles qu’une forme, un fond, un contour et des filtres de contour.
Cela revient au même que d’utiliser un outil de forme en mode « L’outil crée une forme ». Les outils ajoutent
automatiquement un groupe de vecteurs incluant un fond et un contour définis dans les options des outils.
Paramètres
Aucun.
Renvoi
Objet ShapeLayer.
Méthode LayerCollection addSolid()
a pp. pro je c t .i tem ( i n d e x) .l ayers .a d d S o l id ( c ol or, n am e , w id t h, he ig h t , p ix e lAs p ec t, durat i on)
Description
Crée un nouvel objet SolidSource, avec les valeurs spécifiées ; définit le nouveau SolidSource comme la valeur
m a i n S o u rce d’un nouvel objet FootageItem et ajoute le FootageItem au projet. Crée un nouvel objet AVLayer,
définit le nouveau FootageItem comme so urce et ajoute le calque à cette collection.
Paramètres
co lor
Couleur du solide, tableau de quatre valeurs à virgule flottante [R, V, B, A], comprises dans la plage [0.0..1.0].
name
Chaîne contenant le nom du solide.
w i dt h
Largeur du solide, en pixels. Nombre entier compris dans la plage [4..30000].
94
Référence JavaScript
Objet LayerCollection
95
h eig h t
Hauteur du solide, en pixels. Nombre entier compris dans la plage [4..30000].
p i xel As p e c t
Format des pixels du solide. Valeur à virgule flottante comprise dans la plage [0.01..100.0].
du r at i on
Facultatif, durée en secondes d’un calque fixe, valeur à virgule flottante.
Défini, ce paramètre détermine la d u r é e du nouveau calque. Sinon, la d u r é e est définie en fonction des
préférences utilisateur. Par défaut, la durée est identique à celle du CompItem. Pour spécifier une valeur
préférée, choisissez Edition > Préférences > Importer (Windows) ou After Effects > Préférences > Importer
(Mac OS), puis sélectionnez les options désirées dans la zone Métrage fixe.
Renvoi
Objet AVLayer.
Méthode LayerCollection addText()
a pp. pro je c t .i tem ( i n d e x) .l ayers .a d d Tex t (s ou rc eTe x t )
Description
Crée un nouveau calque de texte et ajoute le nouvel objet TextLayer à cette collection.
Paramètres
s o u rce Tex t
Facultatif ; chaîne contenant le texte source du nouveau calque ou objet TextDocument contenant
le texte source du nouveau calque. Voir la section « Objet TextDocument », page 173.
Renvoi
Objet TextLayer.
Méthode LayerCollection byName()
a pp. pro je c t .i tem ( i n d e x) .l ayers .by Nam e ( n a m e )
Description
Renvoie le premier calque (calque supérieur) trouvé dans cette collection avec le nom spécifié, ou une valeur
nulle si aucun calque portant le nom spécifié n’a été trouvé.
Paramètres
name
Chaîne contenant le nom.
Renvoi
Objet Layer ou valeur nulle.
95
Référence JavaScript
Objet LayerCollection
96
Méthode LayerCollection precompose()
a pp. pro je c t .i tem ( i n d e x) .l ayers .p re com p o s e ( l ay e r In di c i es , n a m e , m ov e Al l At t r i bu te s )
Description
Crée un nouvel objet CompItem et déplace les calques spécifiés dans sa collection de calques. Les calques
individuels sont alors supprimés de cette collection et le nouveau CompItem y est ajouté.
Paramètres
l ayer In di ce s
Index de position des calques à récupérer. Tableau d’entiers.
name
Nom du nouvel objet CompItem.
m oveAl l At t r i bute s
Facultatif. Si la valeur est true (par défaut), tous les attributs de la nouvelle
composition sont conservés. Cela revient à sélectionner l’option « Transférer tous
les attributs vers la nouvelle composition » de la boîte de dialogue
Précomposition.
Vous pouvez définir cette valeur sur false uniquement s’il n’existe qu’un seul
index dans le tableau l ayer In d i ce s . Cela revient à sélectionner l’option
« Laisser tous les attributs dans » de la boîte de dialogue Précomposition.
Renvoi
Objet CompItem.
96
Référence JavaScript
Objet LightLayer
97
Objet LightLayer
a pp. pro je c t .i tem ( in d e x) .l ayer(i n de x )
Description
L’objet LightLayer représente un calque de lumière dans une composition. Vous pouvez le créer à l’aide de
la méthode a d d L ig h t de l’objet LayerCollection ; voir la section « Méthode LayerCollection addLight() »,
page 93. Pour accéder à cet objet dans la collection de calques d’un élément, vous pouvez utiliser son numéro
d’index ou encore une chaîne de nom.
• LightLayer est une sous-classe de Layer. Toutes les méthodes et tous les attributs de Layer sont disponibles
lorsque vous utilisez LightLayer. Voir la section « Objet Layer », page 83.
Propriétés AE
LightLayer ne définit pas d’attribut supplémentaire, mais possède des propriétés AE qui diffèrent des autres
types de calques. Il dispose des propriétés et des groupes de propriétés suivants :
Ma r ker
Tr an s for m
Poi n t of In teres t
Pos i t i on
S c al e
Orientation
X Rot at i on
Y Rot at i o n
Rot at i o n
O p a ci t y
L i g ht O p t i o n s
In ten s i t y
Col or
Con e An g l e
Con e Fea th er
C as ts S h a dow s
S h a dow D a r k n e s s
S h a dow D i ff u s i on
97
Référence JavaScript
Objet MarkerValue
98
Objet MarkerValue
new Ma r kerVa lue( c om m e n t , c h ap te r, u r l, f ra m eTar ge t, cue Po intName , p arams )
Description
L’objet MarkerValue représente un repère de calque qui associe un commentaire, et éventuellement un point
de référence d’un chapitre, un lien vers une page Web ou un signal de départ vidéo Flash, à un point particulier
d’un calque. Vous le créez à l’aide du constructeur ; tous les arguments à l’exception de com m e n t sont
facultatifs. Tous les arguments sont des chaînes définies dans les attributs correspondants de l’objet
MarkerValue renvoyé, sauf p ar am s . Il s’agit d’un tableau comprenant des paires de valeurs clés, accessibles
ensuite par le biais des méthodes ge t Par a m e ters( ) et s e tPa r am e ters ( ) . Un script peut définir un nombre
indifférent de paires de paramètres ; leur ordre ne reflète pas l’ordre d’affichage dans l’application.
Pour associer un repère à un calque, définissez l’objet MarkerValue dans la propriété AE Ma r ker du calque.
laye rO bj ec t . prop e r t y (" Mar ker " ) .s e tVa lu e AtTi m e (t im e, m a r ke r Val u eO b j e ct );
Pour plus d’informations sur l’utilisation des repères, consultez la rubrique « Utilisation des repères » dans
l’aide d’After Effects.
Attributs
Attribut
Référence
Description
com m e n t
« Attribut MarkerValue comment »,
page 99
Commentaire sur le calque associé.
cha p ter
« Attribut MarkerValue chapter »,
page 99
Point de référence d’un lien de chapitre pour le calque associé.
c u e Po in t Nam e
« Attribut MarkerValue cuePointName », Nom du signal de départ vidéo Flash.
page 99
e ven t Cue Poi n t
« Attribut MarkerValue eventCuePoint », Indique si le signal de départ vidéo Flash s’applique à un
page 99
événement ou à la navigation.
ur l
« Attribut MarkerValue url », page 101
URL de la page Web à associer au calque.
f r a m eTa rg et
« Attribut MarkerValue frameTarget »,
page 99
Image cible sur la page Web spécifiée par ur l .
Référence
Description
Méthodes
Méthode
g e t Pa r a m e t ers ( ) « Méthode MarkerValue
Extrait les paires de valeurs clés associées à la valeur du repère.
getParameters() », page 100
s e tPar ame ters ( )
« Méthode MarkerValue
setParameters() », page 100
Définit les paires de valeurs clés associées à la valeur du repère.
Exemples
• Pour définir un repère indiquant « Fade Up » au repère 2 secondes :
v ar my Mar ker = ne w Ma r kerVa lue ("Fa de Up");
my Layer.prop er t y ("Ma r ker").set ValueAtTim e(2 , my Mar ker );
• Pour obtenir des valeurs comment d’un repère particulier :
v ar comment O fFirstMa r ker = app.proj ec t. item(1 ). layer(1).prop er t y("Ma r ker").ke yVa lue (1 ). comment;
v ar com m e n t O f Ma r ke r AtTi m e 4 =
a pp. pro je c t .i te m ( 1 ) .l ayer (1 ). prop e r t y (" Mar ker " ) .v alu e At Ti m e (4 .0 , t r u e ). com m e n t
v ar ma r kerProper t y = a pp. pro je c t .item(1).layer (1 ). proper t y("Mar ker");
v ar ma r kerVa lueAtTimeClosestToTi me 4 =
m a r ke r Pro p e r t y. ke y Va l u e ( m a r ke r Pro p e r t y. n e a res t Ke y In d ex ( 4 .0 ) ) ;
v ar comment O fMa r kerClosestToTim e4 = ma r ker Valu e At Ti m e C lo s e s t ToTi m e 4 . com m e n t ;
98
Référence JavaScript
Objet MarkerValue
99
Attribut MarkerValue chapter
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). proper t y ("Mar ker ") .ke y Value( i n d e x) .ch ap ter
Description
Lien texte de chapitre pour ce repère. Les liens de chapitre déclenchent un saut vers un chapitre d’un film
QuickTime ou d’un autre format prenant en charge les repères de chapitre.
Type
Chaîne ; lecture/écriture.
Attribut MarkerValue comment
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). proper t y ("Mar ker ") .ke y Value( i n d e x) . com m e n t
Description
Texte de commentaire pour ce repère. Ce commentaire apparaît dans le panneau Montage en regard du repère
de calque.
Type
Chaîne ; lecture/écriture.
Attribut MarkerValue cuePointName
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). proper t y ("Mar ker ") .ke y Value( i n d e x) .c u e Po in t Nam e
Description
Nom du signal de départ vidéo Flash tel qu’il apparaît dans la boîte de dialogue Repère.
Type
Chaîne ; lecture/écriture.
Attribut MarkerValue eventCuePoint
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). proper t y ("Mar ker ") .ke y Value( i n d e x) .e ven tCu e Poin t
Description
Lorsque cet attribut est t r ue , le signal de départ vidéo Flash s’applique à un événement ; dans le cas contraire,
il s’applique à la navigation.
Type
Booléen ; lecture/écriture.
Attribut MarkerValue frameTarget
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). proper t y ("Mar ker ") .ke y Value( i n d e x) .f r a m eTa rg et
Description
Image texte cible pour ce repère. Comme la valeur URL, cet attribut cible une image spécifique contenue dans
une page Web.
Type
Chaîne ; lecture/écriture.
99
Référence JavaScript
Objet MarkerValue
100
Méthode MarkerValue getParameters()
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). proper t y ("Mar ker ") .ke y Value( i n d e x) .g e tPa r am e ters ( )
Description
Renvoie les paires de valeurs clés pour les paramètres de signal de départ vidéo Flash, pour un signal de départ
associé à cette valeur de repère.
Paramètres
Aucun.
Renvoi
Un objet avec un attribut correspondant au nom de chaque paramètre et contenant la valeur de ce paramètre.
Méthode MarkerValue setParameters()
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). proper t y ("Mar ker ") .ke y Value( i n d e x) .s e tPar ame ters ( ke y Val ue Pa ir s )
Description
Associe un ensemble de paires de valeurs clés pour les paramètres de signal de départ vidéo Flash, pour un
signal de départ associé à cette valeur de repère. Un signal de départ peut contenir un nombre indifférent de
paramètres, mais vous pouvez seulement en ajouter trois via l’interface utilisateur ; utilisez cette méthode
pour ajouter plus de trois paramètres.
Paramètres
ke y Valu ePai rs
Objet contenant les paires de valeurs clés en tant qu’attributs et valeurs. La méthode to St r i n g ( )
de l’objet est appelée pour affecter la valeur de chaîne de chaque attribut à la clé nommée.
Renvoi
Aucun.
Exemple
v ar mv = new Mar kerValu e("My Mar ker");
v ar p ar m s = n ew O b j ec t;
p ar m s. ti m e ToBl i n k = 1 ;
p ar m s. as si g n Me = "A s t r i ng"
mv. se tPa r a m e ter s ( p a r m s ) ;
my Layer.prop er t y ("Ma r ker").set ValueAtTim e(2 , mv);
100
Référence JavaScript
Objet MarkerValue
101
Attribut MarkerValue url
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). proper t y ("Mar ker ") .ke y Value( i n d e x) .u r l
Description
URL de ce repère. Cette URL est un lien automatique vers une page Web.
Type
Chaîne ; lecture/écriture.
101
Référence JavaScript
Objet MaskPropertyGroup
102
Objet MaskPropertyGroup
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). mas k
Description
L’objet MaskPropertyGroup insère les attributs de masque dans un calque.
• MaskPropertyGroup est une sous-classe de PropertyGroup. Toutes les méthodes et tous les attributs de
PropertyBase et PropertyGroup, outre ceux énumérés ci-dessous, sont disponibles lorsque vous utilisez
MaskPropertyGroup. Voir les sections « Objet PropertyBase », page 141 et « Objet PropertyGroup »,
page 148.
Attributs
Attribut
Référence
Description
ma sk Mo de
« Attribut MaskPropertyGroup maskMode », Mode masque.
page 103
i nver te d
« Attribut MaskPropertyGroup inverted »,
page 102
Lorsque cet attribut est true, le masque est inversé.
rotoB ez i er
« Attribut MaskPropertyGroup rotoBezier »,
page 104
Lorsque cet attribut est true, la forme du masque est
RotoBézier.
m a s k Mot i o n B lu r
« Attribut MaskPropertyGroup
maskMotionBlur », page 103
Manière dont le flou directionnel est appliqué à ce
masque.
l o cke d
« Attribut MaskPropertyGroup locked »,
page 103
Lorsque cet attribut est true, le masque est verrouillé.
co lor
« Attribut MaskPropertyGroup color »,
page 102
Couleur utilisée pour dessiner le contour du masque
dans l’interface utilisateur.
Attribut MaskPropertyGroup color
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). mas k (ind e x) .color
Description
Couleur utilisée pour dessiner le contour du masque, tel qu’il apparaît dans l’interface utilisateur (panneau
Composition, panneau Calque et panneau Montage).
Type
Tableau de trois valeurs à virgule flottante, [R, V, B], comprises dans la plage [0.0..1.0] ; lecture/écriture.
Attribut MaskPropertyGroup inverted
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). mas k (ind e x) .inver ted
Description
Lorsque cet attribut est true, le masque est inversé. Dans le cas contraire, cet attribut est false.
Type
Booléen ; lecture/écriture.
102
Référence JavaScript
Objet MaskPropertyGroup
103
Attribut MaskPropertyGroup locked
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). mas k (i n d e x ) .l o cke d
Description
Lorsque cet attribut est true, le masque est verrouillé et ne peut être édité dans l’interface utilisateur. Dans le
cas contraire, cet attribut est false.
Type
Booléen ; lecture/écriture.
Attribut MaskPropertyGroup maskMode
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). mas k (i n d e x ) .m as kMo de
Description
Mode de masque pour ce masque.
Type
Valeur énumérée Mas kMode ; écriture/lecture. L’une des suivantes :
Ma sk Mo de. N ONE
Ma sk Mo de. ADD
Ma sk Mo de. SU BTRAC T
Ma sk Mo de. I NTERS E CT
Ma sk Mo de. L IG HTE N
Ma sk Mo de. DA RK E N
Ma sk Mo de. DIF F E R E NCE
Attribut MaskPropertyGroup maskMotionBlur
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). mas k (i n d e x ) .m as kMo ti o n Blu r
Description
Manière dont le flou directionnel est appliqué à ce masque.
Type
Valeur énumérée Mas kMot ion Blu r ; lecture/écriture. L’une des suivantes :
Ma sk Mot i on Blur.S A ME _ AS _ L AYE R
Ma sk Mot i on Blur.O N
Ma sk Mot i on Blur.O F F
103
Référence JavaScript
Objet MaskPropertyGroup
104
Attribut MaskPropertyGroup rotoBezier
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). m a s k ( i n d e x ) .rotoB ezier
Description
Lorsque cet attribut est true, la forme du masque est RotoBézier. Dans le cas contraire, cet attribut est false.
Type
Booléen ; lecture/écriture.
104
Référence JavaScript
Objet OMCollection
105
Objet OMCollection
a pp. pro je c t .renderQ ueue. items. out p ut Mo dules
Description
L’objet OMCollection contient tous les modules de sortie de la file d’attente de rendu. La collection permet
d’accéder aux objets OutputModule, mais n’offre pas d’autres fonctionnalités. Le premier objet
OutputModule de la collection se trouve à la position d’index 1. Voir la section « Objet OutputModule »,
page 106.
• OMCollection est une sous-classe de Collection. Toutes les méthodes et tous les attributs de Collection sont
disponibles lorsque vous utilisez OMCollection. Voir la section « Objet Collection », page 51.
105
Référence JavaScript
Objet OutputModule
106
Objet OutputModule
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e s ( inde x )
Description
Un objet OutputModule de renderQueueItem génère un fichier ou une séquence unique par le biais d’un
rendu, et contient les attributs et méthodes associés au fichier pour lequel le rendu doit être effectué.
Attributs
Attribut
Référence
Description
f i le
« Attribut OutputModule file »,
page 106
Chemin et nom du fichier dont le rendu doit être effectué.
p o s t Ren de r Ac t i o n
« Attribut OutputModule
postRenderAction », page 107
Action à effectuer avant le rendu.
name
« Attribut OutputModule name »,
page 107
Nom de l’interface utilisateur du module de sortie.
tem pl a tes
« Attribut OutputModule templates »,
page 108
Tous les modèles du module de sortie.
Méthodes
Méthode
Référence
Description
rem ove( )
« Méthode OutputModule remove() »,
page 107
Supprime le module de sortie de la liste des éléments de la file
d’attente de rendu.
s aveAs Tem p l ate( )
« Méthode OutputModule
saveAsTemplate() », page 107
Enregistre un nouveau modèle de module de sortie.
a pp ly Te m p l ate ( )
« Méthode OutputModule
applyTemplate() », page 106
Applique un modèle de module de sortie.
Méthode OutputModule applyTemplate()
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e s [ inde x ] .ap plyTemp l ate( t e m p l a te Na m e)
Description
Applique le modèle de module de sortie prédéfini existant.
Paramètres
tem pl a teNam e
Chaîne contenant le nom du modèle à appliquer.
Renvoi
Aucun.
Attribut OutputModule file
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e s [ inde x ] .f il e
Description
Objet ExtendScript File du fichier dont le rendu doit être effectué avec ce module de sortie.
Type
Objet ExtendScript File ; lecture/écriture.
106
Référence JavaScript
Objet OutputModule
107
Attribut OutputModule name
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e s [ inde x ] .nam e
Description
Nom du module de sortie, tel qu’il apparaît dans l’interface utilisateur.
Type
Chaîne ; lecture seule.
Attribut OutputModule postRenderAction
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e s [ inde x ] .p o s tRen de r Ac t i o n
Description
Action à effectuer lorsque l’opération de rendu est terminée.
Type
Valeur énumérée Pos tRen d er Ac t ion (lecture/écriture) ; l’une des suivantes :
p o s t Ren de r Ac t i o n .N O N E
p o s t Ren de r Ac t i o n .I M PO RT
p o s t Ren de r Ac t i o n .I M PO RT _ A N D _ R E P L AC E _ US AG E
p o s t Ren de r Ac t i o n .S E T _ P ROXY
Méthode OutputModule remove()
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e s [ inde x ] .rem ove ()
Description
Supprime cet objet OutputModule de la collection.
Paramètres
Aucun.
Renvoi
Aucun.
Méthode OutputModule saveAsTemplate()
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e s [ inde x ] .s aveAs Tem p l ate( n a m e)
Description
Enregistre ce module de sortie comme modèle et l’ajoute au tableau des modèles (templa tes ).
Paramètres
name
Chaîne contenant le nom du nouveau modèle.
Renvoi
Aucun.
107
Référence JavaScript
Objet OutputModule
108
Attribut OutputModule templates
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e s [ inde x ] .tem p l ates
Description
Noms de tous les modèles de modules de sortie disponibles dans l’installation locale d’After Effects.
Type
Tableau de chaînes ; lecture seule.
108
Référence JavaScript
Objet PlaceholderSource
109
Objet PlaceholderSource
a pp. pro je c t .i tem ( i n d e x) .m a i n S o u rce
a pp. pro je c t .i tem ( i n d e x) .p roxy S o u rce
Description
L’objet PlaceholderSource décrit la source du métrage d’un pseudo-élément.
PlaceholderSource est une sous-classe de FootageSource. Toutes les méthodes et tous les attributs
de FootageSource sont disponibles lorsque vous utilisez PlaceholderSource. Voir la section « Objet
FootageSource », page 67. PlaceholderSource ne définit pas d’attributs ou de méthodes supplémentaires.
109
Référence JavaScript
Objet Project
110
Objet Project
a pp. pro je c t
Description
L’objet Project représente un projet After Effects. Les attributs donnent non seulement accès à des objets
spécifiques au sein du projet, tels que fichiers ou métrages importés et compositions, mais aussi aux
paramètres de projet tels que la base du code temporel. Les méthodes permettent d’importer le métrage,
de créer des solides, des compositions et des dossiers, et d’enregistrer les modifications.
Attributs
Attribut
Référence
Description
f i le
« Attribut Project file », page 113
Fichier du projet actuellement ouvert.
rootFo lder
« Attribut Project rootFolder », page 116 Dossier contenant tous les commentaires du
projet ; équivalent du panneau Projet.
i te m s
« Attribut Project items », page 114
a c t iveItem
« Attribut Project activeItem », page 111 Elément actuellement actif.
bitsPerChan n el
« Attribut Project bitsPerChannel »,
page 112
t r an s p aren c y Gr i d T hu m bn ai l s « Attribut Project
transparencyGridThumbnails »,
page 118
Tous les éléments du projet.
Codage des couleurs du projet en cours.
Lorsque cet attribut est défini sur true, les
vignettes utilisent le motif de damier de
transparence.
t i m e cod eD i sp l ay Ty p e
« Attribut Project
timecodeDisplayType », page 118
Mode d’affichage du code temporel.
t i m e cod e B as e Ty p e
« Attribut Project timecodeBaseType »,
page 117
Paramètre de base du code temporel du projet.
t i m e cod eN TS C D ro pFr am e
« Attribut Project
timecodeNTSCDropFrame », page 118
Paramètre d’image compensée du projet.
t i m e cod eF i l m Ty p e
« Attribut Project timecodeFilmType »,
page 118
Type de film pour le paramètre du projet
« Pieds + images ».
nu m Item s
« Attribut Project numItems », page 115 Nombre total d’éléments contenus dans le
projet.
selection
« Attribut Project selection », page 117
Tous les éléments sélectionnés dans le panneau
Projet.
renderQ ueue
« Attribut Project renderQueue »,
page 116
File d’attente de rendu du projet.
d i sp l ay S ta r t Fr a m e
« Attribut Project displayStartFrame »,
page 113
Image à partir de laquelle commence la
numérotation lors de l’affichage du projet.
linearBlending
« Attribut Project linearBlending »,
page 114
Lorsque cet attribut est défini sur true, la fusion
linéaire est utilisée dans le projet.
Méthodes
Méthode
Référence
Description
i te m ( )
« Méthode Project item() », page 114
Extrait un élément du projet.
con s ol i d ate Fo ot ag e( )
« Méthode Project
consolidateFootage() », page 112
Consolide tout le métrage du projet.
110
Référence JavaScript
Objet Project
111
Méthode
Référence
Description
rem oveUnu se d Fo ota g e( )
« Méthode Project
removeUnusedFootage() », page 115
Supprime tout métrage non utilisé du projet.
red uce Proje c t( )
« Méthode Project reduceProject() »,
page 115
Réduit le projet à un ensemble donné
d’éléments.
cl o se( )
« Méthode Project close() », page 112
Ferme le projet avec les options
d’enregistrement habituelles.
s ave( )
« Méthode Project save() », page 116
Enregistre le projet.
s aveWi th Di a l o g ( )
« Méthode Project saveWithDialog() »,
page 116
Affiche une boîte de dialogue Enregistrer.
i m p o r tP l ace h o ld e r ( )
« Méthode Project
importFileWithDialog() », page 113
Importe un pseudo-élément dans le projet.
i m p o r tF i l e ( )
« Méthode Project importFile() »,
page 113
Importe un fichier dans le projet.
i m p o r tF i l e Wi t h D i a l o g ()
« Méthode Project
importFileWithDialog() », page 113
Affiche une boîte de dialogue Importer fichier.
s h ow Win dow( )
« Méthode Project showWindow() »,
page 117
Affiche ou masque le panneau Projet.
a utoF i xE x pres si o n s ()
« Méthode Project
autoFixExpressions() », page 111
Remplace automatiquement le texte dans
toutes les expressions.
Attribut Project activeItem
a pp. pro je c t .a c t iveItem
Description
Elément actuellement actif et devant être soumis à une action, ou valeur nulle si aucun élément n’est
actuellement sélectionné ou si plusieurs éléments sont sélectionnés.
Type
Objet Item ou nul ; lecture seule.
Méthode Project autoFixExpressions()
a pp. pro je c t .a utoF i xE x pres si on s (old Te x t, n e wTe x t)
Description
Remplace automatiquement le texte des expressions rompues du projet, si le nouveau texte provoque
l’évaluation sans erreur de l’expression.
Paramètres
o l d Te x t
Texte à remplacer.
n e w Te x t
Nouveau texte.
Renvoi
Aucun.
111
Référence JavaScript
Objet Project
112
Attribut Project bitsPerChannel
a pp. pro je c t .b i ts PerC han n el
Description
Codage des couleurs du projet en cours, soit 8, 16 ou 32 bits.
Type
Entier (8, 16 ou 32 uniquement) ; lecture/écriture.
Méthode Project close()
a pp. pro je c t .cl o se( c lo s e O p t i on s )
Description
Ferme le projet avec possibilité de sauvegarder les modifications automatiquement, en invitant l’utilisateur à
sauvegarder les modifications ou à fermer sans sauvegarder.
Paramètres
CloseOptions
Action à exécuter à la fermeture. Valeur énumérée C lo se O p t i o n s ; l’une des suivantes :
C l o s e O p t i o n s . D O _ N OT _ SAV E _ C H A N G E S : ferme sans enregistrer.
C l o s e O p t i o n s . PRO M P T _ TO _ S AV E _ C H A N G E S : demande de confirmer
l’enregistrement des modifications avant la fermeture.
C l o s e O p t i o n s . SAV E _ C H A N G E S : enregistre automatiquement à la fermeture.
Renvoi
Booléen. True une fois l’action exécutée. False si le fichier n’a pas été enregistré auparavant, qu’une boîte de
dialogue d’enregistrement s’affiche et que l’utilisateur annule l’enregistrement.
Méthode Project consolidateFootage()
a pp. pro je c t .con s ol i d ate Fo ot ag e( )
Description
Consolide tout le métrage du projet. Equivalent de la commande Fichier > Consolider tout le métrage.
Paramètres
Aucun.
Renvoi
Entier ; nombre total d’éléments de métrage supprimés.
112
Référence JavaScript
Objet Project
113
Attribut Project displayStartFrame
a pp. pro je c t .d i sp l ay S ta r t Fr a m e
Description
Image à partir de laquelle commence la numérotation lors de l’affichage du projet avec une valeur
t i m e cod eD i sp l ay Ty p e de Ti m e code D is p l ay Ty p e.F R A M E S . (Voir la section « Attribut Project
timecodeDisplayType », page 118.) Equivalent au paramètre « Commencer à numéroter les images à : »
dans Paramètres du projet > Style d’affichage.
Type
Entier ; lecture/écriture.
Attribut Project file
a pp. pro je c t .f i le
Description
Objet ExtendScript File du fichier contenant le projet actuellement ouvert.
Type
Objet File ou valeur nulle si le projet n’a pas été enregistré ; lecture seule.
Méthode Project importFile()
a pp. pro je c t .i m p or tF i l e( i m p o r t O p t io n s )
Description
Importe le fichier spécifié dans l’objet ImportOptions indiqué à l’aide des options spécifiées. Equivaut à la
commande Fichier > Importer fichier. Crée et renvoie un nouvel objet FootageItem à partir du fichier et
l’ajoute au tableau des éléments Item du projet.
Paramètres
Im p or tO p t i on s
Objet ImportOptions indiquant le fichier à importer ainsi que les options de cette opération. Voir la
section « Objet ImportOptions », page 73.
Renvoi
Objet FootageItem.
Exemple
a pp. pro je c t . i m p o r tF i l e ( n e w Im p or tO p t i o n s (F i l e ( “sa m pl e . p sd ” ) )
Méthode Project importFileWithDialog()
a pp. pro je c t .i m p o r tF i l eWi t hD i al o g ()
Description
Affiche une boîte de dialogue Importer fichier. Equivalent de la commande Fichier > Importer > Fichier.
Renvoi
Tableau d’objets Item créé lors d’une importation ; valeur nulle si l’utilisateur annule la boîte de dialogue.
113
Référence JavaScript
Objet Project
114
Méthode Project importPlaceholder()
a pp. pro je c t .i m p or tP l aceho ld er( na m e , w idt h , h e ig ht , f ra m eR a te , du ra t io n )
Description
Crée et renvoie un nouvel objet PlaceholderItem et l’ajoute au tableau des éléments Item du projet. Equivaut
à la commande Fichier > Importer > Pseudo-élément.
Paramètres
name
Chaîne contenant le nom du pseudo-élément.
w i dt h
Largeur du pseudo-élément, en pixels. Nombre entier compris dans la plage [4..30000].
h eig h t
Hauteur du pseudo-élément, en pixels. Nombre entier compris dans la plage [4..30000].
f r a m eRa te
Cadence du pseudo-élément. Valeur à virgule flottante comprise dans la plage [1.0..99.0].
du r at i on
Durée du pseudo-élément, en secondes. Valeur à virgule flottante comprise dans la plage [0.0..10800.0].
Renvoi
Objet PlaceholderItem.
Méthode Project item()
a pp. pro je c t .i tem ( i n d e x)
Description
Extrait un objet à la position d’index indiquée.
Paramètres
i n dex
Position d’index d’un élément, entier. Le premier élément se situe à l’index 1.
Renvoi
Objet Item.
Attribut Project items
a pp. pro je c t .i tem s
Description
Tous les éléments du projet.
Type
Objet ItemCollection ; lecture seule.
Attribut Project linearBlending
a pp. pro je c t .l i n ea rBl en di n g
Description
True si la fusion linéaire s’applique à ce projet ; sinon false.
Type
Booléen ; lecture/écriture.
114
Référence JavaScript
Objet Project
115
Attribut Project numItems
a pp. pro je c t .nu m Item s
Description
Nombre total d’éléments contenus dans le projet, y compris les dossiers et tous les types de métrage.
Type
Entier ; lecture seule.
Exemple
n = a p p.p ro j e c t . num Item s ;
a l er t ( " T h e re a re " + n + " i te m s i n t h is p ro j e c t . " )
Méthode Project reduceProject()
a pp. pro je c t .red uce Proje c t( a r ray _ of _ i t e m s )
Description
Supprime tous les éléments du projet à l’exception des éléments spécifiés. Equivalent de la commande
Fichier > Réduire le projet.
Paramètres
a r r ay _ of _ i tem s
Tableau contenant les objets Item à conserver.
Renvoi
Entier ; nombre total d’éléments supprimés.
Exemple
v ar theItems = ne w Ar r ay();
t heItems[t he Item s.leng th] = app.proj ec t. item(1 );
t heItems[t he Item s.leng th] = app.proj ec t. item(3 );
a pp. pro je c t .red uce Proje c t( th eItems) ;
Méthode Project removeUnusedFootage()
a pp. pro je c t .rem oveUnu se d Fo ota g e( )
Description
Supprime tout métrage non utilisé du projet. Equivalent de la commande Fichier > Supprimer le métrage
inutilisé.
Paramètres
Aucun.
Renvoi
Entier ; nombre total d’objets FootageItem supprimés.
115
Référence JavaScript
Objet Project
116
Attribut Project renderQueue
a pp. pro je c t .renderQ ueue
Description
File d’attente de rendu du projet.
Type
Objet RenderQueue ; lecture seule.
Attribut Project rootFolder
a pp. pro je c t.rootFo lder
Description
Dossier racine contenant l’ensemble du projet ; il s’agit d’un dossier virtuel qui contient tous les éléments du
panneau Projet, mais pas les éléments d’autres dossiers de ce même panneau.
Type
Objet FolderItem ; lecture seule.
Méthode Project save()
a pp. pro je c t .s ave( )
a pp. pro je c t .s ave( file )
Description
Enregistre le projet. Equivaut à la commande Fichier > Enregistrer ou Fichier > Enregistrer sous. Si le projet
n’a jamais été enregistré et qu’aucun fichier n’est spécifié, l’utilisateur doit indiquer l’emplacement et le nom
du fichier. Spécifiez un objet File pour enregistrer un projet dans un nouveau fichier sans confirmation de
l’utilisateur.
Paramètres
file
Facultatif. Objet ExtendScript File du fichier à enregistrer.
Renvoi
Aucun.
Méthode Project saveWithDialog()
a pp. pro je c t .s aveWi th Di a l og ( )
Description
Affiche la boîte de dialogue Enregistrer. L’utilisateur peut indiquer un fichier avec un emplacement pour
enregistrer le projet, ou cliquer sur Annuler pour fermer la boîte de dialogue.
Paramètres
Aucun.
Renvoi
Booléen ; true si le projet a été enregistré.
116
Référence JavaScript
Objet Project
117
Attribut Project selection
a pp. pro je c t .s el e c t i on
Description
Tous les éléments sélectionnés dans le panneau Projet, triés comme dans ce panneau.
Type
Tableau d’objets Item ; lecture seule.
Méthode Project showWindow()
a pp. pro je c t .s how Win dow( d oSh ow )
Description
Affiche ou masque le panneau Projet.
Paramètres
doS h ow
Lorsque ce paramètre est défini sur true, affiche le panneau Projet. Lorsqu’il est défini sur false, masque le
panneau Projet.
Renvoi
Aucun.
Attribut Project timecodeBaseType
a pp. pro je c t .t i m e cod e B as e Ty p e
Description
Option Base du code temporel, telle que définie dans la boîte de dialogue Paramètres du projet.
Type
Valeur énumérée Ti m e cod e B as e Ty p e ; écriture/lecture. L’une des suivantes :
Tim eco de Ba s eTy p e.AU TO
Tim eco de Ba s eTy p e.F P S 24
Tim eco de Ba s eTy p e.F P S 25
Tim eco de Ba s eTy p e.F P S 30
Tim eco de Ba s eTy p e.F P S 48
Tim eco de Ba s eTy p e.F P S 50
Tim eco de Ba s eTy p e.F P S 60
Tim eco de Ba seTy p e.FPS100
117
Référence JavaScript
Objet Project
118
Attribut Project timecodeDisplayType
a pp. pro je c t .t i m e cod eD i sp l ay Ty p e
Description
Mode d’affichage du code temporel, tel que défini dans la boîte de dialogue Paramètres du projet.
Type
Valeur énumérée Ti m e cod eD i sp l ay Ty p e ; lecture/écriture. L’une des suivantes :
Tim e co de Di s p l ay Ty p e .T I M E C O DE
Tim e co de Di s p l ay Ty p e .F R A M E S
Tim e co de Di s p l ay Ty p e .F E E T _ A N D_ F R A M E S
Attribut Project timecodeFilmType
a pp. pro je c t .t i m e cod eF i l m Ty p e
Description
Type de film, tel que défini dans l’option Pieds + images de la boîte de dialogue Paramètres du projet.
Type
Valeur énumérée Ti m e cod eF i l m Ty p e ; lecture/écriture. L’une des suivantes :
Tim eco de F il m Ty p e .MM 16
Tim eco de F il m Ty p e .MM 35
Attribut Project timecodeNTSCDropFrame
a pp. pro je c t .t i m e cod eN TS C D ro pFr am e
Description
Mode d’affichage du code temporel pour le métrage à 29,97 i/s, tel que défini sous NTSC dans la boîte de
dialogue Paramètres du projet.
Type
Booléen, true pour l’option Image compensée, false pour l’option Image non compensée ; lecture/écriture.
Attribut Project transparencyGridThumbnails
a pp. pro je c t .t r an s p aren c y Gr i d T hu m bn ai l s
Description
Lorsque cet attribut est défini sur true, les vignettes utilisent le motif de damier de transparence.
Type
Booléen ; lecture/écriture.
118
Référence JavaScript
Objet Property
119
Objet Property
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). prop e r t y Sp ec
Description
L’objet Property contient des informations (valeur, image clé et expression) relatives à une propriété AE
particulière d’un calque. La propriété AE est une valeur, souvent animable, d’un effet, d’un masque ou d’une
transformation dans un calque individuel. Pour des exemples d’accès aux propriétés, reportez-vous aux
sections « Objet PropertyBase », page 141 et « Méthode PropertyGroup property() », page 150.
• PropertyGroup est une sous-classe de PropertyBase. Toutes les méthodes et tous les attributs de
PropertyBase, outre ceux énumérés ci-dessous, sont disponibles lorsque vous utilisez PropertyGroup.
Voir la section « Objet PropertyBase », page 141.
REMARQUE : les objets JavaScript, appelés couramment « propriétés », sont appelés « attributs » dans ce guide
pour éviter toute confusion avec la définition du mot « propriété » dans After Effets.
Attributs
Attribut
Référence
Description
prop er t y Va lue Ty p e
« Attribut Property
propertyValueType », page 132
Type de valeur stocké dans cette propriété.
v alu e
« Attribut Property value », page 139
Valeur actuelle de la propriété.
h as Mi n
« Attribut Property hasMin », page 125
Lorsque cet attribut est défini sur true, il existe une
valeur minimale autorisée.
h as Max
« Attribut Property hasMax », page 124
Lorsque cet attribut est défini sur true, il existe une
valeur maximale autorisée.
m i n Va lu e
« Attribut Property minValue »,
page 131
Valeur minimale autorisée.
m a x Va lu e
« Attribut Property maxValue »,
page 131
Valeur maximale autorisée.
i s Sp a t i a l
« Attribut Property isSpatial », page 125
Lorsque cet attribut est défini sur true, la propriété
définit une valeur spatiale.
can Var yOverTime
« Attribut Property canVaryOverTime »,
page 123
Lorsque cet attribut est défini sur true, la propriété
peut être appliquée à une image clé.
i s Ti m e Va r y i n g
« Attribut Property isTimeVarying »,
page 125
Lorsque cet attribut est défini sur true, la propriété
dispose d’images clés ou d’une expression activée
faisant varier ses valeurs.
nu m Ke y s
« Attribut Property numKeys », page 132 Nombre d’images clés sur cette propriété.
un it sTex t
« Attribut Property unitsText », page 139 Texte décrivant les unités dans lesquelles la valeur
est exprimée.
e xp re ss i o n
« Attribut Property expression »,
page 124
Chaîne d’expression pour cette propriété.
can S et Ex pression
« Attribut Property canSetExpression »,
page 123
Lorsque cet attribut est défini sur true, l’expression
peut être définie par un script.
e xp re ss i o n E n ab l e d
« Attribut Property
expressionEnabled », page 124
Lorsque cet attribut est défini sur true, l’expression
est utilisée pour générer des valeurs pour la
propriété.
e xp re ss i o n E r ror
« Attribut Property expressionError »,
page 124
Erreur qui s’est éventuellement produite lors de
l’évaluation de la dernière expression.
119
Référence JavaScript
Objet Property
120
Attribut
Référence
Description
s e l e c te d Ke y s
« Attribut Property selectedKeys »,
page 133
Toutes les images clés de la propriété.
prop er t y Index
« Attribut Property propertyIndex »,
page 132
Index de position de cette propriété.
Méthodes
Méthode
Référence
Description
v alu eAt Time()
« Méthode Property valueAtTime() »,
page 140
Prend la valeur de la propriété évaluée à
un instant donné.
s e tVal u e ( )
« Méthode Property setValue() », page 138
Définit la valeur statique de la propriété.
s e tVal u e AtTi m e ( )
« Méthode Property setValueAtTime() »,
page 138
Crée une image clé pour la propriété.
s e tVal u e s At Ti m e s( )
« Méthode Property setValuesAtTimes() »,
page 139
Crée un ensemble d’images clés pour la
propriété.
s e tVal u e AtKe y( )
« Méthode Property setValueAtKey() »,
page 138
Recherche une image clé et attribue la
valeur de la propriété à celle-ci.
ne arestKe y In dex()
« Méthode Property nearestKeyIndex() »,
page 131
Prend l’image clé la plus proche du
moment spécifié.
ke y Ti m e( )
« Méthode Property keyTime() », page 130
Prend la valeur du moment où la
condition est remplie.
ke y Valu e( )
« Méthode Property keyValue() », page 130
Prend la valeur d’une image clé au
moment où la condition est remplie.
a d dKe y ()
« Méthode Property addKey() », page 123
Ajoute une nouvelle image clé à la
propriété à un moment donné.
rem oveKe y ( )
« Méthode Property removeKey() »,
page 133
Supprime une image clé de la propriété.
i s In ter p o l a t i o n Ty p e Va l i d ()
« Méthode Property
isInterpolationTypeValid() », page 125
Lorsque cette méthode est définie sur
true, la propriété peut être interpolée.
s e tIn te r p o l at i o n Ty p e AtKe y( )
« Méthode Property
setInterpolationTypeAtKey() », page 134
Définit le type d’interpolation pour une
clé.
ke y In In te r p o l at i o n Ty p e ()
« Méthode Property
keyInInterpolationType() », page 126
Attribue le type d’interpolation « in » à
une clé.
ke y Out In ter p ol at i on Ty p e( )
« Méthode Property
keyOutInterpolationType() », page 127
Attribue le type d’interpolation « out » à
une clé.
s e tS pa t i alTa ngen ts At Ke y( )
« Méthode Property
setSpatialTangentsAtKey() », page 136
Définit les vecteurs de tangente « in » et
« out » pour une clé.
ke y In Sp at i a lTan g en t ()
« Méthode Property keyInSpatialTangent() », Attribue la tangente spatiale « in » à
page 126
une clé.
ke y Out Sp a ti a l Tan g en t ()
« Méthode Property
keyOutSpatialTangent() », page 127
Attribue la tangente spatiale « out » à
une clé.
s e tTemp or alEa se AtKe y ()
« Méthode Property
setTemporalEaseAtKey() », page 137
Définit le lissage temporel « in » et
« out » pour une clé.
ke y In Te m p o r a l E a s e ( )
« Méthode Property keyInTemporalEase() »,
page 126
Attribue le lissage temporel « in » à une
clé.
120
Référence JavaScript
Objet Property
121
Méthode
Référence
Description
ke y Out Tem p or a l E as e( )
« Méthode Property
keyOutTemporalEase() », page 128
Attribue le lissage temporel « out » à
une clé.
se tTemp or alContinuou sAtKe y ()
« Méthode Property
setTemporalContinuousAtKey() », page 137
Définit si l’image clé est dotée d’une
continuité temporelle.
ke y Te m p o r a l Co n t i n u o u s ( )
« Méthode Property
keyTemporalContinuous() », page 130
Indique si l’image clé est dotée d’une
continuité temporelle.
s e t Te m p or al Au to B e z i e r At Ke y( )
« Méthode Property
setTemporalAutoBezierAtKey() », page 136
Définit si l’image clé est dotée du mode
Bézier automatique temporel.
ke y Te m p o r a l Au t o B e z i e r ( )
« Méthode Property
keyTemporalAutoBezier() », page 129
Indique si l’image clé est dotée du
mode Bézier automatique temporel.
s e tS pa t i al Con t i nu o u sAtKe y( )
« Méthode Property
setSpatialContinuousAtKey() », page 135
Définit si l’image clé est dotée d’une
continuité spatiale.
ke y Sp a ti a l Con t inu ous ( )
« Méthode Property
keySpatialContinuous() », page 129
Indique si l’image clé est dotée d’une
continuité spatiale.
s e tS pa t i al AutoB e z i e r AtKe y
« Méthode Property
setSpatialAutoBezierAtKey() », page 135
Définit si l’image clé est dotée du mode
Bézier automatique spatial.
ke ySp a ti a l AutoB ezi er( )
« Méthode Property
keySpatialAutoBezier() », page 129
Indique si l’image clé est dotée du
mode Bézier automatique spatial.
s e tRov i n g At Ke y ( )
« Méthode Property setRovingAtKey() »,
page 134
Définit si l’image clé est itinérante.
ke y Rov i n g ()
« Méthode Property keyRoving() », page 128 Indique si l’image clé est itinérante.
s e tS e l ec te dAtKe y( )
« Méthode Property setSelectedAtKey() »,
page 135
Spécifie si une image clé est
sélectionnée.
ke y S el e c ted ( )
« Méthode Property keySelected() »,
page 128
Indique si une image clé est
sélectionnée.
Exemple : obtention et définition de la valeur d’opacité
v ar my Prop er t y = my L ayer. op a c it y ;
//opa cit y ha s proper t yVa lue Ty p e of O n eD, a n d is store d as a flo at
my Prop er t y. s e t Val u e ( 0 . 5 ) ;
// Va r i able my O p acit y is a f l oa t v alu e
v ar my O pa c i t y = my Prop er t y.v al ue;
Exemple : obtention et définition de la valeur d’une position
v ar my Prop er t y = my L ayer. p o s it i o n ;
/ / p o s i t i on h as p rop e r t y Va l u e Ty p e o f T h re e D _ S PAT I AL , a n d i s store d a s a n ar r ay of 3 f l o at s
my Prop er t y.set Value([10. 0, 30 .0, 0.0 ]) ;
/ / Va r i a b l e my Pos i t io n i s a n a r r ay o f 3 f l o at s
v ar my Pos i t i o n = my Pro p e r t y. va l u e ;
Exemple : redéfinition de la valeur d’une forme de masque de fermée à ouverte
v ar my Mas k = my l ayer. m as k( 1) ;
v ar my Prop er t y = my Ma sk .m as kPa th ;
my Sh ap e = my Prop er t y.v alu e;
my Sh ap e.clo se d = false;
my Prop er t y. s e t Val u e ( myS h a p e );
121
Référence JavaScript
Objet Property
122
Exemple : obtention de la valeur d’une couleur à un instant donné
Une couleur est stockée en tant que tableau de quatre valeurs à virgule flottante (r, v, b, opacity). Le script
suivant définit la valeur de la composante rouge (red) d’une couleur de lumière à l’instant 4 à la moitié de celle
de l’instant 2 :
v ar my Prop er t y = my L i g ht .col or ;
v ar co lor Valu e = my Prop er t y.v alu eAt Ti me (2 ,t r u e) ;
co lor Valu e[0 ] = 0. 5 * col orVa lue[ 0] ;
my Prop er t y.set ValueAtTime(4,co lor Valu e);
Exemple : procédure de vérification qu’une échelle calculée par une expression à l’instant 3,5 est la valeur attendue
de [10,50]
v ar my Prop er t y = my L ayer. sc a l e;
// false va lue of preExpression mea n s e va lua te t he expre ssion
v ar s c aleVa lue = my Prop er t y.v alu eAt Ti me (3. 5,f als e) ;
i f ( s c a l e Va lue [0 ] = = 1 0 & & s c a l e Va l u e [ 1 ] = = 5 0 ) {
a l er t( " hur r ay " ) ;
}
e l se {
a l er t( " o op s " );
}
Exemple : application d’une image clé à une rotation de 0 à 90 et retour
L’animation dure 10 secondes, et l’image clé centrale se situe au repère 5 secondes. Les propriétés de rotation
sont stockées sous la forme d’une valeur OneD.
my Prop er t y = my L ayer. rot at i o n ;
my Prop er t y.set ValueAtTime(0, 0 );
my Prop er t y.set ValueAtTime(5, 9 0);
my Prop er t y.set ValueAtTime(10, 0);
Exemple : modification des valeurs des images clés pour les trois premières images clés d’un texte source
my Prop er t y = my Tex tL ayer. so u rceTex t;
i f ( my Prop er t y.nu m Ke y s < 3 ) {
a l er t("er ror, I thoug h t there were 3 ke y f r a mes");
}
e l se {
my Prop er t y. s e t Val u e At Ke y( 1 , n e w Tex t D oc u m en t ( " ke y nu m b e r 1 " ) ) ;
my Prop er t y. s e t Val u e At Ke y( 2 , n e w Tex t D oc u m en t ( " ke y nu m b e r 2 " ) ) ;
my Prop er t y. s e t Val u e At Ke y( 3 , n e w Tex t D oc u m en t ( " ke y nu m b e r 3 " ) ) ;
}
Exemple : définition des valeurs à l’aide de la syntaxe de commodité pour la position, la mise à l’échelle, la couleur ou
le texte source
// Th ese t wo are e quiva lent . T he secon d fills in a defau l t of 0.
my Layer.po sit i on.set Valu e([2 0, 3 0, 0]);
my Layer.po sit i on.set Valu e([2 0, 3 0]);
// Th ese t wo are e quiva lent . T he secon d fills in a defau l t of 100 .
my Layer.scale. se t Valu e([5 0, 50 , 10 0]);
my Layer.s c ale. se t Valu e( [5 0, 50 ]) ;
// Th ese t wo are e quiva lent . T he secon d fills in a defau l t of 1.0
122
Référence JavaScript
Objet Property
123
my Lig h t.color. se t Valu e([ .8 , .3 , .1 , 1, 0]) ;
my Lig h t.color. se t Valu e([ .8 , .3 , .1 ]) ;
// Th ese t wo are e quiva lent . T he secon d crea tes a TextD o cument
my Tex t L ayer.s ourceText .s e tVa lue( n ew Tex tD o c um en t( " fo o" ) );
my Tex t L ayer.s ourceText .s e tVa lue( " fo o" ) ;
Méthode Property addKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .a dd Ke y( t i m e)
Description
Ajoute une nouvelle image clé ou un nouveau repère à la propriété nommée à l’instant donné et renvoie
l’index de la nouvelle image clé.
Paramètres
time
Moment, en secondes, où ajouter l’image clé. Valeur à virgule flottante. Le début de la composition est 0.
Renvoi
Entier ; index de la nouvelle image clé ou du nouveau repère.
Attribut Property canSetExpression
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec . c a n S e t Ex pres si o n
Description
Lorsque cet attribut est défini sur true, le type de la propriété nommée est celui dont l’expression peut être
définie par un script. Voir aussi la section « Attribut Property expression », page 124.
Type
Booléen ; lecture seule.
Attribut Property canVaryOverTime
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .canVa r yO verTim e
Description
Lorsque cet attribut est défini sur true, la propriété nommée peut varier en fonction du temps. C’est-à-dire
que les valeurs d’image clé ou d’expression peuvent être écrites dans cette propriété.
Type
Booléen ; lecture seule.
123
Référence JavaScript
Objet Property
124
Attribut Property expression
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ex pres s io n
Description
Expression pour la propriété nommée. En écriture seule si la valeur c anS e t Ex pres si on de la propriété nommée
est true. La chaîne est évaluée si vous spécifiez une valeur pour cet attribut.
• Si la chaîne contient une expression valide, la valeur de ex pre s s io n E n ab l e d devient true.
• Si la chaîne ne contient pas d’expression valide, une erreur est générée et la valeur attribuée à
expressionEna ble d est false.
• Si la chaîne de l’attribut est vide, la valeur de e xp re ss i o n E n ab l e est false, mais aucune erreur n’est générée.
Type
Chaîne ; en lecture/écriture si la valeur c an S e t Ex pre s s io n de la propriété nommée est true.
Attribut Property expressionEnabled
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ex pres s io n E n ab l e d
Description
Lorsque cet attribut est défini sur true, la propriété nommée utilise l’expression associée pour générer une
valeur. Si la valeur est false, les informations de l’image clé ou la valeur statique de la propriété sont utilisées.
La valeur de cet attribut peut être true uniquement si la valeur true est attribuée à l’expression
can S et Ex pression de la propriété nommée et que l’expression contient une chaîne d’expression valide.
Type
Booléen ; lecture/écriture.
Attribut Property expressionError
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ex pres s ion E r ror
Description
Contient l’erreur éventuellement générée par l’évaluation de la chaîne la plus récemment définie dans
l’ex pre s s io n . Si aucune chaîne d’expression n’a été spécifiée ou si la dernière chaîne d’expression a été évaluée
sans erreur, l’attribut contient la chaîne vide ("").
Type
Chaîne ; lecture seule.
Attribut Property hasMax
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ha sMa x
Description
Lorsque cet attribut est défini sur true, il existe une valeur maximale autorisée pour la propriété nommée ;
sinon, la valeur est false.
Type
Booléen ; lecture seule.
124
Référence JavaScript
Objet Property
125
Attribut Property hasMin
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ha sMin
Description
Lorsque cet attribut est défini sur true, il existe une valeur minimale autorisée pour la propriété nommée ;
sinon, la valeur est false.
Type
Booléen ; lecture seule.
Méthode Property isInterpolationTypeValid()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .i sIn te r p o l a t io n Ty p e Val i d( t y p e )
Description
Renvoie true si la propriété nommée peut être interpolée à l’aide du type d’interpolation d’image clé spécifié.
Paramètres
type
Valeur énumérée Ke y fr am e In ter p o l at i on Ty p e ; l’une des suivantes :
Ke y fr am eIn ter p o l at i on Ty p e .L I N E A R
Ke y fr am e In t e r p o l a t i on Ty p e .B E Z I E R
Ke y fr am eIn ter p o l at i on Ty p e .H OL D
Renvoi
Booléen.
Attribut Property isSpatial
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .isSp at i al
Description
Lorsque cet attribut est défini sur true, la propriété nommée définit une valeur spatiale. Il s’agit par exemple
des réglages de position et de point d’effet.
Type
Booléen ; lecture seule.
Attribut Property isTimeVarying
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .isTimeVa r y i ng
Description
Lorsque cet attribut est défini sur true, la propriété nommée varie dans le temps (c’est-à-dire qu’elle comporte
des images clés ou une expression activée). Si la valeur de isTimeVarying est true, celle de l’attribut
can Var yOverTime doit également être true.
Type
Booléen ; lecture seule.
125
Référence JavaScript
Objet Property
126
Méthode Property keyInInterpolationType()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y In In ter p ol a t ion Ty p e( ke y In d e x)
Description
Renvoie le type d’interpolation « in » pour l’image clé spécifiée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
n e a re s t Ke y In d e x .
Renvoi
Valeur énumérée Ke y f r am eIn ter p ol at i on Ty p e ; l’une des suivantes :
Ke y fr am eIn ter p o la t i on Ty p e .L I N E A R
Ke y fr ameIn ter p o la t ion Ty p e .BE ZIER
Ke y fr am eIn ter p o la t i on Ty p e .H OL D
Méthode Property keyInSpatialTangent()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y In Sp at ialTa n gent( ke y In d e x)
Description
Renvoie la tangente spatiale d’approche pour l’image clé spécifiée, si la propriété nommée est spatiale
(c’est-à-dire si la valeur est du type TwoD _ SPAT I AL ou T h re e D _ SPAT I A L ).
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
n e a re s t Ke y In d e x .
Renvoi
Tableau de valeurs à virgule flottante :
• Si la valeur de la propriété est de type Proper t y Valu eTy p e.TwoD _SPAT I AL , le tableau contient 2 valeurs à
virgule flottante.
• Si la valeur de la propriété est de type Prop er t y Va lueTy p e .Th re eD _SPATI AL , le tableau contient 3 valeurs
à virgule flottante.
• Si la valeur de la propriété n’est d’aucun de ces deux types, une exception est générée.
Méthode Property keyInTemporalEase()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y In Tem p or alEa se (k e y In d e x )
Description
Renvoie le lissage temporel d’approche pour l’image clé spécifiée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
126
Référence JavaScript
Objet Property
127
Renvoi
Tableau d’objets KeyframeEase :
• Si la valeur de la propriété est de type Proper t y Valu eTy p e.TwoD , le tableau contient 2 objets.
• Si la valeur de la propriété est de type Proper t y Valu eTy p e.T hree D , le tableau contient 3 objets.
• Pour tout autre type de valeur, le tableau contient 1 objet.
Méthode Property keyOutInterpolationType()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y O u tIn ter p o l a t i on Ty p e (k e y In d e x )
Description
Renvoie le type d’interpolation d’éloignement pour l’image clé spécifiée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
Renvoi
Valeur énumérée Ke y f r am eIn ter p ol at i on Ty p e ; l’une des suivantes :
Ke y fr am eIn ter p o la t i on Ty p e .L I N E A R
Ke y fr ameIn ter p o la t ion Ty p e .BE ZIER
Ke y fr am eIn ter p o la t i on Ty p e .H OL D
Méthode Property keyOutSpatialTangent()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y O utS p at i alTangent( ke y In d e x)
Description
Renvoie la tangente spatiale d’éloignement pour l’image clé spécifiée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
Renvoi
Tableau de valeurs à virgule flottante :
• Si la valeur de la propriété est de type Proper t y Valu eTy p e.TwoD _SPAT I AL , le tableau contient 2 valeurs à
virgule flottante.
• Si la valeur de la propriété est de type Prop er t y Va lueTy p e .Th re eD _SPATI AL , le tableau contient 3 valeurs
à virgule flottante.
• Si la valeur de la propriété n’est d’aucun de ces deux types, une exception est générée.
127
Référence JavaScript
Objet Property
128
Méthode Property keyOutTemporalEase()
a pp. pro je c t .i tem ( in d e x) .l ayer(i n de x ). prop e r t y Sp ec .ke y O utTempor alE ase( ke y In de x )
Description
Renvoie le lissage temporel d’éloignement pour l’image clé spécifiée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
Renvoi
Tableau d’objets KeyframeEase :
• Si la valeur de la propriété est de type Proper t y Valu eTy p e.TwoD , le tableau contient 2 objets.
• Si la valeur de la propriété est de type Proper t y Valu eTy p e.T hree D , le tableau contient 3 objets.
• Pour tout autre type de valeur, le tableau contient 1 objet.
Méthode Property keyRoving()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y Rov i ng( ke y In d e x)
Description
Renvoie la valeur true si l’image clé est itinérante. La première et la dernière image clé d’une propriété ne
peuvent pas être itinérantes ; si vous essayez de les rendre itinérantes, l’opération n’est pas prise en compte
et ke y Rov i n g ( ) renvoie toujours la valeur false.
Si le type de valeur de la propriété n’est ni Two D_ S PAT I AL ni T hree D_ S PAT I AL , une exception est générée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
Renvoi
Booléen.
Méthode Property keySelected()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y S e l ec te d (k e y In d e x )
Description
Renvoie la valeur true si l’image clé spécifiée est sélectionnée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
Renvoi
Booléen.
128
Référence JavaScript
Objet Property
129
Méthode Property keySpatialAutoBezier()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y S p at i al AutoB e z ier (k e y In d e x)
Description
Renvoie la valeur true si l’image clé spécifiée comporte une interpolation Bézier automatique spatiale.
(Ce type d’interpolation affecte cette image clé uniquement si la valeur true est aussi attribuée à
ke y Sp a ti a l Con t inu ous ( ke y In de x ) .)
Si le type de valeur de la propriété n’est ni Two D_ S PAT I AL ni T hree D_ S PAT I AL , une exception est générée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
Renvoi
Booléen.
Méthode Property keySpatialContinuous()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec . ke y S p a t i a l Co n t i nuo us (k e y In d e x )
Description
Renvoie la valeur true si l’image clé spécifiée est dotée d’une continuité spatiale.
Si le type de valeur de la propriété n’est ni Two D_ S PAT I AL ni T hree D_ S PAT I AL , une exception est générée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
Renvoi
Booléen.
Méthode Property keyTemporalAutoBezier()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y Temp or alAutoB e zier (ke yInd ex )
Description
Renvoie la valeur true si l’image clé spécifiée est dotée d’une interpolation Bézier automatique temporelle.
L’interpolation Bézier automatique temporelle affecte cette image clé uniquement si le type d’interpolation
d’image clé est Ke y f r a m eIn ter p ol a t ion Ty p e. BE Z I E R à la fois pour ke y In In te r p o l a t i o n Ty p e( keyIndex) et pour
ke y Out In ter p ol at i on Ty p e( keyIndex) .
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
Renvoi
Booléen.
129
Référence JavaScript
Objet Property
130
Méthode Property keyTemporalContinuous()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y Tem p o r a l Con t i nu ou s (ke yInd ex )
Description
Renvoie la valeur true si l’image clé spécifiée est dotée d’une continuité temporelle.
La continuité temporelle affecte cette image clé uniquement si le type d’interpolation d’image clé
est Ke y f r a m e In ter p o l a t ion Ty p e .B E Z I E R à la fois pour ke y In In te r p o l a t io n Ty p e ( keyIndex) et pour
ke y Out In ter p ol at i on Ty p e( keyIndex) .
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
Renvoi
Booléen.
Méthode Property keyTime()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y Ti me( ke y In de x )
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y Ti me( m a r ke rCo m m e nt)
Description
Recherche le repère ou l’image clé spécifié(e) et renvoie le moment auquel il/elle apparaît.
Si aucune image clé ou aucun repère ne correspond à l’argument, cette méthode génère une exception et une
erreur s’affiche.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode
a d dKe y ou n e a re s t Ke y In d e x .
m a r ke r Com m e n t
Chaîne de commentaire associée à un repère (voir la section « Attribut MarkerValue comment »,
page 99).
Renvoi
Valeur à virgule flottante.
Méthode Property keyValue()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y Va lue (ke yInd ex )
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .ke y Va lue (m a r k e r Com m e n t )
Description
Recherche le repère ou l’image clé spécifié(e) et renvoie sa valeur actuelle.
Si aucune image clé ou aucun repère ne correspond à l’argument, cette méthode génère une exception et une
erreur s’affiche.
130
Référence JavaScript
Objet Property
131
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode
a d dKe y ou n e a re s t Ke y In d e x .
m a r ke r Com m e n t
Chaîne de commentaire associée à un repère (voir la section « Attribut MarkerValue comment »,
page 99).
Renvoi
Valeur à virgule flottante.
Attribut Property maxValue
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .maxVa lue
Description
Valeur maximale autorisée pour la propriété nommée. Si l’attribut ha sMax est false, une exception se produit
et une erreur est générée.
Type
Valeur à virgule flottante ; lecture seule.
Attribut Property minValue
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec . m i n Val u e
Description
Valeur minimale autorisée pour la propriété nommée. Si l’attribut ha sMin est false, une exception se produit
et une erreur est générée.
Type
Valeur à virgule flottante ; lecture seule.
Méthode Property nearestKeyIndex()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .nea re st Ke yIndex( t i m e)
Description
Renvoie l’index de l’image clé la plus proche de l’instant spécifié.
Paramètres
time
Temps, en secondes ; valeur à virgule flottante. Le début de la composition est 0.
Renvoi
Entier.
131
Référence JavaScript
Objet Property
132
Attribut Property numKeys
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .numKe ys
Description
Nombre d’images clés dans la propriété nommée. Si la valeur est 0, la propriété ne contient pas d’images clés.
Type
Entier ; lecture seule.
Attribut Property propertyIndex
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .prop er t yIndex
Description
Index de position de la propriété nommée. La première propriété se trouve à la position d’index 1.
Type
Entier ; lecture seule.
Attribut Property propertyValueType
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .prop e r t y Val u e Ty p e
Description
Type de valeur stocké dans la propriété nommée. L’énumération Proper t y Valu eTy p e possède une valeur pour
chaque type de données pouvant être stockées dans une propriété et en être extraites. Chaque type de données
est stocké et extrait dans une structure de type différent. Tous les objets de propriété stockent les données dans
l’une de ces catégories.
Par exemple, une propriété spatiale 3D (telle qu’une position de calque) est stockée en tant que tableau de trois
valeurs à virgule flottante. Lors de la définition d’une valeur pour la position, utilisez un tableau de ce type :
my l ayer. pro p e r t y (" p o si t i o n " ). se t Valu e ([ 1 0 ,2 0 ,0] ) ;
En revanche, une propriété de forme (telle que la forme de masque d’un calque) est stockée en tant qu’objet
Shape. Lors de la définition d’une valeur pour une forme, utilisez un objet Shape, comme suit :
v ar my Sh ap e = n ew S h ap e () ;
my Sh ap e.ver t ices = [[0,0 ],[0 1 00],[10 0 100 ], [1 00, 0]];
v ar my Mas k = my l ayer. pro p e r t y (" A DB E Mas k Par a de " ). prop e r t y (1 );
my Mas k .prop er t y ( " A DB E Ma sk S h ap e " ) .s e t Val u e ( myS h ap e );
Type
Valeur énumérée Prop er t y ValueTy p e ; lecture/écriture. L’une des suivantes :
E
Proper t y Valu eTy p e.NO _VA LUE
Ne stocke aucune donnée.
Proper t y Valu eTy p e.T hree D_SPATIAL
Tableau de trois valeurs à virgule flottante positionnelles. Exemple de
valeur d’un point d’ancrage : [10.0, 20.2, 0.0].
Proper t y Valu eTy p e.T hree D
Tableau de trois valeurs à virgule flottante quantitatives. Exemple de
valeur d’échelle : [100.0, 20.2, 0.0].
132
Référence JavaScript
Objet Property
133
Proper t y Valu eTy p e.TwoD _SPATI AL
Tableau de deux valeurs à virgule flottante positionnelles. Exemple de
valeur d’un point d’ancrage : [5.1, 10.0].
Proper t y Valu eTy p e.TwoD
Tableau de deux valeurs à virgule flottante quantitatives. Exemple de
valeur d’échelle : [5.1, 100.0].
Proper t y Valu eTy p e.O n eD
Valeur à virgule flottante.
Proper t y Valu eTy p e.CO LO R
Tableau de quatre valeurs à virgule flottante, comprises dans la plage
[0.0..1.0]. Par exemple : [0.8, 0.3, 0.1, 1.0]
Proper t y Valu eTy p e.CU STOM _VALU E
Type non disponible ; vous ne pouvez ni obtenir ni définir de valeurs pour
les propriétés avec ce type.
Proper t y Valu eTy p e.M ARKER
Objet MarkerValue ; voir la section « Objet MarkerValue », page 98.
Proper t y Valu eTy p e.LAY E R_IND E X
Entier ; la valeur 0 signifie aucun calque.
Proper t y Valu eTy p e.M ASK_INDEX
Entier ; la valeur 0 signifie aucun masque.
Proper t y Valu eTy p e.SH APE
Objet Shape ; voir la section « Objet Shape », page 166.
Proper t y Valu eTy p e.TE XT _D O C UM ENT
Objet TextDocument ; voir la section « Objet TextDocument », page 173.
Méthode Property removeKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .rem ove Ke y ( ke y In de x )
Description
Supprime l’image clé spécifiée de la propriété nommée. S’il n’existe aucune image clé avec l’index indiqué, cela
génère une exception et une erreur s’affiche.
Si une image clé est supprimée, les numéros d’index restants changent. Pour supprimer plusieurs images clés,
vous devez commencer par le numéro d’index le plus élevé afin de vous assurer que les index restants référencent
toujours les mêmes images clés après chaque suppression.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
Renvoi
Aucun.
Attribut Property selectedKeys
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se l e c te d Ke y s
Description
Index de toutes les images clés sélectionnées dans la propriété nommée. Si aucune image clé n’est sélectionnée
ou si la propriété ne comporte aucune image clé, un tableau vide est renvoyé.
Type
Tableau d’entiers ; lecture seule.
133
Référence JavaScript
Objet Property
134
Méthode Property setInterpolationTypeAtKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t In ter p ol at i on Ty p eAt Ke y ( ke y In de x , i nTy p e ,
ou tTy p e )
Description
Définit les types d’interpolation « in » et « out » pour l’image clé spécifiée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode
a d dKe y ou n ea re st Ke y In dex .
i n Ty p e
Type d’interpolation d’approche. Valeur énumérée Ke y f r a m eIn ter p ol a t ion Ty p e ; l’une
des suivantes :
Ke y fr am eIn ter p o l at i on Ty p e .L I N E A R
Ke y fr am e In t e r p o l a t i on Ty p e .B E Z I E R
Ke y fr am eIn ter p o l at i on Ty p e .H OL D
o u t Ty p e
(Facultatif ) Type d’interpolation d’éloignement. Si rien n’est indiqué, la valeur attribuée à
i n Ty p e est « out ». Valeur énumérée Ke y fr am e In ter p ol at i on Ty p e ; l’une des suivantes :
Ke y fr am eIn ter p o l at i on Ty p e .L I N E A R
Ke y fr am e In t e r p o l a t i on Ty p e .B E Z I E R
Ke y fr am eIn ter p o l at i on Ty p e .H OL D
Renvoi
Aucun.
Méthode Property setRovingAtKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t Rov i ngAt Ke y( ke y In de x , n e w Va l )
Description
Active ou désactive le mode itinérant pour l’image clé spécifiée. La première et la dernière image clé d’une
propriété ne peuvent pas être itinérantes ; si vous essayez de les rendre itinérantes, l’opération n’est pas prise
en compte et ke y Rov i n g ( ) renvoie toujours la valeur false.
Si le type de valeur de la propriété n’est ni Two D_ S PAT I AL ni T hree D_ S PAT I AL , une exception est générée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a d dKe y ou
n e a re s t Ke y In d ex .
newVal
True pour activer le mode itinérant, false pour le désactiver.
Renvoi
Aucun.
134
Référence JavaScript
Objet Property
135
Méthode Property setSelectedAtKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t Sele cted At Ke y( ke y In de x , o n O f f )
Description
Sélectionne ou désélectionne l’image clé spécifiée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
o n O ff
True pour sélectionner l’image clé, false pour la désélectionner.
Renvoi
Aucun.
Méthode Property setSpatialAutoBezierAtKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t Sp a t ia l AutoB ez i erAt Ke y ( ke y In dex , n ew Val )
Description
Active ou désactive l’interpolation Bézier automatique spatiale pour l’image clé spécifiée.
Si le type de valeur de la propriété n’est ni Two D_ S PAT I AL ni T hree D_ S PAT I AL , une exception est générée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
newVal
True pour activer l’interpolation Bézier automatique spatiale, false pour la désactiver.
Renvoi
Aucun.
Méthode Property setSpatialContinuousAtKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .s e t S p a t i a l Co n t i n u o u s At Ke y (ke y In de x, n e w Va l )
Description
Active ou désactive la continuité spatiale pour l’image clé spécifiée.
Si le type de valeur de la propriété n’est ni Two D_ S PAT I AL ni T hree D_ S PAT I AL , une exception est générée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
newVal
True pour activer la continuité spatiale, false pour la désactiver.
Renvoi
Aucun.
135
Référence JavaScript
Objet Property
136
Méthode Property setSpatialTangentsAtKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t Sp a t ia lTangent sAtKe y (k e y In d e x , i n Tan g e n t ,
ou tTa n ge n t )
Description
Définit les vecteurs de tangente d’approche et d’éloignement pour l’image clé spécifiée.
Si le type de valeur de la propriété n’est ni Two D_ S PAT I AL ni T hree D_ S PAT I AL , une exception est générée.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
i n Ta n g e n t
Vecteur de tangente d’approche. Tableau de 2 ou 3 valeurs à virgule flottante.
• Si la valeur de la propriété est de type Proper t y Valu eTy p e.TwoD _SPAT I AL , le tableau contient
2 valeurs.
• Si la valeur de la propriété est de type Prop er t y Va lue Ty p e .T h re eD _ SPAT I AL , le tableau contient
3 valeurs.
o u t Ta n gen t
(Facultatif ) Vecteur de tangente d’éloignement. Si rien n’est indiqué, la valeur attribuée à i n Tan g e n t est
« out ». Tableau de 2 ou 3 valeurs à virgule flottante.
• Si la valeur de la propriété est de type Proper t y Valu eTy p e.TwoD _SPAT I AL , le tableau contient
2 valeurs.
• Si la valeur de la propriété est de type Prop er t y Va lue Ty p e .T h re eD _ SPAT I AL , le tableau contient
3 valeurs.
Renvoi
Aucun.
Méthode Property setTemporalAutoBezierAtKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t Temp or a l AutoB ezierAt Ke y( ke y In de x, n e w Va l )
Description
Active ou désactive l’interpolation Bézier automatique temporelle pour l’image clé spécifiée. Lorsque cette
option est activée, elle affecte cette image clé uniquement si la valeur true est également attribuée à
ke y Sp a ti a l Con t inu ous ( keyIndex) .
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
newVal
True pour activer l’interpolation Bézier automatique temporelle, false pour la désactiver.
Renvoi
Aucun.
136
Référence JavaScript
Objet Property
137
Méthode Property setTemporalContinuousAtKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .s e t Tem p o r a l Con t i n u o u s At Ke y ( ke y In d e x , n e w Va l )
Description
Active ou désactive la continuité temporelle pour l’image clé spécifiée.
Si la continuité temporelle est activée, elle affecte cette image clé uniquement si le type d’interpolation d’image
clé est Ke y f r a m eIn ter p ol a t ion Ty p e. BE Z I E R à la fois pour ke y In In te r p o l a t i o n Ty p e ( keyIndex) et pour
ke y Out In ter p ol at i on Ty p e( keyIndex) .
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
newVal
True pour activer la continuité temporelle, false pour la désactiver.
Renvoi
Aucun.
Méthode Property setTemporalEaseAtKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t Temp or a l Eas eAtKe y( ke y In d e x , i n Te m p o ra l E a s e ,
ou tTe m p o ra lE as e )
Description
Définit le lissage temporel d’approche et d’éloignement pour l’image clé spécifiée. Voir la section « Objet
KeyframeEase », page 81.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode
a dd Ke y ou nearestKe y In dex .
i n Tem p or a l E a se
Lissage temporel d’approche. Tableau contenant 1, 2 ou 3 objets KeyframeEase.
• Si la valeur de la propriété est de type Prop er t y Va lueTy p e. Two D , le tableau contient 2 objets.
• Si la valeur de la propriété est de type Prop er t y Va lueTy p e. Th re eD , le tableau contient
3 objets.
• Pour tous les autres types de valeur, le tableau contient 1 objet.
o u t Te m p o r a l E a s e
(Facultatif ) Lissage temporel d’éloignement. Si rien n’est indiqué, la valeur attribuée à
i n Tem p o r a l E a s e est celle du lissage d’éloignement. Tableau contenant 1, 2 ou 3 objets
KeyframeEase.
• Si la valeur de la propriété est de type Prop er t y Va lueTy p e. Two D , le tableau contient 2 objets.
• Si la valeur de la propriété est de type Prop er t y Va lueTy p e. Th re eD , le tableau contient
3 objets.
• Pour tous les autres types de valeur, le tableau contient 1 objet.
Renvoi
Aucun.
137
Référence JavaScript
Objet Property
138
Méthode Property setValue()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t Valu e( n e w Va l u e )
Description
Définit la valeur statique d’une propriété n’ayant pas d’image clé.
Si la propriété nommée comporte des images clés, cette méthode génère une exception et une erreur est
affichée. Pour définir la valeur d’une propriété comportant des images clés, reportez-vous à la section
« Méthode Property setValueAtTime() », page 138 ou « Méthode Property setValueAtKey() », page 138.
Paramètres
n e w Va lu e
Valeur appropriée pour le type de propriété défini ; voir la section « Attribut Property propertyValueType »,
page 132.
Renvoi
Aucun.
Méthode Property setValueAtKey()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t Valu eAt Ke y ( ke y In d e x , n e w Va l u e )
Description
Recherche l’image clé spécifiée et définit sa valeur.
Si la propriété nommée ne comporte aucune image clé ou aucune image clé ayant l’index spécifié, cette
méthode génère une exception et une erreur s’affiche.
Paramètres
ke y In dex
Index de l’image clé. Entier compris dans la plage [1..numKeys], tel que renvoyé par la méthode a dd Ke y ou
nearestKe y In dex .
n e w Va lu e
Valeur appropriée pour le type de propriété défini ; voir la section « Attribut Property propertyValueType »,
page 132.
Renvoi
Aucun.
Méthode Property setValueAtTime()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t Valu eAt Ti m e (t im e , n e w Valu e)
Description
Définit la valeur d’une image clé au moment indiqué. Crée une nouvelle image clé pour la propriété nommée,
si elle n’existe pas déjà pour le moment indiqué, et en définit la valeur.
Paramètres
time
Temps, en secondes. Valeur à virgule flottante. Le début de la composition est 0.
n e w Va lu e
Valeur appropriée pour le type de propriété défini ; voir la section « Attribut Property
propertyValueType », page 132.
Renvoi
Aucun.
138
Référence JavaScript
Objet Property
139
Méthode Property setValuesAtTimes()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se t Valu es At Ti mes ( t im e s , n e w Va l u es)
Description
Définit les valeurs d’un ensemble d’images clés à des moments spécifiés. Crée une nouvelle image clé pour la
propriété nommée, si elle n’existe pas déjà pour un moment indiqué, et en définit la valeur.
Les moments et les valeurs sont exprimés sous forme de tableaux de longueur identique.
Paramètres
t i m es
Tableau de valeurs temporelles, en secondes. Chaque point temporel est une valeur à virgule
flottante. Le début de la composition est 0.
n e w Va lu e s
Tableau de valeurs appropriées pour le type de propriété défini ; voir la section « Attribut
Property propertyValueType », page 132.
Renvoi
Aucun.
Attribut Property unitsText
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec . u n i t sTex t
Description
Texte décrivant les unités dans lesquelles la valeur est exprimée.
Type
Chaîne ; lecture seule.
Attribut Property value
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .va lue
Description
Valeur de la propriété nommée à l’instant courant.
• Lorsque ex pres si onEna bl e d est true, la valeur de l’expression évaluée est renvoyée.
• S’il existe des images clés, la valeur de ces images à l’instant courant est renvoyée.
• Sinon, c’est une valeur statique qui est renvoyée.
Le type de valeur renvoyé dépend du type de valeur de la propriété. Voir les exemples pour « Objet Property »,
page 119.
Type
Valeur appropriée pour le type de propriété défini (voir la section « Attribut Property propertyValueType »,
page 132) ; lecture seule.
139
Référence JavaScript
Objet Property
140
Méthode Property valueAtTime()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .va lueAtTi me( t im e , p re E x pre s s i o n)
Description
Valeur de la propriété nommée telle qu’elle a été évaluée à l’instant spécifié.
Notez que le type de valeur renvoyé n’est pas explicite ; il peut varier en fonction de la propriété évaluée.
Paramètres
time
Temps, en secondes ; valeur à virgule flottante. Le début de la composition est 0.
pre E x pres si o n
Si la propriété est dotée d’une expression dont la valeur est true, la valeur pour l’instant spécifié
est renvoyée sans que l’expression lui soit appliquée. Si ce paramètre est false, le résultat de
l’évaluation de l’expression à l’instant spécifié est renvoyé.
Ignoré si la propriété ne dispose pas d’une expression associée.
Renvoi
Valeur appropriée pour le type de propriété défini (voir la section « Attribut Property propertyValueType »,
page 132).
140
Référence JavaScript
Objet PropertyBase
141
Objet PropertyBase
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). prop e r t y Sp ec
Description
L’accès aux propriétés des calques se fait à l’aide de leur nom, en utilisant diverses syntaxes d’expression
(contrôlées par les préférences de l’application). Voici par exemple toutes les façons d’accéder aux propriétés
du groupe Effects :
v ar effe ct 1 = app.proj ec t. item(1 ). layer( 1 ) . e f fe c t ( " Ad d Gr a i n " ) ( " Vi e w i n g Mo d e " ) ;
v ar effe ct 1a ga in = a pp. pro je c t .item(1).layer (1 ). effec t.a ddGr ain.v ie w i ngMo de ;
v ar ef fe c t 1a g a in too = a pp. pro je c t .i tem ( 1) .l ayer (1 )( " Ef fe c t s") .a d dGr a i n .v i ew i ngMo de;
v ar ef fe c t 1a ga in too 2 = a pp.proje c t.i tem (1 ).l ayer( 1) ("Ef fe c t s " )( "Ad d Gr ai n")( "Vie w i ng Mo de ");
Voir aussi la section « Méthode PropertyGroup property() », page 150.
• PropertyBase est à la fois la classe de base de Property et de PropertyGroup ; par conséquent, les méthodes
et attributs de PropertyBase sont disponibles lorsque vous travaillez avec les propriétés et les groupes de
propriétés. Voir les sections « Objet Property », page 119 et « Objet PropertyGroup », page 148.
Références non valides
S’il se produit une action qui modifie un objet de façon assez significative pour en fausser la référence, les
références à cet objet dans le script risquent de générer des erreurs. Dans les cas simples, ce problème est facile
à résoudre. Par exemple, si vous supprimez un objet, toute référence à l’objet effacé génère un message
d’avertissement de type « Objet non valide ».
v ar layer 1 = app.proj ec t. item(1 ). layer(1);
layer 1,remove();
a l er t ( l ayer 1, n a m e ) ; / / i nv a l i d ref e ren ce to d e l e te d o b j e c t
Si vous faites référence à une propriété AE dans un objet supprimé, vous obtenez le même avertissement :
v ar layer 1 = app.proj ec t. item(1 ). layer(1);
v ar l ayer 1 p o s i t io n = l ayer 1 ,t r an s for m . p o s it i o n ;
layer 1,remove();
a l er t( l ayer 1 p o s i t io n . v al u e ) ; / / i nv al i d re feren ce to p ro p e r t y in s e l e c te d o b jec t
Le problème est plus difficile à résoudre si la propriété a été supprimée d’un groupe de propriétés. After Effects
génère l’erreur « Objet non valide » lorsque vous référencez cet objet ou d’autres éléments du groupe, car les
positions d’index ont changé. Par exemple :
v ar effe ct 1 = app.proj ec t. item(1 ). layer(1).effe c t (1 );
v ar effe ct 2 = app.proj ec t. item(1 ). layer(1).effe c t (2 );
v ar ef fe ct 2p ar am = app.proj ec t. item(1 ). layer( 1) .ef fe c t (2 ). blend Wi t hO r ig in al;
effe ct 1,remove();
a l er t( e f fe c t 2 ,n a m e ) ; / / i nv al i d re feren ce b e c au se g ro u p in dex p o s i t i on s h ave cha n g e d
Attributs
Attribut
Référence
Description
name
« Attribut PropertyBase name »,
page 145
Nom de la propriété.
141
Référence JavaScript
Objet PropertyBase
142
Attribut
Référence
Description
matchNam e
« Attribut PropertyBase matchName »,
page 145
Nom spécial de la propriété utilisé pour créer des noms de chemin
d’accès uniques.
prop er t y Index
« Attribut PropertyBase
propertyIndex », page 146
Index de la propriété dans son groupe parent.
prop er t y D ep t h
« Attribut PropertyBase
propertyDepth », page 146
Nombre de niveaux de groupes parent entre cette propriété et le
calque la contenant.
prop er t y Ty p e
« Attribut PropertyBase propertyType », Type de propriété.
page 147
p aren tPro p e r t y « Attribut PropertyBase
Groupe parent immédiat de cette propriété.
parentProperty », page 146
i s Mod i fi e d
« Attribut PropertyBase isModified »,
page 144
Lorsque cet attribut est true, la propriété a été modifiée depuis sa
création.
c a n S e t E n a bl e d
« Attribut PropertyBase
canSetEnabled », page 143
Lorsque cet attribut est true, l’interface utilisateur affiche une icône
en forme d’œil pour cette propriété.
e n a bl e d
« Attribut PropertyBase enabled »,
page 144
Lorsque cet attribut est true, la propriété est activée.
a c t ive
« Attribut PropertyBase active »,
page 142
Lorsque cet attribut est true, la propriété est active.
e l id ed
« Attribut PropertyBase elided »,
page 143
Lorsque cet attribut est true, cette propriété ne s’affiche pas dans
l’interface utilisateur.
i s E ff e c t
« Attribut PropertyBase isEffect »,
page 144
Lorsque cet attribut est true, la propriété est un effet.
i s Mas k
« Attribut PropertyBase isMask »,
page 144
Lorsque cet attribut est true, la propriété est un masque.
s e l e c te d
« Attribut PropertyBase selected »,
page 147
Lorsque cet attribut est true, la propriété est sélectionnée.
Méthodes
Méthode
Référence
prop er t y Group () « Méthode PropertyBase
Description
Extrait le groupe parent pour cette propriété.
propertyGroup() », page 146
rem ove( )
« Méthode PropertyBase remove() »,
page 147
Supprime cet élément du projet.
m oveTo( )
« Méthode PropertyBase moveTo() »,
page 145
Déplace cette propriété à un nouvel endroit dans son groupe
parent.
du pl i c ate( )
« Méthode PropertyBase duplicate() »,
page 143
Duplique cet objet de propriété.
Attribut PropertyBase active
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec . a c t ive
Description
Lorsque cet attribut est true, la propriété est active. Pour un calque, cela correspond au paramètre de l’icône
en forme d’œil. Pour un effet et toutes les propriétés, il s’agit de l’équivalent de l’attribut ena b led .
Type
Booléen ; en lecture/écriture si la valeur de c a n S e t E n a b l e d est true ; en lecture seule si la valeur de
c a n S e t E n a bl e d est false.
142
Référence JavaScript
Objet PropertyBase
143
Attribut PropertyBase canSetEnabled
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec . c a n S e t E n a b l e d
Description
Si la valeur est true, vous pouvez affecter la valeur d’attribut e n a bl e d . En règle générale, cet attribut est true si
l’interface utilisateur affiche une icône en forme d’œil pour cette propriété ; la valeur true s’applique à tous les
calques.
Type
Booléen ; lecture seule.
Méthode PropertyBase duplicate()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .dup licate ()
Description
Si cette propriété est un enfant d’un groupe indexé, un nouvel objet PropertyBase ayant les mêmes valeurs
d’attribut que celle-ci est créé et renvoyé.
Si cette propriété n’est pas un enfant de groupe indexé, la méthode génère une exception et un message
d’erreur s’affiche.
Un groupe indexé est de type Prop er t y Ty p e . I N D E X E D _ GRO U P ; voir la section « Attribut PropertyBase
propertyType », page 147.
Paramètres
Aucun.
Renvoi
Objet PropertyBase.
Attribut PropertyBase elided
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .elide d
Description
Lorsque cet attribut est true, la propriété est un groupe utilisé pour organiser d’autres propriétés. La propriété ne
s’affiche pas dans l’interface utilisateur et ses propriétés enfant ne sont pas indentées dans le panneau Montage.
Par exemple : dans le cas d’un calque de texte comportant deux animations et aucune propriété indentée, vous
voyez :
Tex t
Pa th O p t i on s
More O p t i on s
Anim ator 1
Anim ator 2
Dans cet exemple, « Animator 1 » et « Animator 2 » sont contenus dans un PropertyBase appelé « Text
Animators ». Ce groupe parent ne s’affiche pas dans l’interface utilisateur ; par conséquent, les deux propriétés
enfant ne sont pas indentées dans le panneau Montage.
Type
Booléen ; lecture seule.
143
Référence JavaScript
Objet PropertyBase
144
Attribut PropertyBase enabled
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .enabled
Description
Lorsque cet attribut est true, la propriété est activée. Cet attribut correspond au paramètre de l’icône en forme
d’œil, si celle-ci est présente ; sinon, la valeur par défaut est true.
Type
Booléen ; en lecture/écriture si la valeur de c a n S e t E n a bl e d est true ; en lecture seule si la valeur de c a n S e t E n a b l e d
est false.
Attribut PropertyBase isEffect
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .isEf fe c t
Description
Lorsque cet attribut est true, la propriété est un PropertyGroup d’effets.
Type
Booléen ; lecture seule.
Attribut PropertyBase isMask
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .isMa s k
Description
Lorsque cet attribut est true, la propriété est un PropertyGroup de masques.
Type
Booléen ; lecture seule.
Attribut PropertyBase isModified
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .isMo d if ied
Description
Lorsque cet attribut est true, la propriété a été modifiée depuis sa création.
Type
Booléen ; lecture seule.
144
Référence JavaScript
Objet PropertyBase
145
Attribut PropertyBase matchName
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .matchName
Description
Nom spécial de la propriété utilisé pour créer des noms de chemin d’accès uniques. Le nom interne ne s’affiche
pas, mais vous pouvez y faire référence dans les scripts. Chaque propriété possède un identificateur de nom
interne unique. Les noms internes sont stables d’une version à l’autre indépendamment du nom qui s’affiche
(valeur de l’attribut n a m e ) ou des modifications apportées à l’application. Contrairement au nom d’affichage,
il n’est pas traduit.
Un groupe indexé peut ne pas avoir de valeur n a m e ; en revanche, il dispose toujours d’une valeur
matchNam e . (Un groupe indexé est de type Prop er t y Ty p e .I N D E XE D_ G RO UP ; voir la section « Attribut
PropertyBase propertyType », page 147.)
Type
Chaîne ; lecture seule.
Méthode PropertyBase moveTo()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .moveTo(n e w In de x )
Description
Déplace cette propriété à un nouvel endroit dans son groupe de propriétés parent.
Cette méthode n’est valide que pour les enfants des groupes indexés ; si ce n’est pas le cas ou si la valeur
d’index n’est pas valide, une exception est générée et une erreur s’affiche. (Un groupe indexé est de type
Prop er t y Ty p e .I N D E XE D_ G RO UP ; voir la section « Attribut PropertyBase propertyType », page 147.)
Paramètres
n e w In d e x
Nouvelle position d’index dans le groupe où sera placée cette propriété. Nombre entier.
Renvoi
Aucun.
Attribut PropertyBase name
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .nam e
Description
Nom d’affichage de la propriété. (Comparer avec « Attribut PropertyBase matchName », page 145.)
Ne définissez pas la valeur n a m e si la propriété n’est pas un enfant d’un groupe indexé (c’est-à-dire, un groupe
de propriétés du type Prop er t y Ty p e .I N D E XE D_ G ROU P ; voir la section « Attribut PropertyBase
propertyType », page 147).
Type
Chaîne ; en lecture/écriture pour un enfant d’un groupe indexé, sinon en lecture seule.
145
Référence JavaScript
Objet PropertyBase
146
Attribut PropertyBase parentProperty
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .p arentProp er t y
Description
Groupe de propriétés se trouvant être le parent immédiat de cette propriété, ou valeur nulle si PropertyBase
est un calque.
Type
Objet PropertyGroup ou valeur nulle ; lecture seule.
Attribut PropertyBase propertyDepth
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .prop er t yD ep th
Description
Nombre de niveaux de groupes parent entre cette propriété et le calque la contenant. Valeur 0 pour un calque.
Type
Entier ; lecture seule.
Méthode PropertyBase propertyGroup()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .prop er t yGrou p( )
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .prop er t yGrou p( c oun t Up )
Description
Extrait l’objet PropertyGroup pour un groupe ancêtre de cette propriété au niveau spécifié de la hiérarchie
parent-enfant.
Paramètres
co un tUp
Facultatif. Nombre de niveaux à inclure dans la hiérarchie parent-enfant. Nombre entier
compris dans la plage [1..prop er t y D ep th ]. La valeur par défaut de 1 permet d’accéder au
parent immédiat.
Renvoi
Objet PropertyGroup, ou valeur nulle si le décompte atteint le calque contenant.
Attribut PropertyBase propertyIndex
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .prop er t yIndex
Description
Index de position de cette propriété à l’intérieur de son groupe parent, s’il s’agit d’un enfant d’un groupe
indexé (groupe de propriétés du type Pro p e r t y Ty p e.I N DE X E D_ G RO U P ; voir la section « Attribut
PropertyBase propertyType », page 147).
Type
Entier ; lecture seule.
146
Référence JavaScript
Objet PropertyBase
147
Attribut PropertyBase propertyType
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .prop er t yTy p e
Description
Type de cette propriété.
Type
Valeur énumérée Prop er t y Ty p e ; lecture/écriture. L’une des suivantes :
Prop er t y Ty p e .P ROPE RT Y
Propriété unique telle que la position ou le zoom.
Prop er t y Ty p e .I N D E XE D_ G RO UP
Groupe de propriétés dont les membres disposent d’un index et d’un nom qu’il
est possible de modifier. Les effets et les masques sont des groupes indexés. Par
exemple, la propriété m a s k s d’un calque renvoie à un nombre variable de
masques différents en fonction du numéro d’index.
Prop er t y Ty p e .NA ME D _ G ROU P
Groupe de propriétés dont il est impossible de modifier les noms des membres.
Les calques sont des groupes nommés.
Méthode PropertyBase remove()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .rem ove ()
Description
Supprime cette propriété de son groupe parent. S’il s’agit d’un groupe de propriétés, les propriétés enfant sont
également supprimées.
Cette méthode n’est valide que pour les enfants des groupes indexés ; si ce n’est pas le cas ou si la valeur d’index
n’est pas valide, une exception est générée et une erreur s’affiche. (Un groupe indexé est de type
Prop er t y Ty p e .I N D E XE D_ G RO UP ; voir la section « Attribut PropertyBase propertyType », page 147.)
Cette méthode peut être appelée sur une propriété d’animation de texte (c’est-à-dire toute animation ayant
été affectée à un calque de texte).
Paramètres
Aucun.
Renvoi
Aucun.
Attribut PropertyBase selected
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Sp ec .se l e c te d
Description
Lorsque cet attribut est true, la propriété est sélectionnée. Définissez la valeur true pour sélectionner la
propriété, ou false pour la désélectionner.
L’échantillonnage répété de cet attribut pour un grand nombre de propriétés peut ralentir les performances
du système. Pour lire la totalité des propriétés sélectionnées d’une composition ou d’un calque, utilisez
l’attribut se l ec te dProp er t ie s d’un objet Comp ou Layer.
Type
Booléen ; en lecture/écriture pour un groupe de propriétés de masque ou d’effet, sinon en lecture seule.
147
Référence JavaScript
Objet PropertyGroup
148
Objet PropertyGroup
a pp. pro je c t .i tem ( i n d e x) .l ayer (i n de x ). prop e r t y Grou p Sp e c
Description
L’objet PropertyGroup représente un groupe de propriétés. Il peut contenir des objets Property et d’autres
objets PropertyGroup. Les groupes Property peuvent être imbriqués pour former une hiérarchie parentenfant, partant d’un objet Layer au niveau supérieur (racine) et descendant jusqu’à un objet Property unique,
tel que le contour progressif du troisième masque. Pour traverser la hiérarchie du groupe, utilisez les méthodes
et les attributs PropertyBase ; voir la section « Méthode PropertyBase propertyGroup() », page 146.
Pour obtenir des exemples sur la manière d’accéder aux propriétés et aux groupes de propriétés, reportez-vous
à la section « Objet PropertyBase », page 141.
• PropertyGroup est une sous-classe de PropertyBase. Toutes les méthodes et tous les attributs de
PropertyBase, outre ceux énumérés ci-dessous, sont disponibles lorsque vous utilisez PropertyGroup.
Voir la section « Objet PropertyBase », page 141.
• PropertyGroup est une classe de base de MaskPropertyGroup. Les méthodes et les attributs de
PropertyGroup sont disponibles lorsque vous travaillez avec des groupes de masques. Voir la
section « Objet MaskPropertyGroup », page 102.
Attributs
Attribut
Référence
Description
nu m Prop er t i es
« Attribut PropertyGroup numProperties », page 149
Nombre de propriétés indexées dans le groupe.
Méthodes
Méthode
Référence
Description
prop er t y ( )
« Méthode PropertyGroup property() »,
page 150
Extrait un groupe ou une propriété d’un membre.
c a n Ad dPro p e r t y ()
« Méthode PropertyGroup canAddProperty() », Indique si une propriété peut être ajoutée au groupe.
page 149
a d dProp er t y ()
« Méthode PropertyGroup addProperty() »,
page 148
Ajoute une propriété au groupe.
Méthode PropertyGroup addProperty()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Grou p Sp e c.a d dProp er t y (n a m e )
Description
Crée et renvoie un objet PropertyBase, avec le nom spécifié, et l’ajoute à ce groupe.
En général, vous pouvez uniquement ajouter des propriétés à un groupe indexé, c’est-à-dire du type
Prop er t y Ty p e .I N D E XE D_ G RO UP ; voir la section « Attribut PropertyBase propertyType », page 147.
La seule exception est la propriété d’animation de texte, qu’il est possible d’ajouter à un groupe nommé
(groupe de propriétés du type Prop er t y Ty p e. NAM E D_ G RO UP ) .
Si cette méthode ne peut pas créer de propriété avec le nom spécifié, une exception est générée. Pour vérifier
que vous pouvez ajouter une propriété donnée à ce groupe, appelez c an Ad d Prop er t y avant d’utiliser cette
méthode. (Voir la section « Méthode PropertyGroup canAddProperty() », page 149.)
148
Référence JavaScript
Objet PropertyGroup
149
Paramètres
name
Nom d’affichage ou nom interne de la propriété à ajouter. (Voir la section « Attribut PropertyBase matchName »,
page 145.)
Les noms suivants sont pris en charge :
• Tout nom interne d’une propriété pouvant être ajoutée via l’interface utilisateur. Par exemple : « ADBE Mask Atom »,
« ADBE Paint Atom », « ADBE Text Position », « ADBE Text Anchor Point ».
• Lors d’un ajout à ADBE Mask Parade : « ADBE Mask Atom », « Mask ».
• Lors d’un ajout à ADBE Effect Parade : tout effet par nom interne, tel que « ADBE Bulge », « ADBE Glo2 », « APC Vegas ».
• Tout effet par nom d’affichage, tel que « Bulge », « Glow », « Vegas ».
• Pour les animations de texte, « ADBE Text Animator ».
• En ce qui concerne les sélecteurs : le sélecteur de plage a pour nom « ADBE Text Selector », le sélecteur de
tremblement a pour nom « ADBE Text Wiggly Selector » et le sélecteur d’expressions a pour nom « ADBE Text
Expressible Selector ».
Renvoi
Objet PropertyBase.
Méthode PropertyGroup canAddProperty()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Grou p Sp e c.ca n Ad dProp er t y(n a m e)
Description
Renvoie true si une propriété portant le nom donné peut être ajoutée à ce groupe de propriétés. Par exemple :
vous pouvez uniquement ajouter un masque à un groupe de masques. Les seuls arguments d’entrée autorisés
sont « Mask » et « ADBE Mask Atom ».
m a sk Gro u p. ca n Ad d Prop e r t y ( " m as k" ) ; / / re tu r n s t r u e
m a sk Gro u p. ca n Ad d Prop e r t y ( " A DB E Ma s k Ato m " ) ; / / re tu r n s t r u e
m a s k Gro u p. ca n Ad d Prop e r t y ( " bl e n d " ) ; / / re t u r n s fa l s e
Paramètres
name
Nom d’affichage ou nom interne de la propriété à vérifier. (Voir la section « Méthode
PropertyGroup addProperty() », page 148.)
Renvoi
Booléen.
Attribut PropertyGroup numProperties
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Grou p Sp e c.nu m Prop er t i es
Description
Nombre de propriétés indexées dans ce groupe.
Pour les calques, cette méthode renvoie une valeur de 3, correspondant aux groupes de masques, d’effets et de
suivi de trajectoire, qui sont les groupes indexés dans le calque. Toutefois, les calques comportent également
de nombreuses autres propriétés uniquement accessibles par nom ; voir la section « Méthode PropertyGroup
property() », page 150.
Type
Entier ; lecture seule.
149
Référence JavaScript
Objet PropertyGroup
150
Méthode PropertyGroup property()
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Grou p Sp e c.p ro p e r t y( in d e x)
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop e r t y Grou p Sp e c.p ro p e r t y( n am e )
Description
Cherche et renvoie une propriété enfant de ce groupe, spécifiée soit par son index, soit par son nom.
Pour spécifier un nom, vous pouvez utiliser la même syntaxe que celle des expressions. Toutes les expressions
ci-dessous sont autorisées et sont équivalentes :
my l ayer. p o s it i o n
my l ayer (" p o si t i o n " )
my l ayer. prop er t y ("p o si t i on")
my l ayer (1 )
my l ayer. prop er t y (1 )
Certaines des propriétés d’un calque, telles que la position et le zoom, sont accessibles uniquement par le nom.
Lorsque vous utilisez le nom pour rechercher une propriété se trouvant à plusieurs niveaux inférieurs, vous
devez appeler cette méthode plusieurs fois. Par exemple, l’appel suivant effectue une recherche deux niveaux
plus bas et renvoie le premier masque du groupe de masques :
my L ayer.p rop e r t y ( " A D BE Mas ks " ) .prop e r t y ( 1 )
Paramètres
i n dex
L’index de la propriété enfant est, dans ce cas, un groupe indexé. Nombre entier compris dans la plage
[0..num Prop er t i es ].
name
Nom de la propriété enfant. Il peut s’agir de :
• Tout nom interne.
• Tout nom utilisé dans la syntaxe d’expression « parenthesis style » (c’est-à-dire le nom d’affichage ou
le nom anglais compact).
• Tout nom utilisé dans la syntaxe d’expression « intercap style ».
Pour connaître les noms de propriété pris en charge, consultez le tableau ci-dessous.
Renvoi
Objet PropertyBase ou valeur nulle si aucune propriété enfant avec le nom de chaîne donné n’a été trouvée.
Propriétés accessibles par nom
A partir d’un calque quelconque
• "ADBE Mask Parade" ou "Masks"
• "ADBE Effect Parade" ou "Effects"
• "ADBE MTrackers" ou "Motion Trackers"
150
Référence JavaScript
Objet PropertyGroup
151
A partir d’un AVLayer
• "Anchor Point" ou "anchorPoint"
• "Position" ou "position"
• "Scale" ou "scale"
• "Rotation" ou "rotation"
• "Z Rotation" ou "zRotation" ou "Rotation Z" ou "rotationZ"
• "Opacity" ou "opacity"
• "Marker" ou "marker"
A partir d’un AVLayer avec une source non
fixe
• "Time Remap" ou "timeRemapEnabled"
A partir d’un AVLayer avec un composant
audio
• "Audio Levels" ou "audioLevels"
A partir d’un calque de caméra
• "Zoom" ou "zoom"
• "Depth of Field" ou "depthOfField"
• "Focus Distance" ou "focusDistance"
• "Aperture" ou "aperture"
• "Blur Level" ou "blurLevel"
A partir d’un calque de lumière
• "Intensity" ou "intensity"
• "Color" ou "color"
• "Cone Angle" ou "coneAngle"
• "Cone Feather" ou "coneFeather"
• "Shadow Darkness" ou "shadowDarkness"
• "Shadow Diffusion" ou "shadowDiffusion"
• "Casts Shadows" ou "castsShadows"
A partir d’un calque 3D
• "Accepts Shadows" ou "acceptsShadows"
• "Accepts Lights" ou "acceptsLights"
• "Ambient" ou "ambient"
• "Diffuse" ou "diffuse"
• "Specular" ou "specular"
• "Shininess" ou "shininess"
• "Casts Shadows" ou "castsShadows"
• "Light Transmission" ou "lightTransmission"
• "Metal" ou "metal"
A partir d’un calque de caméra ou de
lumière ou d’un calque 3D
• "X Rotation" ou "xRotation" ou "Rotation X" ou "rotationX"
• "Y Rotation" ou "yRotation" ou "Rotation Y" ou "rotationY"
• "Orientation" ou "orientation"
A partir d’un calque de texte
• "Source Text" ou "sourceText" ou "Text" ou "text"
A partir d’un PropertyGroup "ADBE Mask
Parade"
• "ADBE Mask Atom"
A partir d’un PropertyGroup "ADBE Mask
Atom"
• "ADBE Mask Shape" ou "maskShape" ou "maskPath"
• "ADBE Mask Feather" ou "maskFeather"
• "ADBE Mask Opacity" ou "maskOpacity"
• "ADBE Mask Offset" ou "maskOffset"
151
Référence JavaScript
Objet PropertyGroup
152
Exemples
1 Si un calque nommé « myLayer » comporte un effet Flou de la bordure (Box Blur), vous pouvez extraire
l’effet de l’une des façons suivantes :
my L ayer.p rop e r t y ( “ E f fe c t s” ) .prop e r t y ( “ B ox Blu r ” );
my L ayer.p rop e r t y ( “ E f fe c t s” ) .prop e r t y ( “ b ox Blur ” ) ;
my L ayer.p rop e r t y ( “ E f fe c t s” ) .prop e r t y ( “A D BE B ox Bl u r ” ) ;
2 Si un calque nommé « myLayer » comporte un masque nommé « Mask 1 », vous pouvez l’extraire comme suit :
my L ayer.p rop e r t y ( “ Ma sk s” ) .p rop e r t y ( “ Ma sk 1 ” ) ;
3 Pour obtenir la valeur du centre (Bulge Center) d’un effet de renflement (Bulge), vous pouvez procéder de
l’une des façons suivantes :
my L ayer.p rop e r t y ( “ E f fe c t s” ) .prop e r t y ( “ Bu l g e” ) .prop e r t y ( “ Bul g e Cen te r ” ) ;
my L ayer.p rop e r t y ( “ E f fe c t s” ) .prop e r t y ( “ Bu l g e” ) .prop e r t y ( “ b u l g e Ce n ter ” ) ;
152
Référence JavaScript
Objet RenderQueue
153
Objet RenderQueue
a pp. pro je c t .renderQ ueue
Description
L’objet RenderQueue représente le processus d’automatisation du rendu, les données et les fonctions
disponibles via le panneau File d’attente de rendu d’un projet After Effects donné. Les attributs donnent accès
aux éléments contenus dans la file d’attente de rendu et à leur état de rendu. Les méthodes peuvent démarrer,
suspendre et arrêter le processus de rendu.
L’objet RenderQueueItem donne accès aux paramètres spécifiques d’un élément dont le rendu doit être
effectué. Voir la section « Objet RenderQueueItem », page 156.
Attributs
Attribut
Référence
Description
ren der in g
« Attribut RenderQueue rendering », page 155
Lorsque cet attribut est true, un rendu est en cours.
nu m Item s
« Attribut RenderQueue numItems », page 154
Nombre total d’éléments se trouvant dans la file
d’attente de rendu.
i te m s
« Attribut RenderQueue items », page 154
Collection des éléments se trouvant dans la file
d’attente de rendu.
Méthodes
Méthode
Référence
Description
s h ow Win dow( )
« Méthode RenderQueue
showWindow() », page 155
Affiche ou masque le panneau File d’attente de rendu.
ren der( )
« Méthode RenderQueue render() »,
page 154
Démarre le processus de rendu ; ne renvoie rien tant que le
rendu n’est pas terminé.
p au se Re n der in g ()
« Méthode RenderQueue
pauseRendering() », page 154
Suspend ou poursuit le processus de rendu.
s to pRen d e r i n g ( )
« Méthode RenderQueue
stopRendering() », page 155
Arrête le processus de rendu.
i te m ( )
« Méthode RenderQueue item() »,
page 153
Extrait de la collection un élément de la file d’attente de
rendu.
Méthode RenderQueue item()
a pp. pro je c t .renderQ ueue. item( i n de x)
Description
Extrait un élément donné de la collection d’éléments Item .
Paramètres
i n dex
Index de position de l’élément. Nombre entier compris dans la plage [0..num Item s ].
Renvoi
Objet RenderQueueItem.
153
Référence JavaScript
Objet RenderQueue
154
Attribut RenderQueue items
a pp. pro je c t .renderQ ueue. items
Description
Collection de tous les éléments se trouvant dans la file d’attente de rendu. Voir la section « Objet
RenderQueueItem », page 156.
Type
Objet RQItemCollection ; lecture/écriture.
Attribut RenderQueue numItems
a pp. pro je c t .renderQ ueue. numItems
Description
Nombre total d’éléments se trouvant dans la file d’attente de rendu.
Type
Entier ; lecture seule.
Méthode RenderQueue pauseRendering()
a pp. pro je c t .renderQ ueue. pa useRender i ng( p a u s e)
Description
Suspend le processus de rendu en cours, ou reprend un processus de rendu ayant été suspendu. Cela revient à
cliquer sur Pause dans le panneau File d’attente de rendu pendant un rendu. Vous pouvez lancer cette méthode
à partir d’un rappel onSt at us Ch anged ou o n E r ror . Voir les sections « Attribut RenderQueueItem
onStatusChanged », page 158 et « Attribut Application onError », page 26.
Paramètres
p au se
True pour suspendre le processus de rendu en cours, false pour reprendre un processus de rendu ayant été
suspendu.
Renvoi
Aucun.
Méthode RenderQueue render()
a pp. pro je c t .renderQ ueue. render()
Description
Démarre le processus de rendu. Cela revient à cliquer sur Rendu dans le panneau File d’attente de rendu. Cette
méthode ne renvoie rien tant que le rendu n’est pas terminé. Pour suspendre ou arrêter le processus de rendu,
appelez p a u s e Re n d e r i n g ( ) ou stop Render i n g() à partir d’un rappel o n E r ror ou onSta tu sChan ge d .
• Pour réagir aux erreurs au cours d’un processus de rendu, définissez une fonction de rappel dans
a pp.on E r ror ; voir la section « Attribut Application onError », page 26.
• Pour réagir aux modifications d’état d’un élément donné lorsque le processus de rendu est en cours,
définissez une fonction de rappel dans RenderQ ueueItem;onSt atu sCha n ged , dans l’objet
RenderQueueItem associé ; voir la section « Attribut RenderQueueItem onStatusChanged », page 158.
154
Référence JavaScript
Objet RenderQueue
155
Paramètres
Aucun.
Renvoi
Aucun.
Attribut RenderQueue rendering
a pp. pro je c t .renderQ ueue. render ing
Description
Lorsque cet attribut est true, le processus de rendu est en cours ou momentanément suspendu. Lorsque cet
attribut est false, le processus est arrêté.
Type
Booléen ; lecture seule.
Méthode RenderQueue showWindow()
a pp. pro je c t .renderQ ueue. sh ow Wi ndow ( do Sh ow)
Description
Affiche ou masque le panneau File d’attente de rendu.
Paramètres
doS h ow
Lorsque ce paramètre est true, le panneau File d’attente de rendu est affiché. Lorsque ce
paramètre est false, le panneau est masqué.
Renvoi
Aucun.
Méthode RenderQueue stopRendering()
a pp. pro je c t .renderQ ueue. stop Render ing()
Description
Arrête le processus de rendu. Cela revient à cliquer sur Arrêter dans le panneau File d’attente de rendu au cours
d’un rendu. Vous pouvez lancer cette méthode à partir d’un rappel o n S t a t u s C h a n g e d ou on E r ror. Voir les
sections « Attribut RenderQueueItem onStatusChanged », page 158 et « Attribut Application onError »,
page 26.
Paramètres
Aucun.
Renvoi
Aucun.
155
Référence JavaScript
Objet RenderQueueItem
156
Objet RenderQueueItem
a pp. pro je c t .renderQ ueue. items( i n d e x)
Description
L’objet RenderQueueItem représente un élément individuel dans la file d’attente de rendu. Il donne accès
aux paramètres spécifiques d’un élément dont le rendu doit être effectué. Créez un objet en ajoutant une
composition à la file d’attente de rendu avec l’objet RQItemCollection ; voir la section « Méthode
RQItemCollection add() », page 163.
Attributs
Attribut
Référence
Description
nu m Out p utMo du le s
« Attribut RenderQueueItem
numOutputModules », page 158
Nombre total de modules de sortie affectés à l’élément.
ren der
« Attribut RenderQueueItem render »,
page 160
Lorsque cet attribut est true, le rendu de l’élément est
déclenché au démarrage de la file d’attente.
s ta r t Ti m e
« Attribut RenderQueueItem startTime »,
page 160
Heure à laquelle le processus de rendu de l’élément a
commencé.
e l ap se d S e co n d s
« Attribut RenderQueueItem
elapsedSeconds », page 158
Temps de rendu écoulé pour cet élément.
t i m e S p an S t ar t
« Attribut RenderQueueItem
timeSpanStart », page 162
Heure de début dans la composition dont le rendu doit
être effectué.
t i m eS p an D ur at i o n
« Attribut RenderQueueItem
timeSpanDuration », page 161
Durée de la composition dont le rendu doit être effectué.
s ki p Fr a m e s
« Attribut RenderQueueItem skipFrames »,
page 160
Nombre d’images à ignorer lors du rendu de cet élément.
com p
« Attribut RenderQueueItem comp »,
page 157
Composition dont le rendu doit être effectué par cet
élément.
outputMo du le s
« Attribut RenderQueueItem
outputModules », page 159
Collection de modules de sortie pour cet élément.
tem pl a tes
« Attribut RenderQueueItem templates »,
page 161
Ensemble de modèles de paramètres de rendu.
s ta tu s
« Attribut RenderQueueItem status »,
page 161
Etat de rendu en cours de l’élément.
onStatusChanged
« Attribut RenderQueueItem
onStatusChanged », page 158
Fonction de rappel appelée lors d’un processus de rendu
si l’état d’un élément est modifié.
l o g Ty p e
« Attribut RenderQueueItem logType »,
page 158
Type de journal pour cet élément.
Méthodes
Méthode
Référence
Description
outputMo du le ()
« Méthode RenderQueueItem outputModule() »,
page 159
Extrait un module de sortie pour l’élément.
rem ove( )
« Méthode RenderQueueItem remove() », page 159
Supprime l’élément de la file d’attente de
rendu.
s aveAs Tem p l ate( )
« Méthode RenderQueueItem saveAsTemplate() »,
page 160
Enregistre un nouveau modèle de paramètres
de rendu.
156
Référence JavaScript
Objet RenderQueueItem
157
Méthode
Référence
Description
a pp ly Te m p l ate ( )
« Méthode RenderQueueItem applyTemplate() »,
page 157
Applique un modèle de paramètres de rendu.
du pl i c ate
« Méthode RenderQueueItem duplicate() », page 157
Duplique cet élément.
Méthode RenderQueueItem applyTemplate()
a pp. pro je c t .renderQ ueue. item .a pp ly Te m p l ate ( te m p la te Nam e )
Description
Applique un modèle de paramètres de rendu à l’élément. Voir aussi « Méthode RenderQueueItem
saveAsTemplate() », page 160 et « Attribut RenderQueueItem templates », page 161.
Paramètres
tem pl a teNam e
Chaîne contenant le nom du modèle à appliquer.
Renvoi
Aucun.
Attribut RenderQueueItem comp
a pp. pro je c t .renderQ ueue. item (i n de x ). com p
Description
Composition dont le rendu doit être effectué par cet élément de la file d’attente de rendu. Pour modifier la
composition, vous devez supprimer cet élément de la file d’attente de rendu et en créer un nouveau.
Type
Objet CompItem ; lecture seule.
Méthode RenderQueueItem duplicate()
a pp. pro je c t .renderQ ueue. item (i n de x ). dup l i c ate ()
Description
Crée un doublon de cet élément et l’ajoute dans cette file d’attente de rendu.
Paramètres
Aucun.
Renvoi
Objet RenderQueueItem.
157
Référence JavaScript
Objet RenderQueueItem
158
Attribut RenderQueueItem elapsedSeconds
a pp. pro je c t .renderQ ueue. item (i n de x ). e l a ps e dS e co n d s
Description
Nombre de secondes passées à rendre cet élément.
Type
Entier, ou valeur nulle si l’élément n’a pas été rendu ; lecture seule.
Attribut RenderQueueItem logType
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e. l o g Ty p e
Description
Type de journal pour cet élément, indiquant les événements à enregistrer lorsque l’élément est en cours
de rendu.
Type
Valeur énumérée Lo g Ty p e ; écriture/lecture. L’une des suivantes :
L o g Ty p e . E R RO R S _ O N LY
L o g Ty p e . E R RO R S _ A N D _ S E T T I N G S
L o g Ty p e . E R RO R S _ A N D _ PE R _ F RA ME _ I N F O
Attribut RenderQueueItem numOutputModules
a pp. pro je c t .renderQ ueue. item (i n de x ). numO ut put Mo dules
Description
Nombre total de modules de sortie affectés à cet élément.
Type
Entier ; lecture seule.
Attribut RenderQueueItem onStatusChanged
a pp. pro je c t .renderQ ueue. item (i n de x ). onSt at us Ch ange d
Description
Nom de la fonction de rappel appelée chaque fois que la valeur de l’attribut Ren d er Qu eu eItem .s ta tus change.
Voir la section « Attribut RenderQueueItem status », page 161.
Vous ne pouvez pas modifier les éléments de la file d’attente de rendu ni l’application lorsque le processus
de rendu est en cours ou qu’il a été suspendu ; vous pouvez toutefois utiliser cette fonction de rappel pour
suspendre ou arrêter le processus de rendu. Voir les sections « Méthode RenderQueue pauseRendering() »,
page 154 et « Méthode RenderQueue stopRendering() », page 155.
Voir aussi la section « Attribut Application onError », page 26.
Type
Chaîne de nom de fonction, ou valeur nulle si aucune fonction n’a été attribuée.
158
Référence JavaScript
Objet RenderQueueItem
159
Exemple
f u n c t io n my S ta tu s Ch an g e d( ) {
a l er t(a pp. pro je c t .renderQ ueue. item(1 ). st at us)
}
a pp. pro je c t .renderQ ueue. item(1 ). onSt at usCh anged = my St atu sCha n ge d();
a pp. pro je c t .renderQ ueue. item(1 ). render = false; //change s sta tus a n d shows dia l og
Attribut RenderQueueItem outputModules
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e s
Description
Collection de modules de sortie pour l’élément.
Type
Objet OMCollection ; lecture/écriture.
Méthode RenderQueueItem outputModule()
a pp. pro je c t .renderQ ueue. item (i n de x ). o u t p ut Mo d u l e ( i n d e x)
Description
Extrait un module de sortie avec la position d’index spécifiée.
Paramètres
i n dex
Index de position du module de sortie. Nombre entier compris dans la plage [1..num Out putMo dule s ].
Renvoi
Objet OutputModule.
Méthode RenderQueueItem remove()
a pp. pro je c t .renderQ ueue. item (i n de x ). rem ove ()
Description
Supprime cet élément de la file d’attente de rendu.
Paramètres
Aucun.
Renvoi
Aucun.
159
Référence JavaScript
Objet RenderQueueItem
160
Attribut RenderQueueItem render
a pp. pro je c t .renderQ ueue. item (i n de x ). ren d er
Description
Lorsque cet attribut est défini sur true, l’élément est rendu au démarrage de la file d’attente. Si la valeur est
true, Ren derQ ueueItem.sta tu s est défini sur RQItem S ta tus .QU E U E D . Si la valeur est false, st at us est défini
sur RQItem S ta tu s. UN QU E UE D .
Type
Booléen ; lecture/écriture.
Méthode RenderQueueItem saveAsTemplate()
a pp. pro je c t .renderQ ueue. item (i n de x ). saveAs Temp l ate (n a m e)
Description
Enregistre les paramètres de rendu actuels des éléments en tant que nouveau modèle avec le nom spécifié.
Paramètres
name
Chaîne contenant le nom du nouveau modèle.
Renvoi
Aucun.
Attribut RenderQueueItem skipFrames
a pp. pro je c t .renderQ ueue. item (i n de x ). sk i p Fr am es
Description
Nombre d’images à ignorer lors du rendu de cet élément. Utilisé pour obtenir des tests de rendu plus rapides
qu’un rendu complet.
Une valeur égale à 0 signifie qu’aucune image n’est ignorée et produit un rendu régulier de toutes les images.
Une valeur égale à 1 signifie qu’une image sur deux est ignorée. Cela équivaut à « rendering on twos ». Plus la
valeur est élevée, plus le nombre d’images ignorées est important.
La durée totale reste inchangée. Si, par exemple, skip prend la valeur 1, la moitié du nombre d’images sera
produite pour une sortie de séquence, alors que, pour une sortie de film, la durée de chaque image sera doublée.
Type
Nombre entier compris dans la plage [0..99]. Lecture/écriture.
Attribut RenderQueueItem startTime
a pp. pro je c t .renderQ ueue. item (i n de x ). st ar tTi m e
Description
Date et heure auxquelles le rendu de cet élément a commencé.
Type
Objet Date, ou valeur nulle si le rendu de l’élément n’a pas commencé ; lecture seule.
160
Référence JavaScript
Objet RenderQueueItem
161
Attribut RenderQueueItem status
a pp. pro je c t .renderQ ueue. item (i n de x ). st at us
Description
Etat du rendu en cours de l’élément.
Type
Valeur énumérée RQItem S ta tus ; lecture seule. L’une des suivantes :
RQ Ite m St a t u s . W I L L _ C ON T I N U E
Le processus de rendu a été interrompu.
RQ Ite m S t a t u s . N E E D S _ O U T P U T
Absence de chemin de sortie valide pour l’élément.
RQ Item St at us .U N QUE U E D
L’élément de rendu figure dans le panneau File d’attente de rendu, mais n’est pas
prêt pour le rendu.
RQ Item St at us .QU E UE D
Composition prête pour le rendu.
RQ Item St at us .RE N D E RI N G
Composition en cours de rendu.
RQ Item St at us .U SER _ STO P PED
Processus de rendu arrêté par l’utilisateur ou un script.
RQ Item St at us .E RR _ STO P PE D
Processus de rendu arrêté suite à une erreur.
RQ Item St at us .D ON E
Processus de rendu de l’élément terminé.
Attribut RenderQueueItem templates
a pp. pro je c t .renderQ ueue. item (i n de x ). tem p l ate s
Description
Les noms de tous les modèles de paramètres de rendu sont disponibles pour cet élément. Voir aussi « Méthode
RenderQueueItem saveAsTemplate() », page 160.
Type
Tableau de chaînes ; lecture seule.
Attribut RenderQueueItem timeSpanDuration
a pp. pro je c t .renderQ ueue. item (i n de x ). t im eS pa n D ur a t i on
Description
Durée, en secondes, de la composition à rendre. La durée est déterminée en déduisant l’heure de début de
l’heure de fin. Définir cette valeur revient à définir une heure de fin personnalisée dans la boîte de dialogue
Paramètres de rendu.
Type
Valeur à virgule flottante ; lecture/écriture.
161
Référence JavaScript
Objet RenderQueueItem
162
Attribut RenderQueueItem timeSpanStart
a pp. pro je c t .renderQ ueue. item (i n de x ). t im eS pa n S ta r t
Description
Heure de la composition, en secondes, à laquelle le processus de rendu doit démarrer. Définir cette valeur
revient à définir une heure de début personnalisée dans la boîte de dialogue Paramètres de rendu.
Type
Valeur à virgule flottante ; lecture/écriture.
162
Référence JavaScript
Objet RQItemCollection
163
Objet RQItemCollection
a pp. pro je c t .renderQ ueue. items
Description
RQItemCollection contient tous les éléments de la file d’attente de rendu d’un projet, tels qu’ils apparaissent dans
le panneau File d’attente de rendu du projet. La collection permet d’accéder aux objets RenderQueueItem et de
les créer à partir de compositions. Le premier objet RenderQueueItem de la collection se trouve à la position
d’index 1. Voir la section « Objet RenderQueueItem », page 156.
• RQItemCollection est une sous-classe de Collection. Toutes les méthodes et tous les attributs de Collection
sont disponibles lorsque vous utilisez RQItemCollection. Voir la section « Objet Collection », page 51.
Méthodes
Méthode
Référence
Description
a d d( )
« Méthode RQItemCollection add() », page 163
Ajoute une composition à la file d’attente de rendu.
Méthode RQItemCollection add()
a pp. pro je c t .renderQ ueue. items. a dd( c o m p )
Description
Ajoute une composition à la file d’attente de rendu, ce qui crée un RenderQueueItem.
Paramètres
com p
Objet CompItem de la composition à ajouter.
Renvoi
Objet RenderQueueItem.
163
Référence JavaScript
Objet Settings
164
Objet Settings
Description
L’objet Settings fournit un moyen aisé de gérer les paramètres pour les scripts. Les paramètres sont enregistrés
dans le fichier des préférences d’After Effects et sont conservés d’une session de l’application à l’autre. Les
paramètres sont identifiés par section et par clé dans le fichier. Chaque nom de clé est associé à une valeur.
Dans le fichier de préférences, les noms de section sont indiqués entre crochets et entre guillemets, et les noms
de clé entre guillemets sous le nom de section. Toutes les valeurs sont des chaînes.
Vous pouvez créer de nouveaux paramètres avec cet objet et accéder aux paramètres existants.
Méthodes
Méthode
Référence
Description
s aveS e t t in g ()
« Méthode Settings saveSetting() », page 165
Enregistre une valeur par défaut pour un paramètre.
g e t S e tt i n g ( )
« Méthode Settings getSetting() », page 164
Extrait une valeur de paramètre.
h aveS e tt i n g ( )
« Méthode Settings haveSetting() », page 164
Indique si le paramètre spécifié a été attribué.
Méthode Settings getSetting()
a pp.s e t t i ng s . g e t S e t t i n g ( s e c t i on Na m e , k e yNa m e)
Description
Extrait du fichier de préférences la valeur d’un élément de préférences de création de script.
Paramètres
s e c t i on Na m e
Chaîne contenant le nom d’une section de paramètres.
ke y Na m e
Chaîne contenant le nom de clé d’un élément de paramètre.
Renvoi
Chaîne.
Exemple
Si vous avez enregistré un paramètre avec le nom de clé « Aligned Clone » dans la section « Eraser - Paint
Settings », vous pouvez en extraire la valeur à l’aide du script suivant :
v ar n = ap p.s e tt i n g s .get S e tt i n g( "Er a ser - Pa i n t S e tt i n g s ", "Ali g n e d Clone ") ;
a l er t ( " T h e s e t t i n g i s " + n ) ;
Méthode Settings haveSetting()
a pp.s e t t i ng s .have S e tt i n g ( s e c t i o n Na m e , ke y Na m e)
Description
Renvoie true si l’élément de préférences de création de script existe et qu’il est doté d’une valeur.
164
Référence JavaScript
Objet Settings
165
Paramètres
s e c t i on Na m e
Chaîne contenant le nom d’une section de paramètres.
ke y Na m e
Chaîne contenant le nom de clé d’un élément de paramètre.
Renvoi
Booléen.
Méthode Settings saveSetting()
a pp.s e t t i ng s .saveSe tt i ng( s ec t i on Nam e , ke y Na m e, va lue )
Description
Enregistre une valeur par défaut pour un élément de préférences de création de script.
Paramètres
s e c t i on Na m e
Chaîne contenant le nom d’une section de paramètres.
ke y Na m e
Chaîne contenant le nom de clé d’un élément de paramètre.
v alu e
Chaîne contenant la nouvelle valeur.
Renvoi
Aucun.
165
Référence JavaScript
Objet Shape
166
Objet Shape
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop er t y (i n de x ). prop e r t y ( " m as kS h a p e " ). v al u e
Description
L’objet Shape contient des informations décrivant une forme d’un calque de forme ou la forme du contour
d’un masque. Ces informations correspondent à la valeur des propriétés AE « Tracé du masque » et de la
propriété AE « Tracé » d’un calque de forme. Utilisez le constructeur, new S h a p e () , pour créer un nouvel objet
Shape vide, puis définissez chaque attribut pour spécifier la forme.
Une forme est dotée d’un ensemble de points d’ancrage, ou sommets, et dispose de deux poignées directrices,
ou vecteurs de tangente, pour chaque point d’ancrage. Le vecteur de tangente (dans un masque non
RotoBézier) détermine la direction de la ligne qui relie deux points d’ancrage. Il existe un vecteur de tangente
d’approche et un vecteur de tangente d’éloignement associés à chaque sommet de la forme.
La valeur de la tangente s’exprime sous forme de coordonnées x, y relatives au sommet associé. Par exemple, une
tangente de [-1,-1] se situe au-dessus et à gauche du sommet et présente une pente de 45 degrés, quelle que soit
la position réelle du sommet. Plus une poignée est longue, plus sa portée est grande. Ainsi, un segment de forme
d’approche demeure plus près du vecteur de tangente pour une valeur i n Tan ge n t de [-2,-2] que pour une valeur
i n Ta n g e n t de [-1,-1], bien que les deux s’approchent du sommet en provenant de la même direction.
Si une forme est ouverte, les valeurs i n Tan g e n t du premier sommet et outTa n gent du sommet final sont
ignorées. Sinon, ces deux vecteurs doivent spécifier les poignées directrices du segment de connexion final
s’éloignant du sommet final et revenant vers le premier sommet.
Les tangentes des masques RotoBézier sont calculées automatiquement. (Voir la section « Attribut
MaskPropertyGroup rotoBezier », page 104.) Si une forme est utilisée dans un masque RotoBézier, les valeurs
de tangente sont ignorées. Cela signifie que, pour les masques RotoBézier, vous pouvez construire une forme
en définissant uniquement l’attribut de somm et et en attribuant une valeur nulle aux vecteurs i n Ta n g en t et
o u t Ta n gen t . Lorsque vous accédez à la nouvelle forme, ses valeurs de tangente sont remplies avec des valeurs
calculées de façon automatique.
Exemple : création d’un masque carré
Un carré est une forme fermée constituée de quatre sommets. Par défaut, les valeurs i n Ta n g e n t et o u t Ta n g e n t
des segments de droite sont égales à 0 et n’ont pas besoin d’être définies explicitement.
v ar my Sh ap e = n ew S h ap e () ;
my Sh ap e.ver t ices = [[0,0 ], [0 1 00], [100 100 ], [1 00,0 ]];
my Sh ap e.cl o se d = t r ue;
Exemple : création d’un masque en forme de U
Un U est une forme ouverte constituée des quatre mêmes sommets que ceux utilisés dans le carré :
v ar my Sh ap e = n ew S h ap e () ;
my Sh ap e.ver t ices = [[0,0 ], [0 1 00], [100 100 ], [1 00,0 ]];
my Sh ap e.clo se d = false;
Exemple : création d’un ovale
Un ovale est une forme fermée constituée de 4 sommets et dotée de valeurs i n Tan ge n t s et o u t Ta n gen t s :
v ar my Sh ap e = n ew S h ap e () ;
my Sh ap e.ver t ices = [[300 ,50] ,[20 0 15 0], [3 00 2 50],[400 150 ]];
my Sh ap e.inTa ngents = [[55. 23,0 ], [ 0 ,-55 .23],[-55 .23 ,0],[0,5 5.2 3]];
my Sh ap e.out Ta n gent s = [[-5 5.2 3,0 ],[0, 55. 23],[55. 23, 0],[0,-55 .23 ]];
my Sh ap e.cl o se d = t r ue;
166
Référence JavaScript
Objet Shape
167
Attributs
Attribut
Référence
Description
cl o se d
« Attribut Shape closed », page 167
Lorsque cet attribut est défini sur true, la forme est une
courbe fermée.
ver t ices
« Attribut Shape vertices », page 168
Points d’ancrage de la forme.
i n Ta n g e n ts
« Attribut Shape inTangents », page 167
Vecteurs de tangente s’approchant des sommets de la forme.
o u t Ta n gen t s
« Attribut Shape outTangents », page 167
Vecteurs de tangente s’éloignant des sommets de la forme.
Attribut Shape closed
s h a p e O b j ec t. val ue. cl os ed
Description
Lorsque cet attribut est défini sur true, le premier et le dernier sommets sont reliés pour former une courbe
fermée. Lorsque cet attribut est défini sur false, le segment de fermeture n’est pas dessiné.
Type
Booléen ; lecture/écriture.
Attribut Shape inTangents
s h a p e O b j ec t. val ue. in Tan g en t s
Description
Vecteurs de tangente, ou poignées directrices, d’approche associés aux sommets de la forme. Définissez
chaque vecteur sous forme de tableau de deux valeurs à virgule flottante et rassemblez les vecteurs dans un
tableau de longueur identique à celui des s o m m e t s .
La valeur par défaut de chaque tangente est [0,0]. Si la forme de masque n’est pas RotoBézier, le segment
obtenu est un segment de droite.
Si la forme est un masque RotoBézier, toutes les valeurs sont ignorées et les tangentes sont calculées de façon
automatique.
Type
Tableau de paires de valeurs à virgule flottante ; lecture/écriture.
Attribut Shape outTangents
s h a p e O b j ec t. val ue. outTa n g en ts
Description
Vecteurs de tangente, ou poignées directrices, d’éloignement associés aux sommets de la forme. Définissez
chaque vecteur sous forme de tableau de deux valeurs à virgule flottante et rassemblez les vecteurs dans un
tableau de longueur identique à celui des s o m m e t s .
La valeur par défaut de chaque tangente est [0,0]. Si la forme de masque n’est pas RotoBézier, le segment
obtenu est un segment de droite.
Si la forme est un masque RotoBézier, toutes les valeurs sont ignorées et les tangentes sont calculées de façon
automatique.
Type
Tableau de paires de valeurs à virgule flottante ; lecture/écriture.
167
Référence JavaScript
Objet Shape
168
Attribut Shape vertices
s h a p e O b j ec t. val ue. ver t i ce s
Description
Points d’ancrage de la forme. Définissez chaque point sous forme de tableau de deux valeurs à virgule flottante
et rassemblez les paires de points dans un tableau comprenant l’ensemble des points. Par exemple :
my Sh ap e .ver t ice s = [ [ 0 ,0 ], [ 0 , 1 ] , [ 1 ,1 ], [ 1 , 0 ] ];
Type
Tableau de paires de valeurs à virgule flottante ; lecture/écriture.
168
Référence JavaScript
Objet ShapeLayer
169
Objet ShapeLayer
a pp. pro je c t .i tem ( in d e x) .l ayer(i n de x )
Description
L’objet ShapeLayer représente un calque de forme dans une composition. Vous pouvez le créer à l’aide de
la méthode a d dS ha p e () de l’objet LayerCollection ; voir la section « Méthode LayerCollection addShape() »,
page 94. Pour accéder à cet objet dans la collection de calques d’un élément, vous pouvez utiliser son numéro
d’index ou encore une chaîne de nom.
• ShapeLayer est une sous-classe de AVLayer, qui est lui-même une sous-classe de Layer. Toutes les méthodes
et tous les attributs de AVLayer et de Layer sont disponibles lorsque vous utilisez ShapeLayer. Voir les
sections « Objet Layer », page 83 et « Objet AVLayer », page 39.
169
Référence JavaScript
Objet SolidSource
170
Objet SolidSource
a pp.proj ec t .i te m ( in dex ) .m a in S ou rce.
a pp.proj ec t .i te m ( in dex ) .prox y S o u rce .
Description
L’objet SolidSource représente une source de métrage de couleur unie.
• SolidSource est une sous-classe de FootageSource. Toutes les méthodes et tous les attributs de FootageSource,
outre ceux énumérés ci-dessous, sont disponibles lorsque vous utilisez SolidSource. Voir la section « Objet
FootageSource », page 67.
Attributs
Attribut
Référence
Description
co lor
« Attribut SolidSource color », page 170
Couleur du solide.
Attribut SolidSource color
s olid S ourc e. col or
Description
Couleur du solide, exprimée en valeurs rouge, vert et bleu.
Type
Tableau de trois valeurs à virgule flottante, [R, V, B], comprises dans la plage [0.0..1.0] ; lecture/écriture.
170
Référence JavaScript
Objet System
171
Objet System
s ys te m
Description
L’objet System fournit l’accès aux attributs trouvés sur le système de l’utilisateur, tels que le nom d’utilisateur
et le nom et la version du système d’exploitation. Disponible par l’intermédiaire de la variable globale sy s tème .
Exemple
a l er t ( " Your O S i s " + sy stem.os Name + " r u nni ng versi on " + sy stem.os Vers i on );
con f i r m ( " Yo u a re : " + s ys te m . u s e r Na m e + " r un n i n g o n " + s y s t e m . m a ch i n e Na m e + " . " ) ;
Attributs
Attribut
Référence
Description
u s e r Nam e
« Attribut System userName », page 172
Nom de l’utilisateur actuel.
m a chi n e Na m e
« Attribut System machineName », page 172
Nom de l’ordinateur hôte.
o s Nam e
« Attribut System osName », page 172
Nom du système d’exploitation.
o s Ver s i o n
« Attribut System osVersion », page 172
Version du système d’exploitation.
Méthode
Référence
Description
c a l l Sy s te m ( )
« Méthode System callSystem() », page 171
Exécute une commande dans la ligne de commande du
système d’exploitation.
Méthodes
Méthode System callSystem()
s ys te m . c a l lSys te m ( c m d L i n e To Exe c u te ) ;
Description
Exécute une commande système comme si vous l’aviez tapée dans la ligne de commande du système d’exploitation.
Renvoie, le cas échéant, toute réponse que le système génère suite à l’exécution de cette commande.
Sous Windows, vous pouvez lancer des commandes à l’aide de l’option / c pour la commande c m d . exe , en
plaçant la commande à exécuter entre guillemets d’échappement (guillemets précédés d’une barre oblique
inversée : \ " . . . \ " ). Par exemple, le code suivant extrait l’heure actuelle et l’affiche à l’utilisateur :
v ar t i m e S t r = s ys te m . c a l lSys tem ( " c m d . e xe / c \ " t i m e / t \ " " ) ;
a l er t ( " Cu r ren t t i m e i s " + t i m e S t r );
Paramètres
c m d L i n e To Exec u te
Chaîne contenant la commande et ses paramètres.
Renvoi
Résultat généré par la commande.
171
Référence JavaScript
Objet System
172
Attribut System machineName
s ys te m . mach ineName
Description
Nom de l’ordinateur sur lequel After Effects est installé.
Type
Chaîne ; lecture seule.
Attribut System osName
s ys te m . osNa me
Description
Nom du système d’exploitation sous lequel After Effects fonctionne.
Type
Chaîne ; lecture seule.
Attribut System osVersion
s ys te m . osVersion
Description
Version du système d’exploitation local actuel.
Type
Chaîne ; lecture seule.
Attribut System userName
s ys te m . u s er Na m e
Description
Nom de l’utilisateur actuellement connecté sur le système.
Type
Chaîne ; lecture seule.
172
Référence JavaScript
Objet TextDocument
173
Objet TextDocument
n e w Tex t D o c u m e n t (d oc Te x t )
a pp. pro je c t .i tem ( in d e x) .layer(i n de x ). prop er t y ( "So urce Text").v alu e
Description
L’objet TextDocument stocke une valeur pour la propriété Source Text d’un TextLayer. Créez-le à l’aide du
constructeur, en stipulant la chaîne à y introduire.
Exemples
Ce script définit une valeur de texte source et affiche une alerte indiquant la nouvelle valeur :
v ar my Tex t D o c u m en t = n e w Tex t D o c u m en t( " Ha p p y C a ke" ) ;
my Tex t L ayer.p ro p e r t y( " S o u rc e Tex t " ) . s e t Val u e ( my Tex t D o c u m e n t ) ;
a l er t( my Tex t L ayer.p rop er t y ( " S ou rce Tex t" ) .va lue );
Ce script définit des valeurs d’image clé pour du texte qui affichent différents mots dans le temps :
v a r tex tPro p = myTex t L ayer.prop e r t y ( " S o u rce Text " ) ;
tex tPro p. se tVa lue At Ti m e ( 0 , n e w Tex t D o c u m e n t ( " Hap py " ) ) ;
tex tPro p. se tVa lue At Ti m e ( . 3 3 , n e w Tex tD o c u m e n t (" c a ke" ) );
tex tPro p. se tVa lue At Ti m e ( . 6 6 , n e w Tex tD o c u m e n t (" i s " )) ;
tex tPro p. se tVa lue At Ti m e ( 1 , n e w Tex t D o c u m e n t ( " yu m my! " )) ;
Attributs
Attribut
Référence
Description
tex t
« Attribut TextDocument text », page 173
Valeur Source Text du calque de texte.
Attribut TextDocument text
t e x t D o c u m e n t.text
Description
Valeur de texte pour la propriété Source Text du calque de texte.
Type
Chaîne ; lecture/écriture.
173
Référence JavaScript
Objet TextLayer
174
Objet TextLayer
a pp. pro je c t .i tem ( in d e x) .l ayer(i n de x )
Description
L’objet TextLayer représente un calque de texte dans une composition. Vous pouvez le créer à l’aide de la
méthode ad d Te xt de l’objet LayerCollection ; voir la section « Méthode LayerCollection addText() », page 95.
Pour accéder à cet objet dans la collection de calques d’un élément, vous pouvez utiliser son numéro d’index
ou encore une chaîne de nom.
• TextLayer est une sous-classe de AVLayer, qui est lui-même une sous-classe de Layer. Toutes les méthodes
et tous les attributs de AVLayer et de Layer sont disponibles lorsque vous utilisez TextLayer. Voir les
sections « Objet Layer », page 83 et « Objet AVLayer », page 39.
Propriétés AE
TextLayer ne définit pas d’attributs supplémentaires, mais possède, outre ceux hérités de AVLayer, les
propriétés AE et les groupes de propriétés suivants :
Tex t
S o u rce Tex t
Pa th O pt i on s
Pa th
Re verse Path
Per p en di c ul a r To Pa th
Force A l i g n m e n t
F i r s t Ma r g i n
L a s t Mar g i n
More O p t i on s
Anchor Point Grouping
Gro up in g Al i g n m e n t
F i l l & S t roke
In ter- C ha r a c ter Bl en d i n g
Anim ators
Attributs et propriétés non utilisés
Les propriétés Tim e Rem a p et Mot i on Tr a ckers , héritées de AVLayer, ne sont pas applicables aux calques de
texte. De même, les attributs relatifs à AVLayer ne peuvent pas être utilisés :
c a n S e t Ti m e Rem a p E n a bl e d
t i m eRem ap E n ab l e d
t r ackMat teTy p e
i s Tr a ck Ma tte
h as Tr a ck Ma tte
174
Exemples
Cette section présente des exemples de scripts inclus sur le DVD accompagnant le produit ; elle explique leur
rôle et décrit leur fonctionnement.
Loin d’être exhaustive, cette série d’exemples démontre cependant certaines des fonctionnalités de création de
script les plus complexes. Elle présente également certaines constructions type de programmation JavaScript
applicables à la création de script.
Pour obtenir davantage d’exemples fournis par Adobe ou d’autres utilisateurs d’After Effects, visitez le site
Adobe Studio Exchange à l’adresse http://share.studio.adobe.com, puis choisissez Scripts dans la zone Adobe
After Effects.
Save and increment (enregistrement et incrémentation)
Le script s ave _a n d _ in crem e n t . j s x enregistre automatiquement une nouvelle copie du projet After Effects
ouvert et incrémente un numéro à trois chiffres inclus dans son nom pour le distinguer de ses versions
précédentes.
Remarque : bien que la majeure partie de la fonctionnalité de ce script ait été remplacée par la fonction
d’enregistrement incrémentielle introduite dans After Effects 6.5, ce script reste inclus ici, car il utilise de
façon efficace les conditionnels, les fonctions et l’objet ExtendScript File.
Ce script effectue les tâches suivantes :
• Détermine si le projet ouvert a déjà été enregistré. Si le projet n’a pas été enregistré, affiche un message
d’alerte demandant à l’utilisateur d’enregistrer le projet et s’arrête.
• Si le projet a déjà été enregistré au moins une fois, définit des variables pour le nom du fichier et le numéro
et l’extension de fichier à y ajouter.
• Vérifie s’il existe un caractère de soulignement à une distance de quatre caractères de la fin du nom de fichier
actuel. Dans ce cas, considère que l’incrémenteur a été exécuté précédemment et incrémente la chaîne
numérique en cours, puis extrait le nom sans cette extension numérique.
• Une boucle d’incrémentation vérifie si le numéro est passé à deux ou trois chiffres (par exemple, si le numéro
a atteint ou dépassé « _010 » ou « _100 ») et attribue un zéro pour chacun dans le cas contraire.
• Crée un nouveau fichier utilisant le nom et l’extension mis à jour et affiche un message d’alerte informant
l’utilisateur du nouveau nom de fichier enregistré.
• Enregistre le projet sous le nouveau nom de fichier.
175
Exemples
Render named items (rendu des éléments nommés)
176
Render named items (rendu des éléments nommés)
Le script renderName dItems.j sx recherche dans le projet ouvert les compositions dont le nom comporte une
chaîne de texte donnée et les envoie à la file d’attente de rendu.
Ce script effectue les tâches suivantes :
• Vérifie si une chaîne par défaut pour le rendu a déjà été définie dans les préférences utilisateur. Le cas
échéant, cette dernière est définie en tant qu’invite utilisateur. Cette fonction est particulièrement pratique
lorsque vous recherchez toujours la même chaîne (par exemple, « FINAL » ou « CURRENT »). Sinon, un
nouveau s e c t i on Na m e et un nouveau ke y Nam e sont définis dans le fichier de préférences, ainsi qu’une
valeur de pseudo-élément pour la chaîne qui sera entrée par l’utilisateur.
• Affiche un message pour demander à l’utilisateur quelle chaîne de texte utiliser.
• Recherche le texte entré par l’utilisateur dans le projet et vérifie que l’élément qui contient ce texte est une
composition. Envoie toutes les compositions correspondantes à la file d’attente de rendu.
• Si l’utilisateur annule, le texte est indéfini. Sinon, enregistre le nouveau paramètre dans les préférences, en le
convertissant en minuscules par souci de cohérence (bien que la recherche ne tienne pas compte de la casse).
• Affiche le panneau File d’attente de rendu au premier plan pour permettre à l’utilisateur de spécifier les
emplacements d’enregistrement des nouveaux éléments de la file d’attente de rendu.
New render locations (nouveaux emplacements de rendu)
Le script n e w Re n d e r L o c a t ion s . j s x permet à l’utilisateur de sélectionner des éléments en file d’attente de rendu
et de leur attribuer une nouvelle destination de rendu.
Ce script effectue les tâches suivantes :
• Invite l’utilisateur à indiquer un nouveau dossier à utiliser comme destination de rendu.
• Vérifie que l’utilisateur a bien entré un nouvel emplacement (et n’a pas annulé), puis crée une boucle pour
chaque élément de file d’attente de rendu sélectionné et pour chaque module de sortie qu’il contient.
• Si un élément est placé en file d’attente, attribue un nouveau nom et un nouvel emplacement au rendu en
cours, et affiche un message d’alerte indiquant le nouveau chemin du fichier.
Smart import (importation avancée)
Le script s m ar tImp or t.j sx permet à l’utilisateur d’importer la totalité du contenu imbriqué d’un dossier
simplement en le sélectionnant. Il tente de détecter si chaque élément est une image fixe, un métrage mobile
ou une séquence d’images. L’utilisateur doit encore effectuer d’autres choix au moyen de boîtes de dialogue,
comme le choix du calque d’une image multicalque (un fichier PSD, par exemple) à importer.
Ce script effectue les tâches suivantes :
• Invite l’utilisateur à indiquer un dossier dont le contenu doit être importé et vérifie que l’utilisateur choisit
bien un dossier et n’annule pas le message.
• Définit une fonction, p ro ce s s Fo ld e r ( ) , pour importer chaque fichier dans le dossier choisi à l’aide de
plusieurs fonctions d’assistance.
• Définit une fonction d’assistance, tes tForS e quen ce () , pour vérifier si un fichier donné fait partie d’une
séquence. Celle-ci utilise des expressions régulières, lesquelles constituent un type spécial de JavaScript
destiné à réduire le nombre d’étapes requises pour évaluer une chaîne.
La première vérifie la présence de chiffres séquentiels à tout endroit du nom de fichier. La suivante s’assure
que les fichiers séquentiels ne sont pas d’un type ne pouvant pas être importé en tant que séquence (fichiers
d’image mobiles). La fonction vérifie ensuite les fichiers adjacents pour savoir s’il existe une séquence. Cette
vérification s’arrête à dix fichiers pour limiter le temps de traitement.
176
Exemples
Render and e-mail (rendu et message électronique)
177
Si la recherche d’une chaîne numérique ne génère aucun résultat, le script considère qu’il n’y a pas de
séquence d’images et vérifie la présence d’un tableau constitué de la chaîne correspondante et de son
emplacement dans le nom de fichier.
Si tous les fichiers font partie d’une séquence numérique, le script conclut qu’il y a une séquence et renvoie
le premier fichier de cette séquence.
• Définit une fonction d’assistance pour afficher des messages d’erreur en cas de problème avec tout fichier
que le script tente d’importer.
• Définit une fonction d’assistance pour importer toute séquence d’images détectée à l’aide de
tes tForS e quen ce () . Le script contient une option placée en commentaire permettant de forcer l’ordre
alphabétique dans les séquences. Pour forcer l’ordre alphabétique, annulez le statut de commentaire de
la ligne i m p o r t O p ti o n s .force A lp h a b e ti c a l = t r u e .
• Appelle la fonction principale, proces sFol der () .
Render and e-mail (rendu et message électronique)
Le script ren d e r _ a n d _ e m a i l . j s x effectue le rendu de tous les éléments en file d’attente dans un projet ouvert et
envoie un rapport par courrier électronique signalant le moment où le rendu s’est achevé. Il utilise deux autres
scripts, à savoir : em ai l _ m e tho d s. js x (pour envoyer le courrier électronique correctement) et e m a i l _ s e t up. j s x
(qui établit l’expéditeur, le destinataire et le serveur de messagerie).
Ce script effectue les tâches suivantes :
• Vérifie les conditions d’exécution du script. Un projet ouvert contenant au moins un élément en file
d’attente est requis.
• Vérifie si les paramètres de courrier électronique sont déjà enregistrés dans les préférences. Sinon, le script
em ail_se tu p.j sx est exécuté. L’utilisateur doit alors indiquer la passerelle de messagerie, ainsi que les
adresses de l’expéditeur et du destinataire. (Si vous devez modifier des paramètres enregistrés, vous pouvez
exécuter le script pour créer des paramètres venant remplacer les paramètres existants.)
• Effectue le rendu des éléments de la file d’attente de rendu.
• Une fois le rendu terminé, crée une chaîne de texte pour le message électronique. Cette chaîne contient
l’heure de début du rendu, l’heure du rendu de chaque élément de la file d’attente et la durée totale du
rendu.
• Envoie le message, en utilisant les paramètres (serveur, par exemple) du script em ai l _ m e tho d s. js x .
• Affiche une erreur si, pour une raison quelconque, le message ne peut pas être envoyé.
Un script d’assistance, e m a il _ m e t ho ds . j sx , crée un objet e-mail à l’aide de l’objet ExtendScript Socket.
Pour plus d’informations sur cet utilitaire, consultez le manuel Creative Suite 3 JavaScript Tools Guide.
Un autre script d’assistance, ema i l_se tu p.j sx , invite l’utilisateur à indiquer le nom du serveur, l’expéditeur et
le destinataire du message électronique, lesquels sont enregistrés en tant que paramètres. Vous pouvez
exécuter ce script de manière autonome chaque fois que vous souhaitez modifier les paramètres. Ce script
illustre bien la façon de créer des paramètres enregistrés dans les préférences à des fins exclusives de création
de script (et non pour la modification de paramètres de préférences After Effects existants).
177
ExemplesConvert selected properties to markers (conversion de propriétés sélectionnées en repères)
178
Convert selected properties to markers (conversion de propriétés
sélectionnées en repères)
Le script Conve r t S e l e c t e d Prop e r t i e s to Ma r ke r s . j s x parcourt les propriétés de calque actuellement
sélectionnées dans le panneau Montage et convertit la valeur de chaque propriété à chaque instant d’image
en un signal de départ vidéo Flash de type événement inclus dans un repère.
Ce script ajoute pour chaque propriété sélectionnée un repère temporel de calque sur le calque au même instant
que les images clés. Chaque repère est associé à un signal de départ vidéo Flash de type événement, lui-même
associé à un paramètre dont le nom et la valeur correspondent à ceux de la propriété à cet instant. Si la propriété
sélectionnée contient une expression, un repère est créé pour chaque image, avec échantillonnage des valeurs à
chaque image.
Remarque : ce script ne convertit pas les propriétés impliquant des types de valeurs complexes, telles que la propriété
Tracé d’un tracé de peinture, la propriété Courbes d’un effet Courbe ou une propriété de dégradé.
Lors du rendu de la composition en vidéo Flash, tous les repères contenant des données de signal de départ
sont convertis en signaux de départ vidéo Flash.
178
Liste des objets After Effects
Cette sortie de code récapitule tous les objets JavaScript (classes instanciables) et les types énumérés définis
pour After Effects CS3.
= == == === == == === == === == == === == === == == === == === == == === == == === == === == == === ==
AlphaMo de enum
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - A l p h a Mo de .I G N O R E
A l p h a Mo de .P R E M U LT I P L I E D
A l p h a Mo de .S T RA I G H T
= == == === == == === == === == == === == === == == === == === == == === == == === == === == == === ==
App li c a ti o n o b j e c t
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - a c t iva te () n o ret ur n
b e g i n Su ppres s Di a l og s () n o re tur n
b e g i nUndo Group(st r ing u n doName ) no re tur n
b ui l d Na m e : st r i n g : rea d On ly
b u i l d Nu m b e r : i n te g e r : rea d O n l y
c a n ce l Tas k ( i n t e g e r t a s k I D ) n o re t u r n
e n d Su ppre s s Di a l o g s (b o o le an s h ow A l e r t ) n o re t u r n
e n d Un d o Grou p ( ) n o re t u r n
endWatchFolder() n o re tu r n
e x it Af ter L a u n ch An d Eva l : b o o l e a n : rea d / w r i te
ex it Co de : in te ger : rea d/ w r ite
f i n d Menu Com m a n d Id( ) re t u r n s i n t e g e r
i s Pro f e s s i o n a l Ver s i o n : b oo l e a n : re a d O n ly
i s Ren d e r E n g i n e : b o o l e a n : rea d O n l y
i s UISupp re ss ed : b oo l ean : re ad O n ly
i s Watch Fo ld er : b o o l e an : rea d O n l y
l a n g u a g e : L a n g u a ge : rea d O n l y
m em or y In Use : num b e r : rea d O n l y
n ewPro je ct() no re tur n
o p e n ( [ F il e fi l e ] ) re tu r n s Pro je c t
o p e n Tem p la te( F i l e f il e ToO p e n Wi t h Tem p l a t e S e m a n ti c s ) n o re t u r n
p a r se Sw atch F il e (F i l e s w atch F il e ) ret u r n s Swa tchO b je c t
pa useWatch Folder(b oo lean do Pause) no re tur n
p ro je c t : Pro j e c t : re ad O n ly
p ur g e(Purg e Targ e t tar g et ) n o re tu r n
qu i t( ) no re tu r n
s ave Pro je c tO n Cr as h : b o o l e a n : rea d/ w r i te
s ch e du l e Tas k (s t r i n g To Exe c u te, fl o a t de l ay, b o ol ea n rep ea t) ret ur n s ta sk I D
s e tMem or y Us ag eL i m i t s( fl o a t i m a ge Ca che Percent , f l o a t m a xi m u m Me m o r y Pe rcen t ) n o ret u r n
s e tS avePreferen ce sO n Q ui t( b o ol ea n doS ave ) n o re tu r n
s e tt i n g s : S e tt i n g s : re ad O n ly
179
Liste des objets After Effects
180
ver s i on : s t r i n g : re a d O n ly
w a tch Fo ld e r ( F il e fi l e ) n o ret u r n
on E r ror( s t r in g er ror St r i n g , s t r i n g s e ver it y ) n o re tur n
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
AVL ayer ob j ec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - (inte g er proper t y In dex) ret ur n s Prop er t y B a se
( st r i n g p ro p e r t y Na m e ) re tu r n s Prop er t y B as e
a c t ive : b oo l ean : re ad O n ly
a c t iveAtTim e(f lo at at Ti me ) re tur n s b oole an
a d dProp er t y (s t r i ng prop er t y Name ) re tur n s Prop er t y Ba s e
a d ju s t m e n t L ayer : b o o l e an : rea d / w r i te
a pp ly Pres e t( s t r in g pre s e t Na m e ) n o re tur n
a udio Ac tive : bo olea n : rea dO n ly
a ud io Ac tiveAtTi m e( flo a t at Time ) re tur n s b oo le an
a ud io E n ab l ed : b oo l ean : re ad / w r ite
a utoOr i e n t : AutoO r i e n t Ty p e : rea d/ w r i te
b l endi ngMo de : Bl endi ngMo de : rea d/w r i te
c al c u l ate Tr a n s for m From Poi n t s( Ar r ay [top, l eft ], Ar r ay [ top,r i g ht] , Ar r ay [b ot tom ,r i g h t] )
re tu r n s O b je c t w i th t r a n sf or m prop er t ie s s e t
c an Add Prop er t y (s t r i n g prop er t y Name ) re tur n s b ool e an
can S et Col l ap se Tr ans for ma tion : b oo l ean : re ad O n ly
can S et Ena ble d : bo olea n : rea dO n ly
c a n S e t Ti m e Rem a p E n a bl e d : b o o l e a n : rea d O n l y
co l l ap s e Tr an s fo r m a t i on : b o o l e a n : rea d/ w r i te
com m e n t : s t r i n g : rea d / w r i te
con t a i n i n g Com p : Com p Ite m : rea d O n l y
cop y ToCom p ( Com p Item i n toC om p) n o ret u r n
du pl i c ate( ) re tur n s AV Layer
effe ct sAct ive : b oo l ean : re ad/w r ite
e l id ed : b ool e an : rea d On ly
ena ble d : bo olea n : rea d/w r i te
f r a m e B l e n d i n g : b o o l e a n : rea dO n l y
f r a m e B l e n d i n g Ty p e : Fr a m e B l e n d i n g Ty p e : rea d / w r i te
gu ideLayer : bo olea n : rea d /w r i te
h as Au di o : b o ol ea n : rea dO n l y
h as Tr a ck Ma tte : bo olea n : rea d Only
h as Vi de o : b oo l ean : re ad O n ly
h eig h t : f l o at : rea dO n l y
i n Poi n t : fl o a t : rea d / w r i te
i n dex : i n te g e r : rea dO n l y
i s E ff e c t : b o o l e a n : re a d O n ly
i s Mas k : b o o l e a n : rea dO n l y
i s Mod i fi e d : b o o l e a n : rea dO n ly
i s Na m e Fro m S o u rce : b o o l e a n : rea d O n l y
i s Na m e S e t : b o o l e a n : rea d O n ly
i s Tr a ck Ma tte : b o ol ea n : rea d On l y
l o cke d : b o o l e a n : rea d/ w r i te
m a tch Na m e : s t r i n g : rea d O n l y
m o t i o n B lu r : b o o l e an : rea d / w r i te
moveAfter(Layer ot her L ayer) no re tur n
180
Liste des objets After Effects
181
m oveB e f ore( L ayer o t h er L ayer ) n o re t u r n
m oveTo( in te g er in d ex ) n o ret u r n
m oveToB e g i n n i n g ( ) n o re t u r n
moveToEnd() no re tu r n
n a m e : s t r i n g : rea d / w r i te
nu l l L aye r : b o o l e a n : rea d O n l y
nu m Prop er t i e s : i n te g e r : rea d On l y
o u t Po i n t : f l o at : rea d/ w r i te
parent : Layer : re ad/w r ite
p a ren t Pro p e r t y : Pro p e r t y Gro u p : rea d O n l y
preser veTr a n sparency : b oole an : rea d /w r i te
prop er t y ( i nte g er prop er t y Index) ret ur n s Prop er t yB a se
prop er t y (st r ing proper t y Na me) ret ur n s Prop er t y B a se
prop er t y D ep t h : i n te ger : rea d On ly
prop e r t y Gro u p ([ i n te g e r cou n tUp ]) ret u r n s Prop e r t y Gro u p
prop er t y Ty p e : Prop er t y Ty p e : rea d O n ly
qua l it y : LayerQu alit y : rea d /w r i te
remove() no re tu r n
rep l a c e S o u rce ( Ite m n ew S o urce , b o o l e a n f i x Ex p res s i on s ) n o ret ur n
s e l e c t e d : b o o l e an : rea d / w r i te
s e l e c t e d Prop e r t i e s : A r r ay of Pro p e r t yB a s e : rea dO n l y
s et Paren t Wi th Jum p ( L ayer n e wPa ren t ) n o re tu r n
s hy : b o o l e an : rea d / w r i te
s o l o : b oo l e an : re ad / w r ite
s ource : AVItem : rea d On ly
s o u rce Rec t AtTi m e ( f l o a t a t Tim e, b o o l e a n i n cl u de E x te n t s)
re tu r n s O b je c t w i th fl o at prop er t i es : top; l eft ; w i dt h; hei g ht
s ta r t Ti m e : fl o a t : rea d / w r i te
s t retch : f l o at : rea d/w r i te
t h ree DL ayer : b o o l e a n : rea d / w r i te
t hree DPer Cha r : b oo le an : re ad / w r i te
t i m e : f l o at : rea d O n l y
t i m e Rem a p E n a b l e d : b oo l e a n : re a d / w r it e
t r ac kMatteTy p e : Tr a ck Ma tte Ty p e : rea d/ w r i te
w i dt h : fl o at : rea d On l y
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
Bl e n d in g Mod e e nu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Bl e n d in g Mod e .AD D
Bl e n d in g Mod e .AL PH A _ A DD
Bl e n d in g Mod e .C L A S S I C _ C O LOR _ BUR N
Bl e n d in g Mod e .C L A S S I C _ C O LOR _ D O D G E
Bl e n d in g Mod e .C L A S S I C _ D I F F E R E N C E
Bl e n d in g Mod e .C O LOR
Bl e n d in g Mod e .C O LOR _ BUR N
Bl e n d in g Mod e .C O LOR _ D O D G E
Bl e n d in g Mod e .DA N C I N G _D I S S OLV E
Bl e n d in g Mod e .DA R K E N
Bl e n d in g Mod e .DA R K E R _ C OLO R
Bl e n d in g Mod e .D I F F E R E N C E
Bl e n d in g Mod e .D I S SO LVE
181
Liste des objets After Effects
182
Bl e n d in g Mod e .E XC LU S I ON
Bl e n d in g Mod e .H A R D _ L I G HT
Bl e n d in g Mod e .H A R D _ M I X
Bl e n d in g Mod e .H UE
Bl e n d in g Mod e .L I G H T E N
Bl e n d in g Mod e .L I G H T E R _ C O LOR
Bl e n d in g Mod e .L I N E A R _ BU R N
Bl e n d in g Mod e .L I N E A R _ D O D G E
Bl e n d in g Mod e .L I N E A R _ L I G H T
Bl e n d in g Mod e .LU M I N E S C E N T _ PR E M U L
Bl e n d in g Mod e .LU M I N O S I T Y
Bl e n d in g Mod e .M ULT I PLY
Bl e n d in g Mod e .N O R M A L
Bl e n d in g Mod e .OV E R L AY
Bl e n d in g Mod e .PI N _ L I G H T
Bl e n d in g Mod e .S AT U RAT I O N
Bl e n d in g Mod e .S C R E E N
Bl e n d in g Mod e .S I L H OU E T E _ A L PH A
Bl e n d in g Mod e .S I L H OU E T T E _ LUM A
Bl e n d in g Mod e .S O F T _ L I G HT
Bl e n d in g Mod e .S T E N C I L _ A L PHA
Bl e n d in g Mod e .S T E N C I L _ LUM A
B l e n d in g Mod e . V I V I D _ L I G H T
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
C l o s e O p t i o n s e nu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - C l o s e O p t i o n s . D O _ N OT _ S AV E _ C H A N G E S
C l o s e O p t i o n s . PRO M P T _ TO _ S AVE _ C H A N G E S
C l o s e O p t i o n s . SAV E _ C H A N G E S
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
Com p Ite m o b j e c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a c t iveC a m e r a : L ayer : rea d O n l y
a pp ly Pres e t( s t r in g pre s e t Na m e ) n o re tur n
b g Co lor : Ar r ay of fl o a t : rea d / w r i te
com m e n t : s t r i n g : rea d / w r i te
d i s p l ay S t a r t Ti m e : f l o a t : rea d / w r i te
d r a ft 3 d : b o o l e a n : rea d / w r i te
du pl i c ate( ) re tur n s Comp Item
du r at i o n : f l o at : rea d/ w r i te
fo otageMissin g : bo olea n : rea d Only
f r a m e B l e n d i n g : b o o l e a n : rea d/ w r i te
f r a m eD ur a t i on : fl o a t : rea d / w r i te
f r a m eRa te : fl o a t : rea d / w r i te
h as Au di o : b o ol ea n : rea dO n l y
h as Vi de o : b oo l ean : re ad O n ly
h eig h t : i n teg er : re ad / w r i te
h id e S hy L aye r s : b o o l e an : rea d / w r i te
i d : i n te g e r : rea d On l y
l ayer (i n t e g e r l ayer In dex ) re t u r n s L ayer
l ayer (s t r i n g l ayer Na m e ) re t u r n s L ayer
182
Liste des objets After Effects
183
layer (Layer ot herLayer, inte ger re lat iveIn dex) ret ur n s Layer
layers : LayerCol lec t ion: rea dO n ly
m o t i o n B lu r : b o o l e an : rea d / w r i te
n a m e : s t r i n g : rea d / w r i te
nu mLayers : inte ger : rea d Only
parentFolder : Fo lderItem : rea d /w r i te
p i xel As p e c t : f l o at : rea d/ w r i te
preser veNeste d Fr a m eRa te : bo olea n : rea d/w r i te
preser veNeste d Resolut i on : bo olea n : rea d /w r i te
prox ySou rce : Fo ota g eSource : rea dO n ly
remove() no re tu r n
renderer : st r in g : rea d/w r i te
renderers : Ar r ay of st r i ng: rea d Only
res o lut i o n Fa c to r : A r r ay of i n te g e r : rea d / w r i te
s e l e c t e d : b o o l e an : rea d / w r i te
s e l e c t e d L ayer s : A r r ay o f L ayer : rea d O n l y
s e l e c t e d Prop e r t i e s : A r r ay of Pro p e r t yB a s e : rea dO n l y
s e t Proxy ( F i l e prox y F i l e ) n o re t u r n
s e t Proxy ToNon e ( ) n o ret u r n
s e t Proxy Wi thP l a ce h o l der ( s t r in g n am e , i n te g e r w id t h , i n te g e r h e i g h t, f l o at f r am e R a te , f l o at dur at i o n )
n o re t u r n
s et Proxy Wi thS e quen ce( F il e prox y F il e , b o ol ea n forceAl p hab et i c al ) n o re tur n
s e t Proxy Wi thS o l id ( Ar r ay O fF l o a t co lor, s t r i n g n a m e , i n te g e r w i d th , i n te g e r h e i g h t ,
fl o at p ixel As p e c R at i o ) n o re tur n
s hut terAn g l e : i n te g er : rea d / w r i te
s hut terP ha se : i n te g er : rea d / w r i te
t i m e : f l o at : rea d / w r i te
t y p e Na m e : s t r i n g : rea d O n ly
u s e Prox y : b o o l e a n : rea d / w r i te
u s e dIn : A r r ay o f Com p Ite m : rea d O n l y
w i dt h : in te ger : rea d/ w r i te
wor k Area Du r a ti on : f l o at : rea d/ w r i te
wor k Area St ar t : flo a t : rea d /w r i te
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
F i e l d S e p a r a t i o n Ty p e e nu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - F i e l d S e p a r a t i o n Ty p e . LOW E R _ F I E L D _ F I R S T
F i e l d S e p a r a t i o n Ty p e . O F F
F i e l d S e p a r a t i o n Ty p e . U PPE R _ F I E L D _ F I R ST
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
F i l e S o u rce o b j e c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a lp ha Mod e : Al ph aMo de : rea d / w r i te
con f o r m Fr a m e R a te : f l o a t : rea d / w r i te
d i s p l ay Fr a m e R ate : f l o at : re a d O n ly
f i e l d S e p a r a t i on Ty p e : F i e l d S e p a r a t i on Ty p e : rea dO n l y
f i le : File : rea d Only
g u e ss A l ph aMo de( ) n o re t u r n
g u e ss Pu l l dow n (Pul l dow n Me t h o d p u l l dow n Me t h o d) n o re t u r n
h a s Al p h a : b o o l e a n : rea dO n l y
h ig hQ ua l it y F ie l dS e pa r a ti on : b oo l ean : re ad / w r ite
183
Liste des objets After Effects
184
inver t Alpha : bo olea n : rea d /w r i te
i s St i l l : b o o l e a n : rea dO n l y
l o op : i n te g er : rea d / w r i te
m i s s i n g Fo ot a g e Pat h : s t r i n g : rea d O n l y
na t iveFr am eRa te : flo at : rea d Only
premu l Color : Ar r ay of f l oa t : re ad /w r ite
rel o a d () n o ret ur n
rem ovePu l l dow n : Pul l dow n P ha se : re ad O n ly
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
FolderItem obj ec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - com m e n t : s t r i n g : rea d / w r i te
i d : i n te g e r : rea d On l y
i te m ( i n te g e r i te m In d e x ) ret ur n s Ite m
i te m s : Ite m Col l e c t i o n : rea dO n l y
n a m e : s t r i n g : rea d / w r i te
nu mItem s : in te ger : re adOnly
parentFolder : Fo lderItem : rea d /w r i te
remove() no re tu r n
s e l e c t e d : b o o l e an : rea d / w r i te
t y p e Na m e : s t r i n g : rea d O n ly
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
Foo ta ge Item ob je c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - com m e n t : s t r i n g : rea d / w r i te
du r at i o n : f l o at : rea dO n l y
f i le : File : rea d Only
fo otageMissin g : bo olea n : rea d Only
f r a m eD ur a t i on : fl o a t : rea d On ly
f r a m eRa te : fl o a t : rea d On l y
h as Au di o : b o ol ea n : rea dO n l y
h as Vi de o : b oo l ean : re ad O n ly
h eig h t : i n teg er : re ad / w r i te
i d : i n te g e r : rea d On l y
m a in S o u rce : Fo o t a g e S o urce : re a d O n ly
n a m e : s t r i n g : rea d / w r i te
parentFolder : Fo lderItem : rea d /w r i te
p i xel As p e c t : f l o at : rea d/ w r i te
prox ySou rce : Fo ota g eSource : rea dO n ly
remove() no re tu r n
rep l a ce ( F il e p rox y F il e ) n o re t u r n
replaceWit hP laceho lder( st r ing na me, inte ger w i dth , inte ger he ig ht , flo at fr ameR ate, flo at dur a t i on )
n o re t u r n
repl a c e Wi t h S e qu e n c e ( F i l e p rox y F i l e , b o o l e a n f o rce A l p h ab e t i c a l ) n o ret ur n
rep l a ce Wi th S o l i d( Ar r ay O f F l o a t col o r, st r i n g n a m e , i n teg e r w i dt h , i n te g e r h e i g h t, f l o at p ixel As p e c R at i o )
n o re t u r n
s e l e c t e d : b o o l e an : rea d / w r i te
s e t Proxy ( F i l e prox y F i l e ) n o re t u r n
s e t Proxy ToNon e ( ) n o ret u r n
s e t Proxy Wi thP l a ce h o l der ( s t r in g n am e , i n te g e r w id t h , i n te g e r h e i g h t, f l o at f r am e R a te , f l o at dur at i o n )
n o re t u r n
184
Liste des objets After Effects
185
s et Proxy Wi thS e quen ce( F il e prox y F il e , b o ol ea n forceAl p hab et i c al ) n o re tur n
s e t Proxy Wi thS o l id ( Ar r ay O fF l o a t co lor, s t r i n g n a m e , i n te g e r w i d th , i n te g e r h e i g h t ,
fl o at p ixel As p e c R at i o ) n o re tur n
t i m e : f l o at : rea d O n l y
t y p e Na m e : s t r i n g : rea d O n ly
u s e Prox y : b o o l e a n : rea d / w r i te
u s e dIn : A r r ay o f Com p Ite m : rea d O n l y
w i dt h : in te ger : rea d/ w r i te
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
Im p o r tAs Ty p e e nu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Im p o r t As Ty p e .C O M P
Im p o r t As Ty p e .C O M P _ C RO PPE D _ L AYE R S
Im p o r t As Ty p e .F O OTAG E
Im p o r t As Ty p e .P ROJ E C T
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
Im por tO p tions ob jec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - n ew Im p or t O p t i on s( F i le fi l eToIm p or t ) re tu r n s Im p or tO p t i on s
c an Im p or tAs ( Im p o r t AsTy p e a sTy p e ) ret u r n s b o o l e a n
f i le : File : rea d /w r i te
force Al p h a b e t i c a l : b o o l e a n : rea d/ w r i te
i m p o r t As : Im p o r t AsTy p e : re ad / w r ite
sequ ence : bo olea n : rea d/w r i te
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
Ite m Col l e c t i o n o b j e c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a d dComp ( st r i ng na me, inte ger w i d th , i n te ger he ig ht , f l o at pi xe l Asp ec tR at i o, f l o at dur a t i on ,
f l o at f r am e R a te ) re tu r n s Com pIte m
a d dFol der( s t r in g name ) re tu r n s Fol d er Item
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
Ke y fr am e E as e o b j ec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - n e w Ke y fr a m e E as e ( fl o at s p e e d , f l o at i n f lu en ce) ret ur n s Ke y f r a m eE a se
i n f lu e n ce : f l o at : rea d/ w r i te
s p e ed : f l o at : rea d/w r i te
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == ==
Ke y fr am eIn ter p o la t i on Ty p e enum
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Ke y fr am eIn ter p o la t i on Ty p e .BE Z I E R
Ke y fr am eIn ter p o la t i on Ty p e .HO L D
Ke y fr am eIn ter p o la t i on Ty p e .L I N E A R
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
L a n g u a ge e nu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - L a n g u a ge . E N G L I S H
L a n g u a ge . F R E N C H
L a n g u a ge . G E R M AN
L a n g u a ge . I TAL I A N
L a n g u a ge . JA PA N E S E
L a n g u a ge . S PAN I S H
185
Liste des objets After Effects
186
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
C am er a L ayer ob je c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - (inte g er proper t y In dex) ret ur n s Prop er t y B a se
( st r i n g p ro p e r t y Na m e ) re tu r n s Prop er t y B as e
a c t ive : b oo l ean : re ad O n ly
a c t iveAtTim e(f lo at at Ti me ) re tur n s b oole an
a d dProp er t y (s t r i ng prop er t y Name ) re tur n s Prop er t y Ba s e
a d ju s t m e n t L ayer : b o o l e an : rea d O n ly
a pp ly Pres e t( s t r in g pre s e t Na m e ) n o re tur n
a utoOr i e n t : AutoO r i e n t Ty p e : rea d/ w r i te
c an Add Prop er t y (s t r i n g prop er t y Name ) re tur n s b ool e an
can S et Ena ble d : bo olea n : rea dO n ly
com m e n t : s t r i n g : rea d / w r i te
con t a i n i n g Com p : Com p Ite m : rea d O n l y
cop y ToCom p ( Com p Item i n toC om p) n o ret u r n
du pl i c ate( ) re tur n s Camer aLayer
e l id ed : b ool e an : rea d On ly
ena ble d : bo olea n : rea d/w r i te
h as Vi de o : b oo l ean : re ad O n ly
i n Poi n t : fl o a t : rea d / w r i te
i n dex : i n te g e r : rea dO n l y
i s E ff e c t : b o o l e a n : re a d O n ly
i s Mas k : b o o l e a n : rea dO n l y
i s Mod i fi e d : b o o l e a n : rea dO n ly
i s Na m e S e t : b o o l e a n : rea d O n ly
l o cke d : b o o l e a n : rea d/ w r i te
m a tch Na m e : s t r i n g : rea d O n l y
moveAfter(Layer ot her L ayer) no re tur n
m oveB e f ore( L ayer o t h er L ayer ) n o re t u r n
m oveTo( in te g er in d ex ) n o ret u r n
m oveToB e g i n n i n g ( ) n o re t u r n
moveToEnd() no re tu r n
n a m e : s t r i n g : rea d / w r i te
nu l l L aye r : b o o l e a n : rea d O n l y
nu m Prop er t i e s : i n te g e r : rea d On l y
o u t Po i n t : f l o at : rea d/ w r i te
parent : Layer : re ad/w r ite
p a ren t Pro p e r t y : Pro p e r t y Gro u p : rea d O n l y
prop er t y ( i nte g er prop er t y Index) ret ur n s Prop er t yB a se
prop er t y (st r ing proper t y Na me) ret ur n s Prop er t y B a se
prop er t y D ep t h : i n te ger : rea d On ly
prop e r t y Gro u p ([ i n te g e r cou n tUp ]) ret u r n s Prop e r t y Gro u p
prop er t y Ty p e : Prop er t y Ty p e : rea d O n ly
remove() no re tu r n
s e l e c t e d : b o o l e an : rea d / w r i te
s e l e c t e d Prop e r t i e s : A r r ay of Pro p e r t yB a s e : rea dO n l y
s et Paren t Wi th Jum p ( L ayer n e wPa ren t ) n o re tu r n
s hy : b o o l e an : rea d / w r i te
s o l o : b oo l e an : re ad / w r ite
s ta r t Ti m e : fl o a t : rea d / w r i te
186
Liste des objets After Effects
187
s t retch : f l o at : rea d/w r i te
t i m e : f l o at : rea d O n l y
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
L ayer Co l l e c t i on o b j e c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a d d( AVIte m t he Item ,
[ fl o a t du r a ti o n ] ) re tur n s AV L ayer
a d dCamer a( st r i ng na me,
Ar r ay Of F l o at cen terPoi n t ) re tur n s L ayer
a d dL i g h t (s t r i n g n a m e,
Ar r ay Of F l o at cen terPoi n t ) re tur n s L ayer
a d dNu l l ( [f l o a t dur at i o n ]) ret u r n s AVL ayer
a d dS h a p e ( ) re tu r n s L ayer
a d d S o l i d ( Ar r ay O f F l o at col o r, s t r i n g n a m e , i n te ger w i dt h, inte ger heig ht, flo a t pixelAspe ct Ra t io,
[ f l o at dur a t i on ] ) re tu r n s AVL ayer
a d dTex t( [ Tex t D oc um en t tex tD o c] ) re tu r n s AVL ayer
a d dTex t( s t r ing tex t ) re tur n s AVL ayer
by Na m e ( s t r i n g n a m e ) ret u r n s L ayer
pre co m p o s e ( Ar r ay O fIn teg e r l ayer In d ice s , s t r in g n a m e , [ b o ol e a n m ove A l l At t r i but e s ])
re tu r n s C om p Item
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
LayerQu alit y enum
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - LayerQu alit y.B EST
L ayer Q u al i t y. D RA F T
L ayer Q u al i t y. W I R E F RA M E
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = =
LogTy p e enu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - L o g Ty p e . E R RO R S _ A N D _ PE R _ F RA ME _ I N F O
L o g Ty p e . E R RO R S _ A N D _ S E T T I N G S
L o g Ty p e . E R RO R S _ O N LY
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
Ma r kerVa lue ob je c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - n e w Ma r ke r Va lue ( s t r i n g com m e n t , [ s t r i n g cha p ter ] , [ st r in g u r l] , [ s t r in g fr am e Targ e t] )
re tu r n s Mar kerValue
cha p ter : st r i n g : rea d / w r i te
com m e n t : s t r i n g : rea d / w r i te
cue PointName : st r i ng : re ad/w r ite
e ven t Cue Poi n t : b o o l e an : rea d / w r i te
f r a m eTa rg et : s t r i n g : rea d/ w r i te
ge tPa r am eters() re tur n s ob jec t w i t h prop er t i es se t
s et Par ame ters ( O b j ec t ke yValu ePairs ) no re t ur n
ur l : s t r i ng : rea d /w r i te
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
Ma sk Mo de enu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Ma sk Mo de. ADD
Ma sk Mo de. DA RK E N
Ma sk Mo de. DIF F E R E NCE
187
Liste des objets After Effects
188
Ma sk Mo de. I NTERS E CT
Ma sk Mo de. L IG HTE N
Ma sk Mo de. N ONE
Ma sk Mo de. SU BTRAC T
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
Ma skMot i onBlur en um
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Ma sk Mot i on Blur.O F F
Ma sk Mot i on Blur.O N
Ma sk Mot i on Blur.S A ME _ AS _ L AYE R
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
Ma skProper t yGroup obj ec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - (inte g er proper t y In dex) ret ur n s Prop er t y B a se
( st r i n g p ro p e r t y Na m e ) re tu r n s Prop er t y B as e
a c t ive : b oo l ean : re ad O n ly
a d dProp er t y (s t r i ng prop er t y Name ) re tur n s Prop er t y Ba s e
c an Add Prop er t y (s t r i n g prop er t y Name ) re tur n s b ool e an
can S et Ena ble d : bo olea n : rea dO n ly
co lor : Ar r ay of fl o a t : rea d / w r i te
du pl i c ate( ) re tur n s Ma s kProp er t y Group
e l id ed : b ool e an : rea d On ly
ena ble d : bo olea n : rea dO n ly
i nver te d : b o o l e an : rea d / w r i te
i s E ff e c t : b o o l e a n : re a d O n ly
i s Mas k : b o o l e a n : rea dO n l y
i s Mod i fi e d : b o o l e a n : rea dO n ly
l o cke d : b o o l e a n : rea d/ w r i te
ma sk Mo de : Mas kMo de : rea d/w r i te
m a s k Mot i o n B lu r : Mas k Mot i on Bl u r : rea d / w r i te
m a tch Na m e : s t r i n g : rea d O n l y
m oveTo( in te g er in d ex ) n o ret u r n
n a m e : s t r i n g : rea d / w r i te
nu m Prop er t i e s : i n te g e r : rea d On l y
p a ren t Pro p e r t y : Pro p e r t y Gro u p : rea d O n l y
prop er t y ( i nte g er prop er t y Index) ret ur n s Prop er t yB a se
prop er t y (st r ing proper t y Na me) ret ur n s Prop er t y B a se
prop er t y D ep t h : i n te ger : rea d On ly
prop e r t y Gro u p ([ i n te g e r cou n tUp ]) ret u r n s Prop e r t y Gro u p
prop er t y Index : i n te ger : rea d Onl y
prop er t y Ty p e : Prop er t y Ty p e : rea d O n ly
remove() no re tu r n
rotoB ezier : bo olean : rea d/w r ite
s e l e c t e d : b o o l e an : rea d / w r i te
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == =
O MCol l e c t i o n o b j e c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a d d( ) re tu r n s O ut p ut Mo dul e
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
O ut put Mod ul e ob j ec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - -
188
Liste des objets After Effects
189
a p p ly Te m p l a t e ( s t r i n g t e m p l a teNam e) n o re t u r n
f i le : File : rea d /w r i te
n a m e : s t r i n g : rea d O n l y
p o s t Ren de r Ac t i o n : Pos t Ren de r Ac t i o n : rea d/ w r i te
remove() no re tu r n
s aveAs Tem p l a t e ( s t r i n g t e m p l a teNam e) n o re t u r n
tem p l a tes : Ar r ay of s t r in g : rea dO n ly
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
Placeho l derSou rce obj ec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a lp ha Mod e : Al ph aMo de : rea d / w r i te
con f o r m Fr a m e R a te : f l o a t : rea d / w r i te
d i s p l ay Fr a m e R ate : f l o at : re a d O n ly
f i e l d S e p a r a t i on Ty p e : F i e l d S e p a r a t i on Ty p e : rea d/ w r i te
g u e ss A l ph aMo de( ) n o re t u r n
g u e ss Pu l l dow n (Pul l dow n Me t h o d p u l l dow n Me t h o d) n o re t u r n
h a s Al p h a : b o o l e a n : rea dO n l y
h ig hQ ua l it y F ie l dS e pa r a ti on : b oo l ean : re ad / w r ite
inver t Alpha : bo olea n : rea d /w r i te
i s St i l l : b o o l e a n : rea dO n l y
l o op : i n te g er : rea d / w r i te
na t iveFr am eRa te : flo at : rea d Only
premu l Color : Ar r ay of f l oa t : re ad /w r ite
rem ovePu l l dow n : Pul l dow n P ha se : re ad / w r ite
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = =
Post RenderAc t i on enum
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Pos t Ren derAc t i on .I M PO RT
Pos t Ren derAc t i on .I M PO RT _ AN D _ RE P L AC E _ US AG E
Pos t Ren derAc t i on .N O N E
Pos t Ren derAc t i on .S E T _ P ROXY
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
Pro jec t ob je c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a c t iveItem : Item : rea d On ly
a utoF i xE x pres si o n s (o ld Tex t,
n e w Te x t ) n o ret u r n
bit s PerChan n el : integer : re ad/w r ite
cl o se( C l os eO p t i on s c lo se O p t ion s ) re tu r n s b oo l ean
cons oli d ate Fo ota ge( ) re tur n s i n te ger
d i sp layS ta r t Fr a m e : i n teger : re ad /w r ite
f i le : File : rea d Only
i m p o r t F i l e ( Im p or tO p t i o n s im p o r t O p ti o n s ) re tur n s Ite m
i m p o r t F i l eWi t hD i al o g () ret ur n s Ar r ay O f Item
i m p o r t P l a ce h o ld e r ( st r i n g i te m Nam e, i n te g e r i te m Wi dt h , i n teg e r i te m He ig h t , f l o a t fr a m e R a te ,
f l o at dur at i o n ) re t ur n s Fo o t ag eItem
i te m ( i n te g e r i te m In d e x ) ret ur n s Ite m
i te m s : Ite m Col l e c t i o n : rea dO n l y
l i n e a r B l e n d i n g : b o o l e a n : rea d / w r i te
nu mItem s : in te ger : re adOnly
red u ce Pro je c t( Ar r ay O fItem i te m s To Pres e r ve ) re t u r n s in te g er
189
Liste des objets After Effects
190
rem oveUnu se d Fo ota g e( ) re tur n s i n te g er
renderQ ueue : RenderQ ueue : re adO n ly
root Fo lder : FolderItem : re adO n ly
s ave( F i l e toF i l e ) ret u r n s b o o l e a n
s aveWi thD i a l og( ) re tur n s b oo le an
s el e c t i o n : A r r ay o f Ite m : rea d O n l y
s how Win dow( b o ol ea n doS how) n o re tur n
t i m e cod e B as e Ty p e : Ti m e cod e B as e Ty p e : re ad / w r ite
t i m e cod e D i sp l ay Ty p e : Ti m e cod e D is p l ay Ty p e : rea d / w r i te
t i m e cod e F i l m Ty p e : Ti m e co d e F il m Ty p e : re a d / w r it e
t i m e cod e N TS C D ro p Fr a m e : b o o l e an : rea d / w r i te
t r an s p aren c y Gr i d T hu m bn ai l s : b o o l e an : re a d/ w r ite
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
Pro p e r t y o b j e c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a c t ive : b oo l ean : re ad O n ly
a d dKe y (f lo at at Ti me) ret ur n s inte ger
can S et Ena ble d : bo olea n : rea dO n ly
can S et Ex pression : bo olea n : rea dO n ly
can Var yOverTime : b oo l ean : re adO n ly
du pl i c ate( ) re tur n s Prop er t y
e l id ed : b ool e an : rea d On ly
ena ble d : bo olea n : rea dO n ly
e xp re ss i on : s t r in g : re ad / w r ite
e xp re ss i on E n ab l e d : b oo l e an : re ad / w r ite
e xp re ss i on E r ror : s t r i n g : rea dO n l y
h as Max : b oo le an : re ad O n ly
h as Mi n : b o o l e a n : rea d O n l y
i s E ff e c t : b o o l e a n : re a d O n ly
i s In ter p o l a t i o n Ty p e Va l i d (Ke y fr a m e In te r p o l at i o n Ty p e t y p e ) ret u r n s b o o l e a n
i s Mas k : b o o l e a n : rea dO n l y
i s Mod i fi e d : b o o l e a n : rea dO n ly
i s Sp a t i a l : b o o l e a n : rea dO n l y
i s Ti m e Va r y i n g : b o o l e a n : rea dO n l y
ke y In In t e r p o l a t i o n Ty p e ( i n t e g e r ke y In dex ) ret ur n s Ke y f r a m eIn ter p ol a ti on Ty p e
ke y In Sp a t i a lTan g e n t (i n te g e r ke y In dex ) re t u r n s Ar r ay O fF l o a t
ke y In Tem p or a l E as e( in te g er ke y In dex ) re tur n s Ar r ay Of Ke y f r a m eE a se
ke y Out In ter p ol at i on Ty p e( in te ger ke y In dex) ret ur n s Ke y f r a m eIn ter p ol a t ion Ty p e
ke y O u t Sp a t i a l Ta n g e n t ( i n t e g e r ke y In dex ) ret ur n s Ar r ay O fF l o a t
ke y O u t Tem p o r a l E a s e ( i n te g e r ke y In d ex ) re tur n s Ar r ay Of Ke y f r a m eE a se
ke y Rov i n g (i n teg e r ke y In dex ) re t u r n s b o o l e a n
ke y S e l e c t e d ( i n t e ger ke y In d e x ) ret ur n s b o o l e a n
ke y S p a t i a l Auto B ez i e r ( i n t e ge r ke y In d e x ) ret ur n s b o o l e a n
ke y Sp a t i a l Con t inu ou s ( in t e ge r ke y In d e x) ret u r n s b o o l e a n
ke y Te m p o r a l Au t o B e z i e r ( i n t e ger ke y In d e x ) ret ur n s b o o l e a n
ke y Tem p or a l Con t in uous ( in te ger ke y In dex) ret ur n s b o ol ea n
ke y Ti m e ( i n te g e r ke y In d ex ) re tu r n s f l o a t
ke y Ti m e ( s t r i n g m a r ker Na m e ) ret u r n s f l o a t
ke y Valu e ( in te ge r ke y In de x) ret u r n s t y p e - stored - i n - prop er t y
ke y Va lu e( s t r i n g m a r ke r Nam e ) re t u r n s t y p e- s tore d - i n - p rop e r t y
m a tch Na m e : s t r i n g : rea d O n l y
190
Liste des objets After Effects
191
m oveTo( in te g er in d ex ) n o ret u r n
n a m e : s t r i n g : rea d O n l y
ne ares tKe y In d ex(f l o at at Ti me ) ret ur n s inte ger
nu mKe y s : in te ger : re adOnly
p a ren t Pro p e r t y : Pro p e r t y Gro u p : rea d O n l y
prop er t y D ep t h : i n te ger : rea d On ly
prop e r t y Gro u p ([ i n te g e r cou n tUp ]) ret u r n s Prop e r t y Gro u p
prop er t y Index : i n te ger : rea d Onl y
prop er t y Ty p e : Prop er t y Ty p e : rea d O n ly
prop er t y Va lue Ty p e : Prop er t yVa lue Ty p e : rea d On l y
remove() no re tu r n
rem oveKe y ( i n te g e r ke yIn d ex ) n o re t u r n
s e l e c t e d : b o o l e an : rea d / w r i te
s e l e c t e d Ke y s : Ar r ay o f in te g er : rea dO n l y
s e t In te r p o l at i o n Ty p e AtKe y ( i n te g e r ke y Ind ex , Ke y fr ameIn ter p o l at ion Ty p e in Ty p e ,
[Ke y fr am e In ter p o la t i on Ty p e o u tTy p e ] ) n o ret u r n
s e t Rov i n g At Ke y ( i n te g e r ke y In d ex , b o o l e a n i s Rov in g ) n o re t u r n
s et S e l ec te dAtKe y ( i n te g er ke y In d ex , b ool e an i s S el e c ted ) n o re t ur n
s et S pa t i al AutoB ez i erAtKe y ( i n te g er ke y In d ex , b ool e an i s Auto B ez i er) n o re t ur n
s et S pa t i al Con t i nuou sAtKe y( i n te g er ke y In d ex , b o o l e an i s Con t in u o u s ) n o ret u r n
s et S pa t i alTa ngen ts At Ke y(i n te ger ke yIndex, Ar r ayO fFlo a t i n Ta ngen t, [ Ar r ayO f Floa t o utTa n gent] )
n o re t u r n
s e t Te m p or al Au to B e z i e r At Ke y( i n te g e r ke y In d ex , b o o l e an i s Aut o B ez i e r ) n o ret ur n
s e t Te m p or al Co n t i nuo u s At Ke y( i n te g e r ke y In dex , b oo le an i s Con t in u o u s ) n o ret u r n
set Temp or alEa se AtKe y (integer ke yIndex , Ar r ayO fKe y fr ameE ase inEase,
[Ar r ay Of Ke y f r a m eE a se outE a s e]) n o re tur n
s e t Va l u e ( t y p e - s to re d - i n - p rop er t y n e w Va l u e ) n o re t u r n
s e t Va l u e AtKe y( i n te g e r ke y In d ex , t y p e- s tore d - i n - p rop er t y n e w Va lu e ) n o re t u r n
s e t Va l u e AtTi m e ( f l o a t a t Tim e , t y p e - stored - i n - prop er t y n ew Va lue) n o re tur n
s e t Val u e s At Ti m e s( Ar r ay O f F lo a t a tTi m e s , Ar r ayOf - t y p e - s tored - i n - prop e r t y n e w Valu e s ) n o re tu r n
un it sTex t : st r i ng : re ad O n ly
v alue : t y p e - store d- i n - prop er t y : re a d O n ly
v alue At Ti m e ( f l o at a t Ti m e , b o o l p re Ex p res s i on ) ret u r n s t y p e - stored - i n - prop er t y
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
Pro p e r t y Gro u p o b j ec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - (inte g er proper t y In dex) ret ur n s Prop er t y B a se
( st r i n g p ro p e r t y Na m e ) re tu r n s Prop er t y B as e
a c t ive : b oo l ean : re ad O n ly
a d dProp er t y (s t r i ng prop er t y Name ) re tur n s Prop er t y Ba s e
c an Add Prop er t y (s t r i n g prop er t y Name ) re tur n s b ool e an
can S et Ena ble d : bo olea n : rea dO n ly
du pl i c ate( ) re tur n s Prop er t y Group
e l id ed : b ool e an : rea d On ly
ena ble d : bo olea n : rea dO n ly
i s E ff e c t : b o o l e a n : re a d O n ly
i s Mas k : b o o l e a n : rea dO n l y
i s Mod i fi e d : b o o l e a n : rea dO n ly
m a tch Na m e : s t r i n g : rea d O n l y
m oveTo( in te g er in d ex ) n o ret u r n
n a m e : s t r i n g : rea d O n l y
191
Liste des objets After Effects
192
nu m Prop er t i e s : i n te g e r : rea d On l y
p a ren t Pro p e r t y : Pro p e r t y Gro u p : rea d O n l y
prop er t y ( i nte g er prop er t y Index) ret ur n s Prop er t yB a se
prop er t y (st r ing proper t y Na me) ret ur n s Prop er t y B a se
prop er t y D ep t h : i n te ger : rea d On ly
prop e r t y Gro u p ([ i n te g e r cou n tUp ]) ret u r n s Prop e r t y Gro u p
prop er t y Index : i n te ger : rea d Onl y
prop er t y Ty p e : Prop er t y Ty p e : rea d O n ly
remove() no re tu r n
s e l e c t e d : b o o l e an : rea d / w r i te
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
Pro p e r t y Ty p e e nu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Prop er t y Ty p e .I N D E XE D_ G RO UP
Prop er t y Ty p e .NA ME D _ GROU P
Prop er t y Ty p e .P ROPE RT Y
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = =
Proper t y Valu eTy p e enum
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Proper t y Valu eTy p e.CO LO R
Proper t y Valu eTy p e.CU STOM _VALU E
Proper t y Valu eTy p e.LAY E R_IND E X
Proper t y Valu eTy p e.M ARKER
Proper t y Valu eTy p e.M ASK_INDEX
Proper t y Valu eTy p e.NO _VA LUE
Proper t y Valu eTy p e.O n eD
Proper t y Valu eTy p e.SH APE
Proper t y Valu eTy p e.TE XT _D O C UM ENT
Proper t y Valu eTy p e.T hree D
Proper t y Valu eTy p e.T hree D_SPATIAL
Proper t y Valu eTy p e.TwoD
Proper t y Valu eTy p e.TwoD _SPATIA L
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
Pul l dow n Ph a s e e nu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Pul l dow n Ph a s e . O F F
Pul l dow n Ph a s e . S S W W W
Pul l dow n Ph a s e . S W W WS
Pul l d ow n Ph a s e . S W W W W _ 2 4 P _ A DVA N C E
Pul l dow n Ph a s e . WS S W W
Pul l d ow n Ph a s e . WS W W W _ 2 4P _ A DVAN C E
Pul l dow n Ph a s e . W WS S W
Pul l d ow n Ph a s e . W WS W W _ 2 4P _ A DVAN C E
Pul l dow n Ph a s e . W W WS S
Pul l dow n Ph a s e . W W WS W _ 2 4 P _ A DVA N C E
Pul l dow n Ph a s e . W W W WS_ 2 4 P _ A DVA N C E
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
Pul l dow n Me t h o d e nu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Pul l dow n Me t h o d . A DVAN C E _ 2 4 P
Pul l dow n Me t h o d . P U L L D OW N _ 3 _ 2
192
Liste des objets After Effects
193
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == =
PurgeTa rge t enu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Pur g e Ta r g e t . A L L _ C AC H E S
Pur g e Ta r g e t . I M AG E _ C AC H E S
PurgeTa rge t. SNAP SH OT _ C AC HES
Purg eTa rg e t. UN D O _C AC HE S
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
RenderQu eu e obj ec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - i te m ( i n te g e r i te m In d e x ) ret ur n s Ren d e r Q u e u e It em
items : RQ ItemCol l ec t ion : re adO n ly
nu mItem s : in te ger : re adOnly
pau se Render ing (b oole an doPa use) no retur n
ren de r ( ) n o re t u r n
render in g : bo olea n : rea d Only
s how Win dow( b o ol ea n doS how) n o re tur n
s to p Ren d e r i n g ( ) n o re t u r n
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = =
RenderQu eu eItem obje c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a p p ly Te m p l a t e ( s t r i n g t e m p l a teNam e) n o re t u r n
com p : Com p Ite m : rea d O n l y
du pl i c ate( ) re tur n s Rend erQu eu eItem
e l ap se d S e co n d s : f l o a t : re ad O n ly
l o g Ty p e : Lo g Ty p e : rea d / w r i te
nu mOut putMo dule s : in te ger : rea dO n ly
o ut p utMo du le (i n teg er o ut p ut Modu l eIn dex ) ret ur n s Out p utMo du l e
out p utMo du le s : OM Col le c ti on : rea d On ly
remove() no re tu r n
render : bo olean : re ad/w r ite
s aveAs Tem p l a t e ( s t r i n g t e m p l a teNam e) n o re t u r n
s ki p Fr a m e s : i n te g e r : rea d / w r i te
s ta r t Ti m e : fl o a t : rea d On ly
s ta tus : RQ Item S ta tus : rea d On l y
tem p l a tes : Ar r ay of s t r in g : rea dO n ly
t i m eS p an D ur at i o n : f l o at : re ad / w r ite
t i m eS p an S t ar t : f l o at : rea d/ w r i te
o n S t a t u s C h a n g e d ( ) n o re t u r n
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
RQ ItemCol le c tion ob jec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a d d( Com p Ite m com pToAd d ) re tur n s Ren d er Qu eu e Item
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
RQ ItemSt at us enum
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - RQ Item St at us .D ON E
RQ Item St at us .E RR _ STO P PE D
RQ Ite m S t a t u s . N E E D S _ O U T P U T
RQ Item St at us .QU E UE D
RQ Item St at us .RE N D E RI N G
193
Liste des objets After Effects
194
RQ Item St at us .UN QUE U E D
RQ Item St at us .US E R _ STO P PED
RQ Ite m St a t u s . W I L L _ C ON T I N U E
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
S e tt i n g s o b j e c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - g e t S e tt i n g ( s t r in g s e c t i o n Na m e , s t r in g s e c t i o n Ke y ) re t u r n s s t r i n g
h aveS e t t i n g ( s t r in g s e c t i o n Na m e , s t r i n g s e c t i o n Ke y ) re t u r n s b o o l e a n
s aveS e t t in g ( s t r i n g s e c ti o n Na m e , s t r in g s e c t i o n Ke y, s t r i n g n e w Va l u e ) n o re t u r n
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
Shape object
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - n e w S h a p e ( ) re tu r n s S h ap e
cl o se d : b o ol ea n : rea d/ w r i te
i n Ta n g e n t s : Ar r ay o f f l o a t [ 2 ] : rea d / w r i te
o u t Ta n gen t s : Ar r ay o f f l o a t [ 2 ] : rea d/ w r i te
ver t ice s : Ar r ay o f f lo a t [ 2 ] : rea d /w r i te
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
S o l i d S o u rce o b j e c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - a lp ha Mod e : Al ph aMo de : rea d / w r i te
co lor : Ar r ay of fl o a t : rea d / w r i te
con f o r m Fr a m e R a te : f l o a t : rea d O n l y
d i s p l ay Fr a m e R ate : f l o at : re a d O n ly
f i e l d S e p a r a t i on Ty p e : F i e l d S e p a r a t i on Ty p e : rea dO n l y
g u e ss A l ph aMo de( ) n o re t u r n
g u e ss Pu l l dow n (Pul l dow n Me t h o d p u l l dow n Me t h o d) n o re t u r n
h a s Al p h a : b o o l e a n : rea dO n l y
h ig hQ ua l it y F ie l dS e pa r a ti on : b oo l ean : re ad O n ly
inver t Alpha : bo olea n : rea d /w r i te
i s St i l l : b o o l e a n : rea dO n l y
l o op : i n te g e r : rea d O n ly
na t iveFr am eRa te : flo at : rea d Only
premu l Color : Ar r ay of f l oa t : re ad /w r ite
rem ovePu l l dow n : Pul l dow n P ha se : re ad O n ly
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
Sys tem ob j ec t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - c al l Sy s te m ( st r i n g c m d L i n e To Exec tu te ) re tur n s o u t p u tO f Com m an d As St r i n g
ma chineNa m e : st r i ng : rea d Only
o s Nam e : s t r in g : re a d O n ly
o s Ver s i o n : s t r in g : rea d O n ly
u s e r Nam e : s t r i n g : rea d O n l y
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
Tex t D o c u m e n t o b j e c t
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - n e w Tex tD o c u m e n t (s t r i n g tex t ) re tur n s Tex tD o c u m e n t
text : s t r i ng : rea d /w r i te
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
Tim eco de Ba s eTy p e enum
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - -
194
Liste des objets After Effects
195
Tim eco de Ba s eTy p e.AU TO
Tim eco de Ba seTy p e.FPS100
Tim eco de Ba s eTy p e.F P S 24
Tim eco de Ba s eTy p e.F P S 25
Tim eco de Ba s eTy p e.F P S 30
Tim eco de Ba s eTy p e.F P S 48
Tim eco de Ba s eTy p e.F P S 50
Tim eco de Ba s eTy p e.F P S 60
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = ==
Tim e co de Di s p l ay Ty p e e nu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Tim e co de Di s p l ay Ty p e .F E E T _ A N D_ F R A M E S
Tim e co de Di s p l ay Ty p e .F R A M E S
Tim e co de Di s p l ay Ty p e .T I M E C O DE
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
Tim eco de F il m Ty p e en um
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Tim eco de F il m Ty p e .MM 16
Tim eco de F il m Ty p e .MM 35
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
Tr a ck Mat teTy p e enu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Tr a ck Mat teTy p e. AL PH A
Tr a ck Ma t teTy p e . AL P H A _ I N V E RT E D
Tr a ck Mat teTy p e. LUM A
Tr a ck Ma t teTy p e . LU M A _ I N V E RT E D
Tr a ck Ma t teTy p e . N O _ T R AC K _ M AT T E
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
AutoO r ien t Ty p e enum
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - AutoO r ien t Ty p e.A LO N G _ PAT H
AutoO r ien t Ty p e. C A ME R A _ O R _ P O I N T _ O F _ I N T E RE S T
AutoO r ien t Ty p e.N O _ AUTO _ O R I E N T
= == == == = == == == = == == == == = == == == == = == == == == = == == == == = == == == == = == == == = == =
Fr a m e Bl e n d i n g Ty p e e nu m
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - Fr am e Bl en d i n g Ty p e.F RAM E _ MI X
Fr a m e Bl e n d i n g Ty p e . N O_ F R A M E _ B L E N D
Fr a m e Bl e n d i n g Ty p e . P I X E L _ M OT I O N
- - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - - -
195