ADOBE Illustrator CS6, Illustrator CS5, Illustrator CC 2013 Guide des scripts [fr]

ADOBE® ILLUSTRATOR® CS5

GUIDE DES SCRIPTS POUR ADOBE

ILLUSTRATOR CS5

© 2010 Adobe Systems Incorporated. All rights reserved.

Guide des scripts pour Adobe Illustrator CS5

Si le présent guide est fourni avec un logiciel régi par un contrat d’utilisateur final, le guide, ainsi que le logiciel décrit,
sont fournis sous licence et peuvent être utilisés ou copiés uniquement selon les clauses et conditions de la licence.
A moins d’une autorisation expresse accordée par cette licence, aucune partie de ce guide ne peut être reproduite,
stockée dans un système d’interrogation ou transmise, sous quelque forme ou par quelque moyen que ce soit
(électronique, mécanique, enregistrement ou autre) sans l’autorisation écrite préalable d’Adobe Systems Incorporated.
Veuillez noter que le contenu du présent guide est protégé par la loi sur les droits d’auteur, même s’il n’est pas distribué
avec un logiciel régi par un contrat de licence utilisateur.

Les informations contenues dans ce guide sont fournies à titre purement informatif; elles sont susceptibles d’être
modifiées sans préavis et ne doivent pas être interprétées comme étant un engagement de la part d’Adobe Systems
Incorporated. Adobe Systems Incorporated n’accepte aucune responsabilité quant aux erreurs ou inexactitudes pouvant
être contenues dans le présent guide.

Veuillez noter que les illustrations ou images existantes que vous souhaiterez éventuellement inclure dans votre projet
sont susceptibles d’être protégées par les lois sur les droits d’auteur. L’inclusion non autorisée de tels éléments dans vos
nouveaux travaux peut constituer une violation des droits du propriétaire. Veuillez vous assurer de détenir toute
autorisation nécessaire auprès du détenteur des droits.

Toute référence à des noms de sociétés dans des modèles types n’est utilisée qu’à titre d’exemple et ne fait référence à
aucune société réelle.

Adobe, the Adobe logo, Illustrator, Photoshop, and InDesign are either registered trademarks or trademarks of Adobe
Systems Incorporated in the United States and/or other countries.

Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States
and/or other countries. Apple, Mac, Macintosh, and Mac OS are trademarks of Apple Computer, Incorporated, registered
in the United States and other countries. JavaScript and all Java-related marks are trademarks or registered trademarks
of Sun Microsystems, Incorporated in the United States and other countries. UNIX is a registered trademark of The Open
Group.

All other trademarks are the property of their respective owners.

Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Notice to U.S. Government End Users.
The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, consisting of
“Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48
C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through

227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are
being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted
to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright
laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S.
Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the
provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act
of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR
Parts 60-1 through 60-60, 60-250, and 60-741. The affirmative action clause and regulations contained in the preceding
sentence shall be incorporated by reference.

Sommaire

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Qu’est-ce qu’un script? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Pourquoi utiliser les scripts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Qu’est-ce qu’une action? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Prise en charge du langage de script dans AdobeIllustratorCS5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Extensions de scripts de fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Options de développement JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Affichage des exemples de scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Affichage du modèle d’objet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Affichage du modèle d’objet JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Affichage du modèle d’objet AppleScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Affichage du modèle d’objet VBScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Exécution de scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Installation de scripts dans le menu Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Exécution de scripts à partir de l’élément de menu Autre script . . . . . . . . . . . . . . . . . . . . . . . 11

Scripts de démarrage (scripts .jsx uniquement) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Changements survenus dans la versionCS5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Origine de la règle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Enumération . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Classe de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Problèmes connus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

2 Modèle d’objet de script Illustrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Conventions d’attribution de nom pour les objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Objets de niveau supérieur (objets conteneurs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Calque . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Hiérarchie des illustrations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Styles d’illustration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Coloration d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Objets texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Blocs de texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Objets représentant le contenu de texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Styles de texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Objets dynamiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Symboles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Transformations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

3

Sommaire 4

3 Scripts Illustrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Lancement et fermeture d’Illustrator à partir d’un script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Lancement et activation d’Illustrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Fermeture d’Illustrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Utilisation d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Obtention du document ou du calque situé au premier plan . . . . . . . . . . . . . . . . . . . . . . . . . 27

Création d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Objets de collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Objets sélectionnés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Remarques sur le changement de nom d’objets stockés dans les panneaux

de l’application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Unités de mesure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Unités em . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Positionnement et dimensions d’un élément de page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Limites des éléments d’illustration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Tracés et formes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Niveaux d’interaction de l’utilisateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Impression de documents Illustrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

4 Création de scripts à l’aide d’AppleScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Pour plus d’informations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Votre premier script Illustrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Ajout de caractéristiques à «HelloWorld» . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Référencement d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Obtention d’objets de documents et calques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Création d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Utilisation de sélections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Utilisation de blocs de texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Blocs liés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Création de tracés et de formes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Tracés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Formes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Utilisation de la grille de perspective . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Utilisation des paramètres de perspective prédéfinis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Affichage ou masquage de la grille . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Définition du plan actif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Réalisation d’un dessin sur une grille de perspective . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Mise en perspective d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

5 Création de scripts à l’aide deJavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Pour plus d’informations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Votre premier script Illustrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Ajout de caractéristiques à «HelloWorld» . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Utilisation de méthodes dans JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Sommaire 5

Accès et référencement d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Référencement de l’objet application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Accès aux objets de collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Création d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Utilisation de sélections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Utilisation de blocs de texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Blocs liés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Création de tracés et de formes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Tracés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Formes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Utilisation de la grille de perspective . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Utilisation des paramètres de perspective prédéfinis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Affichage ou masquage de la grille . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Définition du plan actif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Réalisation d’un dessin sur une grille de perspective . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Mise en perspective d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

6 Création de scripts à l’aide deVBScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Pour plus d’informations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Votre premier script Illustrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Ajout de caractéristiques à «HelloWorld» . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Accès et référencement d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Obtention d’objets de collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Création d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Utilisation de sélections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Utilisation de blocs de texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Blocs liés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Création de tracés et de formes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Tracés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Formes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Utilisation de valeurs d’énumération . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Utilisation de la grille de perspective . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Utilisation des paramètres de perspective prédéfinis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Affichage ou masquage de la grille . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Définition du plan actif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Réalisation d’un dessin sur une grille de perspective . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Mise en perspective d’objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

1

Introduction

Ce guide décrit l’interface de script pour Adobe® Illustrator®CS5.

Si vous êtes novice en matière de scripts ou que vous souhaitez obtenir des informations sur la manière
d’utiliser les différents langages de script, reportez-vous au document Introduction aux scripts Adobe.

Qu’est-ce qu’un script?

Un script est une série de commandes demandant à Illustrator d’exécuter une ou plusieurs opérations.
Ces opérations peuvent être simples et n’affecter qu’un objet du document actuel, ou complexes et affecter des
objets dans tous vos documents Illustrator. Ces opérations peuvent aussi impliquer d’autres applications, telles
que des programmes de traitement de texte, des tableurs ou des logiciels de gestion de base de données.

La plupart des blocs de construction du script correspondent aux outils Illustrator, aux menus, aux
panneaux et aux boîtes de dialogue pour lesquels vous possédez une expertise. Si vous savez ce que vous
souhaitez exécuter par le biais d’Illustrator, vous pouvez écrire un script à cet effet.

Pourquoi utiliser les scripts?

La conception graphique est un domaine où la créativité est reine, mais certains aspects de la conception
ne sont pas du tout créatifs. Vous aurez sans doute remarqué que le positionnement et le
repositionnement d’images, la rectification d’erreurs dans le texte et la préparation des fichiers pour
impression chez un fournisseur de services de réglage d’image empiètent largement sur le temps dont
vous disposez pour le travail créatif à proprement parler.

Si vous investissez un peu de temps et d’efforts, vous pouvez apprendre à écrire des scripts courts et
simples qui effectuent les opérations répétitives à votre place. Au fur et à mesure du développement de
vos compétences, vous pourrez écrire des scripts de plus en plus complexes.

Les scripts peuvent également améliorer votre créativité en effectuant rapidement des opérations que
vous pourriez ne pas avoir le temps de tester. Par exemple, vous pouvez écrire un script pour créer
systématiquement une série d’objets, en modifiant les propriétés de position, contour et fond de
nouveaux objets à un moment donné. Vous pouvez également écrire un script qui accède aux fonctions
de matrice de transformation intégrée afin d’étirer, de mettre à l’échelle et de distordre une série d’objets.
Sans script, vous perdriez certainement une partie du potentiel créatif de telles techniques qui requièrent
une masse importante de travail.

Qu’est-ce qu’une action?

Les actions et les scripts sont deux manières d’automatiser des opérations répétitives, mais elles
fonctionnent de deux façons différentes:

X Les actions utilisent une interface utilisateur de programme. Lors de l’exécution d’une action, les choix

de menus sont exécutés, les objets sont sélectionnés et les tracés enregistrés sont créés. Les scripts
n’utilisent pas d’interface utilisateur de programmes pour effectuer les opérations et peuvent
s’exécuter plus rapidement que les actions.

X Les actions possèdent des fonctionnalités très limitées pour obtenir des informations et y répondre. Vous

ne pouvez pas ajouter de logique conditionnelle à une action. Par conséquent, les actions ne peuvent
pas prendre de décisions reposant sur la situation actuelle, telles que le changement de type de contour
des rectangles mais pas des ellipses. Les scripts sont capables d’obtenir des informations, de prendre des
décisions et d’effectuer des calculs reposant sur les informations qu’ils reçoivent d’Illustrator.

X Un script peut exécuter une action, mais les actions ne peuvent pas exécuter de scripts.

6

CHAPITRE 1 : Introduction Prise en charge du langage de script dans AdobeIllustratorCS5 7

Prise en charge du langage de script dans AdobeIllustratorCS5

Les scripts d’Illustrator prennent en charge les scripts VBScript et JavaScript pour Windows, et les scripts
AppleScript et JavaScript pour MacOS.

Extensions de scripts de fichiers

Pour qu’un fichier soit reconnu par AdobeIllustratorCS5 en tant que fichier de script valide, il doit
posséder un nom d’extension de fichier correct:

Type de script Type de fichier (extension) Plates-formes

AppleScript fichier OSAS (

de script compilé (sans extension)

JavaScript ou ExtendScript texte (

VBScript texte (

.js ou .jsx) Windows

.vbs)Windows

.scpt)

Options de développement JavaScript

Vous pouvez utiliser l’utilitaire d’écriture de scripts ExtendScript Toolkit pour créer des scripts JavaScript
spécialement conçus pour Illustrator. Vous pouvez aussi utiliser Creative Suite Extension Builder
(CS Extension Builder) pour développer des extensionsCS en ActionScript. Les extensionsCS sont basées
sur le format Flash(SWF) et sont potentiellement compatibles avec toute une gamme d’applications
CreativeSuite.

Développement d’une extensionCS5 en ActionScript

Dans Creative Suite5, les applications disposent d’une infrastructure d’extensibilité qui permet aux
développeurs d’étendre les capacités des applications. Cette infrastructure repose sur la technologie
Flash/Flex et chaque extensionCS5 se présente sous la forme d’un fichier Flash(SWF) compilé. Creative
Suite5 inclut le gestionnaire d’extensions afin d’activer l’installation d’extensionsCS5.

Adobe Kuler est un exemple d’extensionCS5 fourni avec les produits ciblés. Kuler dispose d’une interface
utilisateur cohérente à travers l’ensemble des applications de la suite, mais chaque application hôte utilise
sa propre logique, spécifiquement adaptée.

MacOS

MacOS

L’interface utilisateur d’une extension est écrite en ActionScript, à l’aide de l’infrastructure Flex. En général,
pour accéder à une extensionCS5, vous pouvez passer par son propre élément dans le menu Extensions
de l’application. CS Extension Builder permet de concevoir l’interface utilisateur de façon interactive à
l’aide de la vue de conception de FlashBuilder. CS Extension Builder permet également de développer
toute la logique de l’application pour l’extensionCS5 en ActionScript. Vous pouvez développer et
déboguer l’extension dans l’environnement familier de FlashBuilder.

Pour développer la logique de l’application, il est conseillé d’utiliser la bibliothèque Creative Suite
ActionScript Wrapper Library (
chaque application hôte sous la forme d’une bibliothèque ActionScript. Ceci est étroitement intégré à
l’environnement CS Extension Builder, qui inclut des assistants afin de vous aider à créer la structure de
base de l’extension, puis à exécuter et à déboguer le code des applications de la suite, telles qu’Adobe
InDesign, Photoshop et Illustrator.

CSAWLib), qui expose le modèle d’objets de document (DOM) du script pour

CHAPITRE 1 : Introduction Affichage des exemples de scripts 8

Les méthodes, les propriétés et le comportement du modèle d’objets de document du script sont tels que
le décrit la référence de scripts JavaScript pour l’application hôte. Pour plus d’informations sur l’utilisation
de CS Extension Builder et des bibliothèques de wrappers, consultez la documentation du kit de
développement logiciel CreativeSuite, accessible depuis le système d’aide de FlashBuilder ou d’Eclipse
lorsque vous avez installé CS Extension Builder.

Fonctions ExtendScript

Si vous rédigez des scripts spécifiques à Illustrator qui utilisent directement le modèle d’objets de
document JavaScript Illustrator, vous créez des fichiers ExtendScript qui se distinguent par
l’extension
standard

ExtendScript propose toutes les fonctions JavaScript standard, ainsi qu’un environnement de
développement et de débogage, l’utilitaire d’écriture de scripts ExtendScript Toolkit (ESTK). ESTK est
installé avec toutes les applications Adobe capables de prendre en charge les scripts; il s’agit de l’éditeur
par défaut pour les fichiersJSX. ESTK comprend un afficheur de modèle d’objet qui contient une
documentation complète concernant les méthodes et propriétés des objets JavaScript. Pour plus de
détails sur l’accès à ESTK et à l’afficheur de modèle d’objet, reportez-vous à la section «

modèle d’objet JavaScript », page 9.

.jsx. En attribuant une extension.jsx aux fichiers JavaScript (au lieu de l’extension

.js), vous pouvez tirer parti des fonctions et des outils ExtendScript.

Affichage du

ExtendScript offre également divers outils et utilitaires tels que:

X un utilitaire de localisation;

X des outils qui vous permettent de combiner les scripts et de les diriger vers des applications spécifiques;

X une représentation de fichiers et de dossiers indépendante des plates-formes;

X des outils pour construire des interfaces utilisateur dans vos scripts;

X un cadre de messagerie électronique qui vous permet d’envoyer et de recevoir des scripts et des

données dans les applications Adobe adaptées aux scripts.

Toutes ces fonctions sont disponibles, que vous utilisiez le modèle d’objets de document directement avec
un fichierJSX ou indirectement via la bibliothèque de wrappers ActionScript et CS Extension Builder. Pour
plus de détails sur ces fonctions et sur d’autres fonctions, reportez-vous au Guide des outils JavaScript.

Affichage des exemples de scripts

Adobe fournit des exemples de scripts pour de nombreux objets, propriétés et méthodes dans le modèle
d’objets de document IllustratorCS5. Vous pouvez consulter des exemples de scripts à deux emplacements:

X Dans le dossier /Scripting/SampleScripts du répertoire d’installation d’IllustratorCS5

X Dans le document de référence de scripts d’AdobeIllustratorCS5 pour votre langage de script, que

vous pouvez télécharger depuis le site http://www.adobe.com/devnet/illustrator/scripting/

Affichage du modèle d’objet

Les langages de script pris en charge fournissent chacun une fonction permettant d’afficher les objets de
script définis par Illustrator avec des détails de référence.

CHAPITRE 1 : Introduction Affichage du modèle d’objet 9

Affichage du modèle d’objet JavaScript

Pour afficher le modèle d’objet JavaScript dans Illustrator, procédez comme suit:

1. Démarrez l’utilitaire d’écriture de scripts ESTK.

Dans une installation Adobe par défaut, ESTK se trouve à l’emplacement suivant:

Z Windows:

system drive\Program Files\Adobe\Adobe Utilities CS5\ExtendScript Toolkit CS5

Z MacOS:

system drive:Applications:Utilities:Adobe Utilities CS5:ExtendScript Toolkit CS5

2. Dans ESTK, choisissez la commande Aide> Outil de visualisation d’Object Model.

3. Dans la fenêtre Outil de visualisation d’Object Model, sélectionnez Adobe IllustratorCS5 Type Library
dans la liste déroulante Navigateur.

Vous trouverez plusieurs exemples de scripts étendus dans le dossier
répertoire d’installation d’IllustratorCS5.

Vous pouvez également consulter des exemples de scripts et des informations concernant les classes,
les objets, les propriétés, les méthodes et les paramètres individuels dans le guide Adobe IllustratorCS5
Scripting Reference: JavaScript (Référence de script AdobeIllustratorCS5: JavaScript) que vous pouvez
télécharger depuis le site http://www.adobe.com/devnet/illustrator/scripting/

Affichage du modèle d’objet AppleScript

Apple fournit l’application Editeur de scripts avec tous les systèmes MacOS. Vous pouvez utiliser
l’application Editeur de scripts pour consulter le dictionnaire AppleScript qui décrit les divers objets et
commandes d’Illustrator.

Pour plus de détails sur l’utilisation de l’Editeur de scripts, reportez-vous à l’aide de l’Editeur de scripts.

1. Lancez l’application Editeur de scripts.

R

EMARQUE : dans une installation MacOS par défaut, l’application Editeur de scripts se trouve dans le

dossier
scripts, vous devez la réinstaller à partir du CD du système MacOS.

2. Choisissez la commande Fichier> Ouvrir un dictionnaire. Une boîte de dialogue Ouvrir un dictionnaire
s’affiche dans l’application Editeur de scripts.

3. Dans cette boîte de dialogue, recherchez l’application AdobeIllustratorCS5, puis sélectionnez-la et
cliquez sur le bouton Ouvrir.

Applications:AppleScript:ScriptEditor. Si vous ne trouvez pas l’application Editeur de

/Scripting/SampleScripts du

.

La liste des objets et commandes Illustrator, qui inclut les propriétés et éléments associés à chacun des
objets et les paramètres pour chaque commande, s’affiche dans l’application Editeur de scripts.

Vous trouverez plusieurs exemples de scripts étendus dans le dossier

:Scripting:SampleScripts du

répertoire d’installation d’IllustratorCS5.

Vous pouvez également consulter des exemples de scripts et des informations concernant les classes, les
objets, les propriétés, les méthodes et les paramètres individuels dans le guide Adobe IllustratorCS5
Scripting Reference: AppleScript (Référence de script AdobeIllustratorCS5: JavaScript) que vous pouvez
télécharger depuis le site http://www.adobe.com/devnet/illustrator/scripting/

.

CHAPITRE 1 : Introduction Exécution de scripts 10

Affichage du modèle d’objet VBScript

VBScript fournit une bibliothèque type que vous pouvez utiliser pour consulter les propriétés et méthodes
des objets Illustrator. Cette procédure explique comment consulter la bibliothèque type à partir de
n’importe quel programme Microsoft Office. Votre éditeur VBScript possède certainement un accès à la
bibliothèque. Pour plus d’informations, reportez-vous à l’aide de votre éditeur.

1. A partir de toute application Microsoft Office, choisissez la commande Outils> Macro> Visual Basic Editor.

2. Dans Visual Basic Editor, choisissez la commande Outils> Références.

3. Dans la boîte de dialogue qui s’affiche, cochez la case correspondant à la bibliothèque Adobe
IllustratorCS5 Type Library, puis cliquez sur le boutonOK.

4. Choisissez la commande Affichage> Explorateur d’objets pour afficher la fenêtre Explorateur d’objets.

5. Choisissez l’option Illustrator dans la liste de bibliothèques ouvertes du menu déroulant situé en haut
à gauche de la fenêtre Explorateur d’objets.

Vous trouverez plusieurs exemples de scripts étendus dans le dossier
répertoire d’installation d’IllustratorCS5.

Vous pouvez également consulter des exemples de scripts et des informations concernant les classes,
les objets, les propriétés, les méthodes et les paramètres individuels dans le guide Adobe IllustratorCS5
Scripting Reference: VBScript (Référence de script AdobeIllustratorCS5: VBScript) que vous pouvez
télécharger depuis le site http://www.adobe.com/devnet/illustrator/scripting/

Exécution de scripts

L’interface Illustrator comprend un menu Scripts (Fichier> Scripts) qui fournit un accès facile et rapide à vos scripts.

Les scripts peuvent être directement répertoriés en tant qu’éléments de menu qui s’exécutent lorsque
vous les sélectionnez. (Reportez-vous à la section «

Vous pouvez également naviguer vers n’importe quel script de votre système de fichiers à partir du menu, puis
exécuter le script. (Reportez-vous à la section «

page 11).

Vous pouvez également choisir des scripts JavaScript avec une extension.jsx qui démarrent
automatiquement lorsque vous lancez l’application. Pour plus de détails, reportez-vous à la section

Scripts de démarrage (scripts .jsx uniquement) », page 11.

«

/Scripting/SampleScripts du

.

Installation de scripts dans le menu Scripts », page 10).

Exécution de scripts à partir de l’élément de menu Autre script »,

Installation de scripts dans le menu Scripts

Pour inclure un script dans le menu Scripts (Fichier> Scripts), enregistrez-le dans le dossier Scripts qui
se situe dans le dossier
Le nom de fichier du script, sans l’extension du fichier, apparaît dans le menu Scripts.

Les scripts que vous ajoutez au dossier Scripts lorsqu’Illustrator est en cours d’exécution apparaîtront dans
le menu Scripts au prochain lancement d’Illustrator.

Vous pouvez installer un nombre illimité de scripts dans le menu Scripts. Si vous possédez un grand nombre
de scripts, utilisez des sous-dossiers dans le dossier Scripts pour mieux organiser les scripts du menu Scripts.
Chaque sous-dossier apparaît en tant que sous-menu séparé comportant les scripts de ce sous-dossier.

/Illustrator CS5/Presets de votre répertoire d’installation d’IllustratorCS5.

CHAPITRE 1 : Introduction Exécution de scripts 11

Exécution de scripts à partir de l’élément de menu Autre script

L’élément Autre script figurant au bas du menu Scripts (Fichier> Scripts> Autre script) vous permet
d’exécuter des scripts qui ne sont pas installés dans le dossier Scripts.

Lorsque vous sélectionnez l’option Autre script, la boîte de dialogue Ouvrir s’affiche: utilisez-la pour
accéder à un fichier de script. Lorsque vous sélectionnez le fichier, le script s’exécute.

Seuls les fichiers dont les types sont pris en charge apparaissent dans cette boîte de dialogue. Pour plus de
détails, reportez-vous à la section «

Prise en charge du langage de script dans AdobeIllustratorCS5 », page 7.

Scripts de démarrage (scripts .jsx uniquement)

Vous pouvez installer les scripts JavaScript possédant une extension de fichier.jsx dans un ou deux
dossiers afin qu’ils s’exécutent automatiquement lorsque vous lancez Illustrator ou à chaque exécution de
script. Ces dossiers sont les suivants:

X

un dossier de scripts de démarrage spécifique à l’application, qui contient des scripts pour IllustratorCS5;

X un dossier de scripts de démarrage général, qui contient des scripts s’exécutant automatiquement

lorsque vous lancez une application Creative Suite5.

Dossier de scripts de démarrage spécifique à l’application

Vous devez placer les scripts de démarrage spécifiques à l’application dans un dossier appelé

StartupScripts, que vous créez dans le répertoire d’installation d’Illustrator.

Par exemple, lorsqu’IllustratorCS5 est installé dans son emplacement par défaut, vous créez le dossier

StartupScripts aux emplacements suivants:

X Windows: C:\Program Files\Adobe\Adobe Illustrator CS5\Startup Scripts\

X MacOS: /Applications/Adobe Illustrator CS5/Startup Scripts/

Les scripts JavaScript qui possèdent une extension

StartupScripts s’exécutent automatiquement lorsque:

X l’application est lancée;

X tout fichier JavaScript est sélectionné à partir du menu Scripts (Fichier> Scripts).

.jsx et qui sont placés dans le dossier

Dossier de scripts de démarrage général

Le dossier de scripts de démarrage général comporte des scripts qui s’exécutent automatiquement
lorsque vous lancez une application Creative Suite5. Vous créez le dossier aux emplacements suivants:

X Windows: Program Files/Common Files/Adobe/Startup Scripts CS5/Illustrator

X MacOS: :Library:Application Support:Adobe:Startup Scripts CS5:Illustrator

Si un script du dossier de démarrage général doit être exécuté uniquement par Illustrator, ce script doit
inclure la directive ExtendScript

if( BridgeTalk.appName == "illustrator" ) {

//continue executing script

}

#target (#target illustrator) ou le code suivant:

Pour plus de détails, reportez-vous au Guide des outils JavaScript.

CHAPITRE 1 : Introduction Changements survenus dans la versionCS5 12

Changements survenus dans la versionCS5

Cette section énumère les changements apportés au modèle d’objet de script pour prendre en charge les
fonctions d’IllustratorCS5.

Origine de la règle

Dans les versions précédentes, l’origine du plan de travail, la position avec coordonnées (0,0), se trouvait
dans l’angle inférieur gauche. Les incréments positifsX allaient de gauche à droite, tandis que les
incréments positifsY allaient de bas en haut.

Dans IllustratorCS5, l’origine du plan de travail est définie de façon à être dans l’angle supérieur gauche.
Les incréments positifsX vont toujours de gauche à droite, mais les incréments positifsY vont désormais
de haut en bas.

Pour afficher les règles, choisissez Affichage> Règles> Afficher les règles. Utilisez le panneau Infos
(Fenêtres> Infos) pour vérifier les coordonnéesX/Y d’une position.

Pour éviter d’endommager des scripts existants, le script Illustrator utilise encore le système de
coordonnées hérité. Autrement dit, tous les documents créés à l’aide de scripts utilisent le système de
coordonnées hérité. Les documents que vous créez directement dans l’interface utilisateur utilisent le
nouveau système de coordonnées. Si le script fonctionne sur un document de ce type, pour que son
comportement soit le même que dansCS4, il doit convertir la valeur de la coordonnéeY d’une position
en-Y, et inversement lorsqu’il interprète les valeurs des coordonnées du document.

Enumération

X Nouvelle énumération pour le système de coordonnées utilisé par Illustrator:

Z AppleScript: artboard coordinate system/document coordinate system

JavaScript: CoordinateSystem

Z

VBScript: AiCoordinateSystem

Z

X Nouvelle énumération pour les points d’enregistrement des symboles:

Z AppleScript — N/A

Z JavaScript: SymbolRegistrationPoint

Z VBScript: AiSymbolRegistrationPoint

CHAPITRE 1 : Introduction Changements survenus dans la versionCS5 13

X

Nouvelle énumération pour le type de plan de la grille de perspective:

Z AppleScript: floorplane/leftplane/noplane/rightplane

Z JavaScript: PerspectiveGridPlaneType

Z VBScript: AiPerspectiveGridPlaneType

X Nouvelle énumération pour le type de lissage de texte:

Z AppleScript: crisp/none/sharp/strong

Z JavaScript: TextAntiAlias

Z VBScript: AiTextAntialias

X Nouvelle énumération pour l’orientation de l’impression des illustrations:

Z AppleScript: auto rotate

JavaScript: PrintOrientation.AUTOROTATE

Z

Z VBScript: AiAutoRotate

X Nouvelle valeur d’énumération pour la version du format de fichierFXG:

Z AppleScript: version 2.0

X Nouvelle valeur d’énumération pour la règle de préservation du texte par le format de fichierFXG:

Classe

X Nouvelle propriété pour le système de coordonnées dans la classe Application:

X Nouvelles propriétés dans la classe Artboard pour définir l’origine de la règle, par rapport à (0,0) dans

Z

JavaScript: FXGVersion.VERSION2PT0

Z VBScript: AiVersion2Pt0

Z AppleScript: autoConvert text

Z

JavaScript: TextPreservePolicy.AUTOMATICALLYCONVERTTEXT

Z VBScript: AiAutomaticallyConvertText

Z AppleScript: coordinate system

Z JavaScript: coordinateSystem

Z VBScript: CoordinateSystem

l’angle supérieur gauche, et pour le nom du plan de travail:

Z AppleScript

ruler origin of artboard 1 of document 1
name of artboard 1 of document 1

JavaScript

Z

activeDocument.artboards[0].rulerOrigin
activeDocument.artboards[0].name

Z VBScript

ActiveDocument.Artboards[1].RulerOrigin
ActiveDocument.Artboards[1].Name

CHAPITRE 1 : Introduction Changements survenus dans la versionCS5 14

X

Nouvelle méthode/commande dans la classe Document pour travailler avec différents systèmes de
coordonnées:

Z AppleScript: convert coordinate

Z JavaScript: app.activeDocument.convertCoordinate()

Z VBScript: App.ActiveDocument.ConvertCoordinate()

X Nouvelles méthodes/commandes dans la classe Document pour travailler avec plusieurs plans de

travail:

Z AppleScript

select objects on active artboard
fit artboard to selected art
rearrange artboards

JavaScript

Z

activeDocument.selectObjectsOnActiveArtboard()
activeDocument.fitArtboardToSelectedArt()
activeDocument.rearrangeArtboards()

VBScript

Z

ActiveDocument.SelectObjectsOnActiveArtboard()
ActiveDocument.FitArtboardToSelectedArt()
ActiveDocument.RearrangeArtboards()

Nouvelles méthodes/commandes dans la classe Document pour travailler avec des grilles de

X

perspective:

Z AppleScript

import perspective grid preset
export perspective grid preset
select perspective preset
show perspective grid
hide perspective grid
get perspective active plane
set perspective active plane

JavaScript

Z

app.activeDocument.importPerspectiveGridPreset()
app.activeDocument.exportPerspectiveGridPreset()
app.activeDocument.selectPerspectiveGrid()
app.activeDocument.showPerspectiveGrid()
app.activeDocument.hidePerspectiveGrid()
app.activeDocument.getPerspectiveActivePlane()
app.activeDocument.setPerspectiveActivePlane()

CHAPITRE 1 : Introduction Changements survenus dans la versionCS5 15

Z

VBScript

App.ActiveDocument.ImportPerspectiveGridPreset()
App.ActiveDocument.ExportPerspectiveGridPreset()
App.ActiveDocument.SelectPerspectiveGrid()
App.ActiveDocument.ShowPerspectiveGrid()
App.ActiveDocument.HidePerspectiveGrid()
App.ActiveDocument.GetPerspectiveActivePlane()
App.ActiveDocument.SetPerspectiveActivePlane()

Nouvelle méthode dans la classe PageItem pour travailler avec des grilles de perspective:

X

Z AppleScript: bring in perspective

Z JavaScript: bringInPerspective()

Z VBScript: BringInPerspective()

X Nouvelle propriété dans la classe PageItem pour l’alignement des pixels:

Z AppleScript: pixel aligned

Z

JavaScript: pixelAligned

VBScript: PixelAligned

Z

X Nouvel argument de création facultatif pour la méthode Add de la collection Symbols qui permet de

définir le point d’enregistrement des nouveaux symboles:

X Nouvelle propriété dans la classe TextFrameItem pour le type de lissage de texte:

Z AppleScript: antialias

Z

JavaScript: antialias

VBScript: Antialias

Z

Classe de données

X La classe PrintFLOptions s’appelle désormais PrintFlattenerOptions en JavaScript et VBScript.

En AppleScript,

X Changements apportés aux propriétés de la classe FXGSaveOptions:

Z AppleScript

Ajoutée:
Supprimée: clip content
Paramètres par défaut modifiés:

blends policy

version: version1.0 remplacée par version2.0
text policy
gradients policy

RegistrationPoint.

flattening options reste inchangé.

: keep text editable remplacée par autoConvert text

: keep gradients editable remplacée par autoConvert gradients

JavaScript

Z

Ajoutée:

blendsPolicy

Supprimée: clipContent
Paramètres par défaut modifiés:

CHAPITRE 1 : Introduction Problèmes connus 16

Z

version
textPolicy
gradientsPolicy

VBScript

Ajoutée:

: FXGVersion.VERSION1PT0 remplacée par FXGVersion.VERSION2PT0

: textPolicy.KEEPTEXTEDITABLE remplacée par AUTOMATICALLYCONVERTTEXT

: gradientsPolicy.KEEPGRADIENTSEDITABLE remplacée par

AUTOMATICALLYCONVERTGRADIENTS

BlendsPolicy

Supprimée: ClipContent
Paramètres par défaut modifiés:

Version: FXGVersion.VERSION1PT0 remplacée parFXGVersion.VERSION2PT0
TextPolicy
GradientsPolicy

aiAutomaticallyConvertGradients

X

Nouvelles propriétés dans la classe de données OpenOptions pour travailler avec les plans de travail:

Z AppleScript

convert crop area to artboard
convert tiles to artboard
create artboard with artwork bounding box
preserve legacy artboard

JavaScript

Z

: aiKeepTextEditable remplacée par aiAutomaticallyConvertText

: aiKeepGradientsEditable remplacée par

convertCropAreaToArtboard
convertTilesToArtboard
createArtboardWithArtworkBoundingBox
preserveLegacyArtboard

VBScript

Z

ConvertCropAreaToArtboard
ConvertTilesToArtboard
CreateArtboardWithArtworkBoundingBox
PreserveLegacyArtboard

Problèmes connus

X Les scripts qui créent, enregistrent et ferment un grand nombre de fichiers Illustrator devraient

régulièrement quitter Illustrator, puis le relancer. Le nombre maximal recommandé de fichiers à traiter
avant de quitter Illustrator, puis de le relancer est de:

Z Sous Windows 500fichiers

Z Sous Mac OS 1000fichiers

Pour plus d’informations sur la manière dont vous pouvez quitter et relancer Illustrator, reportez-vous
aux sections «

X Le message d’avertissement «An Illustrator error occurred: 1346458189 (“PARM”)» peut apparaître

quand des scripts mal rédigés sont exécutés plusieurs fois dans Illustrator depuis ESTK.

Lancement et activation d’Illustrator », page 26 et « Fermeture d’Illustrator », page 27.

Les auteurs de scripts doivent faire très attention à l’initialisation des variables ainsi qu’aux conflits
engendrés par les espaces de noms lorsqu’ils lancent l’exécution répétée d’un lot de scripts Illustrator
dans Illustrator par le biais d’ESTK, et ce dans le cadre d’une session Illustrator unique. Chaque script
lancé est exécuté au sein du même moteur ExtendScript persistant dans Illustrator.

CHAPITRE 1 : Introduction Problèmes connus 17

Le débogueur ESTK utilise BridgeTalk pour communiquer avec Illustrator. Un moteur ExtendScript
persistant, global et unique au sein d’Illustrator gère l’ensemble des communications BridgeTalk.
Grâce à Internet, le moteur ExtendScript s’ajoute à tous les scripts exécutés précédemment.
Les problèmes de code de script pouvant être à l’origine de cet incident sont les suivants:

Z lecture de variables non initialisées;

Z conflits d’espaces de noms globaux, par exemple lorsque deux ensembles de scripts différents

s’opposent.

X Si vous créez plusieurs objets d’illustration dans AppleScript et affectez chacun d’eux à une variable,

toutes les variables sont définies sur le dernier élément. Cela signifie que les éléments créés
précédemment ne sont pas accessibles.

2

Modèle d’objet de script Illustrator

Bien comprendre le modèle d’objet Illustrator vous permettra d’améliorer vos capacités d’écriture de
script. Le schéma suivant présente la hiérarchie de contenance du modèle d’objet, qui commence par

application. Les classes layer et group item peuvent comporter des objets imbriqués

l’objet
susceptibles, eux aussi, de renfermer des objets imbriqués supplémentaires.

En plus de ces modèles d’objets spécifiques aux applications, JavaScript fournit certains objets utilitaires,
tels que les objets
système d’exploitation. Pour plus de détails, reportez-vous au Guide des outils JavaScript.

File et Folder, qui vous permettent un accès au système de fichiers indépendant du

18

CHAPITRE 2 : Modèle d’objet de script Illustrator Conventions d’attribution de nom pour les objets 19

Conventions d’attribution de nom pour les objets

Il existe un modèle d’objet pour l’interface de script Illustrator, mais les noms d’objets réels varient
légèrement selon les langages de script:

X Sous AppleScript, les noms figurent tous en minuscules et les mots individuels sont séparés par un

espace, par exemple:

graphic style

X

Sous VBScript, les noms commencent par une majuscule et les autres mots contenus dans le nom se
distinguent par une première lettre en majuscule, par exemple:

GraphicStyle

Sous JavaScript, le nom commence par une minuscule et les autres mots contenus dans le nom se

X

distinguent par une première lettre en majuscule, par exemple:

graphicStyle

Ce chapitre utilise des noms d’objets et de propriétés génériques, mais vous pouvez appliquer aisément
ces conventions pour déterminer les noms correspondant à un langage spécifique.

Les noms de propriétés, noms de méthodes et objets cités dans ce document sont en police

Objets de niveau supérieur (objets conteneurs)

Utilisez ces objets pour accéder à des informations globales sur l’application Illustrator ou à un document
individuel.

Application

Les propriétés de l’objet application permettent à votre script d’accéder à des valeurs globales, telles que:

X la propriété preferences qu’un utilisateur définit de manière interactive dans l’application Illustrator

à l’aide de la boîte de dialogue Préférences (Edition> Préférences);

X les informations système telles que les polices installées (propriété text fonts) et les imprimantes

(propriété

Il existe aussi des propriétés qui fournissent des informations spécifiques aux applications et des informations
de niveau supérieur relatives à tout document ouvert:

X les informations relatives aux applications, telles que le chemin d’installation, la version et le caractère

visible d’Illustrator (propriétés

X le document sélectionné (current active), c’est-à-dire la toile affichée et l’acceptation de la saisie de

texte de l’utilisateur;

printer list).

path, version et visible respectivement);

monospaced.

X tous les documents ouverts (documents).

Les commandes ou méthodes de l’objet

application permettent à votre script d’effectuer des actions au

niveau des applications, par exemple:

X Open: ouvrir des fichiers

X Undo et Redo: annuler et rétablir des opérations

X Quit: fermer Illustrator

CHAPITRE 2 : Modèle d’objet de script Illustrator Hiérarchie des illustrations 20

Document

L’o b j e t document que vos scripts permettent de créer ou auquel ils peuvent accéder à partir de l’objet

application représente une toile ou un fichier Illustrator chargé. Les propriétés de l’objet document vous

permettent d’accéder au contenu du document, par exemple:

X

la sélection en cours (

X tous les objets graphiques insérés, appelés page items, qui organisent la hiérarchie des illustrations;

X les objets graphiques particuliers, tels que les symboles (symbols) et les blocs de texte (text frames);

X tous les calques (layers) et le calque actif (active layer).

Les propriétés du document vous renseignent également sur l’état du document en lui-même, par exemple:

X paramètres utilisateur associés au document, tels que ruler units;

X enregistrement (saved) éventuel du document depuis la dernière modification du contenu;

X chemin (path) du fichier associé.

selection

) ou les objets graphiques sélectionnés par l’utilisateur dans le document;

Les méthodes de l’objet

X Enregister (save) dans un fichier Illustrator ou enregistrer sous (save as) l’un des formats de fichier pris

X Activer (activate) ou fermer (close) un document

X Imprimer (print) le document. Vos scripts peuvent sélectionner une imprimante en référençant un

Calque

L’o b j e t layer permet d’accéder au contenu, ou hiérarchie des illustrations, d’un calque spécifique. Vous
pouvez accéder à l’objet
à un calque ou d’obtenir des informations sur celui-ci, notamment:

X le caractère visible (visible) ou verrouillé (locked) du calque;

X l’opacité (opacity) du calque (transparence globale) et sa position dans la pile (z order position);

X les préférences associées au calque en matière de création artistique, telles que artwork knockout et

document permettent à vos scripts d’agir sur le document, par exemple:

en charge

print options ou bien référencer les imprimantes disponibles via la propriété printer list

objet
de l’objet d’application.

layer via l’objet document. Les propriétés de l’objet layer permettent d’accéder

blending mode.

Hiérarchie des illustrations

Le contenu d’un document Illustrator est appelé hiérarchie des illustrations. L’illustration est représentée
par les objets suivants:

X compound path item

X graph item

X group item

X legacy

text item

CHAPITRE 2 : Modèle d’objet de script Illustrator Hiérarchie des illustrations 21

X mesh

X non native item

X path item

X placed item

X plugin item

X raster item

X symbol item (voir « Objets dynamiques », page 25).

X text frame

item

Vos scripts peuvent accéder à des objets graphiques et les manipuler via des collections à partir des objets

document et layer. Il existe deux types de collections d’objets graphiques:

X Les objets de collection qui correspondent à chaque type d’objet d’illustration individuel, tel que

graph items ou l’objet mesh items.

l’objet

X L’o b j e t page items, qui inclut tous les types d’objets graphiques.

Vous pouvez également utiliser l’objet

group item pour référencer un ensemble groupé d’éléments

d’illustration.

Vous pouvez créer des objets graphiques à l’aide de la commande

add de l’objet de collection d’un élément d’illustration. Par exemple, pour créer un objet path item:

make sous AppleScript ou de la méthode

AppleScript set myPathItem to make new path item in current document

JavaScript var myPathItem = activeDocument.pathItems.add();

VBScript Set myPathItem = appRef.ActiveDocument.PathItems.Add()

Les collections d’illustrations ci-dessous ne permettent pas la création d’objets par le biais de la
commande

X Objet graph items

X

Objet mesh items

X

Objet plugin items

X Objet legacy text items

make ou de la méthode add:

Pour plus d’informations sur la création d’objets de ce type, reportez-vous au document Adobe
IllustratorCS5 Scripting Reference (Référence de script Adobe IllustratorCS5) correspondant au langage

utilisé.

Styles d’illustration

Votre script peut appliquer un style graphique à une illustration à l’aide de l’objet graphic style. Pour
appliquer un style graphique, utilisez la propriété
méthode

apply to de l’objet graphic style.

graphic styles de l’objet document afin d’accéder à la

De la même manière, l’objet

brush vous permet d’indiquer la forme à appliquer à l’illustration. Vous

pouvez accéder à n’importe quelle forme à partir de l’objet de collection
de l’objet

document.

brushes, qui est une propriété