[PDF] Adobe Introduction to Scripting

View - Download Adobe Introduction to Scripting

Previous PDF

Next PDF

ADOBE

INTRODUCTION

À L"ÉCRITURE DE SCRIPTS

© Copyright 2009 Adobe Systems Incorporated. Tous droits réservés. Adobe

Introduction à l"écriture de scripts

AVIS : Toutes les informations contenues dans ce document sont la propriété d"Adobe Systems Incorporated. Aucune

partie de ce document (que ce soit sous forme de copie papier ou électronique) ne peut être reproduite ni transmise,

sous quelque forme ou par quelque moyen que ce soit (électronique, mécanique, photocopie, enregistrement ou autre)

sans autorisation écrite préalable d"Adobe Systems Incorporated. Le logiciel décrit dans ce document est fourni sous

licence et peut être copié ou utilisé uniquement en conformité avec les dispositions de cette licence.

Ce document et les informations contenues sont fournis EN L"ETAT et peuvent être modifiés sans préavis. Ils ne constituent

en aucune manière un engagement de la part d"Adobe Systems Incorporated. Adobe Systems Incorporated ne peut être

tenu pour responsable des erreurs ou inexactitudes et rejette toute garantie (expresse, tacite ou contractuelle) concernant

ce document, notamment concernant sa qualité marchande ou son adéquation à un usage particulier et la non-contrefaçon

des droits d"un tiers.

Toute référence à des noms de société dans les modèles d"exemple n"est utilisée qu"à titre d"exemple et ne fait référence à

aucune société réelle. Adobe , le logo Adobe, Illustrator , InDesign et Photoshop sont des marques ou des marques déposées d"Adobe Systems Incorporated aux Etats-Unis et/ou dans d"autres pays. Apple , Mac OS et Macintosh 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/ou dans d"autres pays. JavaScript TM et toutes les marques relatives à 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 citées sont la propriété de leurs détenteurs respectifs.

Si le présent guide est distribué avec un logiciel sous contrat de licence de l"utilisateur final, ce guide, de même que le

logiciel dont il traite, est cédé sous licence et ne peut être copié ou utilisé que conformément à cette licence. Sauf

autorisation spécifique dans la licence, aucune partie de cette publication ne peut être reproduite, enregistrée sur un

système de recherche ou transmise sous quelque forme ou par quelque moyen que ce soit (enregistrement électronique,

mécanique ou autre), sans l"autorisation écrite préalable d"Adobe Systems Incorporated. Notez que le contenu de ce

manuel est protégé par des droits d"auteur, même s"il n"est pas distribué avec un logiciel accompagné d"un contrat de

licence pour l"utilisateur final.

Les informations contenues dans ce guide sont fournies à titre informatif uniquement ; 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.

Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, Etats-Unis. 3

Table des matières

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Est-ce difficile de créer des scripts ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Pourquoi utiliser un script? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Comment savoir quand utiliser un script ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Qu"en est-il des actions ou des macros ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

L"écriture de scripts, c"est quoi au juste ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

AppleScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

VBScript : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Par où dois-je commencer ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

AS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

JS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

VBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2 Bases de l"écriture de scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Modules de l"écriture de scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Utilisation des objets, des propriétés, des méthodes et des commandes . . . . . . . . . . . . . . . . . . . . . . . 9

Utilisation des objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Concepts DOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Les références d"objet facilitent la vie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Les variables offrent un raccourci convivial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Dénomination des variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Ensembles ou éléments d"objets comme références d"objet . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Comment les éléments et les ensembles numérotent les éléments

suivants ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Référence à l"objet actuel ou actif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Utilisation des propriétés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

AS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

JS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

VBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Utilisation des propriétés lecture seule et lecture-écriture . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Utilisation des avertissements de sécurité pour afficher la valeur d"une

propriété . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Valeurs constantes et énumérations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

AS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

JS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

VBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Utilisation de variables pour les valeurs de propriété . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Utilisation de méthodes ou commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Paramètres des commandes ou méthodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Paramètres requis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Paramètres multiples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Table des matières 4

Instructions Tell (AS uniquement) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Remarques sur les variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Modification de la valeur d"une variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Utilisation de variables pour faire référence à des objets existants . . . . . . . . . . . . . . . . . . . . 28

Rendre les fichiers de script lisibles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Commenter le script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Continuer des lignes longues en AppleScript et VBScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Utilisation de tableaux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Création d"objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Informations supplémentaires sur l"écriture de scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

3 Recherche de propriétés et de méthodes d"objets . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Utilisation de navigateurs dans un environnement de script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Dictionnaires de données AppleScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Affichage des dictionnaires AppleScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Utilisation des dictionnaires AppleScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Visionneuse de modèle objet (Object Model Viewer) JavaScript . . . . . . . . . . . . . . . . . . . . . . 36

Bibliothèques de types VBScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Affichage des bibliothèques de types VBScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Utilisation des bibliothèques de types VBScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Utilisation des documents de référence Adobe relatifs à l"écriture de scripts . . . . . . . . . . . . . . . . . . . 41

Utilisation du tableau d"éléments d"un objet (AS uniquement) . . . . . . . . . . . . . . . . . . . . . . . . 42

Utilisation du tableau de propriétés d"un objet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Utilisation du tableau de méthodes d"un objet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

4 Techniques d"écriture de scripts avancées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Instructions conditionnelles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

instructions if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Instructions if else . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Boucles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Informations supplémentaires sur l"écriture de scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

5 Résolution des problèmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Mots réservés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Messages d"erreur de l"éditeur de scripts AppleScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Messages d"erreur de l"ESTK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Messages d"erreur de VBScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

6 Bibliographie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

AppleScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

VBScript : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

5 1

Introduction

L"écriture de scripts est un outil puissant qui vous permet de contrôler et d"automatiser un grand nombre

de fonctionnalités dans un grand nombre d"applications Adobe et vous permet de gagner tellement de temps et d"efforts que votre approche du travail s"en trouve complètement changée.

Est-ce difficile de créer des scripts ?

Les scripts sont différents des programmes. Il n"est pas nécessaire de disposer d"un diplôme en informatique

ou en mathématiques pour créer des scripts pouvant automatiser un vaste éventail de tâches courantes.

Chaque élément de script correspond à un outil, une palette ou un menu d"une application Adobe.

En d"autres termes, chaque élément de script correspond à des connaissances que vous possédez déjà sous

Adobe. Si vous savez ce que vous souhaiteriez que vos applications Adobe fassent, il ne vous sera pas difficile

d"apprendre à écrire un script.

Pourquoi utiliser un script?

Votre travail de conception graphique est caractérisé par la créativité, mais, en pratique, la plupart des tâches

n"ont rien de créatif. Il y a de fortes chances que vous passiez le plus clair de votre temps à exécuter des

tâches répétitives ou similaires.

Ne serait-il pas pratique de pouvoir embaucher un assistant heureux d"exécuter les tâches ennuyeuses,

de suivre vos instructions de manière prévisible et parfaitement régulière, qui soit disponible à tout moment,

travaille à la vitesse de la lumière et ne vous envoie jamais de facture ?

Cet assistant, ce peut être le script. Il ne faut pas longtemps pour apprendre à générer des scripts permettant

d"exécuter les tâches répétitives qui vous font perdre votre temps. Mais s"il est facile de s"y mettre, les langages

de script modernes sont assez sophistiqués pour automatiser des tâches très compliquées. Au fur et à

mesure que votre expérience s"accroît, vous pourrez passer à des scripts plus complexes exécutables de

nuit pendant votre sommeil.

Comment savoir quand utiliser un script ?

Pensez à votre travail : ne comporte-t-il pas une tâche répétitive qui vous ennuie au plus haut point ?

Si c"est le cas, voilà déjà une bonne raison d"écrire un script. Il vous suffira ensuite de déterminer :

quelles sont les étapes nécessaires à l"exécution de cette tâche et? quelles sont les conditions dans lesquelles vous devez effectuer cette tâche?

Une fois que vous avez compris le processus d"exécution manuelle de cette tâche, vous êtes prêt à en

écrire le script.

CHAPITRE 1 : IntroductionQu"en est-il des actions ou des macros ? 6

Qu"en est-il des actions ou des macros ?

Si vous avez utilisé des actions ou rédigé des macros, vous pouvez vous faire une idée de l"efficacité des

scripts. Mais l"écriture de scripts va au-delà de l"automatisation d"actions ou de macros ; elle permet de

manipuler des documents et des applications multiples en un seul script. Par exemple, vous pouvez créer

un script qui manipule une image sous Adobe Photoshop et ordonne ensuite à Adobe InDesign d"incorporer cette image.

En outre, votre script peut très intelligemment retrouver des informations et y répondre en conséquence.

Par exemple, si vous avez un document qui contient des photos de différentes tailles. vous pouvez créer un

script qui sélectionne la taille de chaque photo et crée une bordure colorée différente selon chaque taille.

Ainsi, les formats icônes peuvent avoir une bordure bleue, les petites illustrations une bordure verte et les

photos d"une demi-page une bordure argentée.

Si vous aimez utiliser des actions, n"oubliez pas que votre script peut exécuter ces dernières dans l"application.

L"écriture de scripts, c"est quoi au juste ?

Un script est une série d"instructions qui ordonnent à une application d"exécuter un ensemble de tâches.

Le truc consiste à écrire ces instructions dans un langage reconnu par l"application. Les applications Adobe

pour lesquelles vous pouvez écrire des scripts prennent en charge plusieurs langages.

Si vous travaillez sous Mac OS

, vous pouvez utiliser :

AppleScript

JavaScript

Si vous travaillez sous Windows

, vous pouvez utiliser : VBScript (Visual Basic et VBA fonctionnent également)

JavaScript

Les brèves descriptions ci-dessous peuvent vous aider à déterminer le langage qui vous conviendra le mieux.

AppleScript

AppleScript est un langage de script " en langue courante » développé par Apple. C"est l"un des langages

de script les plus simples à utiliser.

Pour écrire des scripts AppleScript, vous pouvez utiliser l"application Editeur de scripts d"Apple, qui, dans

une installation par défaut Mac OS, se trouve dans : disque système:Applications:AppleScript:Editeur de scripts

Pour plus d"informations sur l"utilisation de l"application Editeur de scripts, reportez-vous à l"aide

correspondante. CHAPITRE 1 : IntroductionL"écriture de scripts, c"est quoi au juste ? 7

VBScript :

VBScript est un sous-ensemble du langage de programmation Visual Basic développé par Microsoft. VBScript

communique avec les applications hébergées à l"aide d"ActiveX Scripting. Si VBScript est la version du

langage Visual Basic officiellement prise en charge par CS5, vous pouvez également écrire des scripts en

VBA et Visual Basic lui-même.

Vous pouvez trouver plusieurs bons éditeurs VBScript sur Internet. Si vous avez une application Microsoft

Office, vous pouvez également utiliser l"éditeur Visual Basic intégré en sélectionnant Outils > Macro >

Visual Basic Editor.

JavaScript

JavaScript est un langage de script très répandu développé à l"origine pour rendre les pages Web interactives.

Tout comme AppleScript, JavaScript est facile à apprendre. R

EMARQUE : Adobe a développé une version améliorée de JavaScript appelée ExtendScript, qui vous permet

de bénéficier des avantages de certains outils et fonctionnalités de script d"Adobe. Si vous êtes débutant,

la différence entre ces deux langages ne devrait pas vous affecter. Prenez toutefois l"habitude de donner

une extension .jsx à vos scripts JavaScript, plutôt que l"extension habituelle .js. JavaScript possède quelques petits avantages sur AppleScript et Visual Basic :

Vos scripts peuvent être utilisés soit sous Windows, soit sous Mac OS. Si vous êtes amené à partager ou

à utiliser vos scripts dans les deux plates-formes, apprenez alors à utiliser JavaScript.

Sous Adobe Illustrator

et InDesign, vous pouvez accéder aux scripts dans n"importe quel langage pris

en charge à partir de l"application. Néanmoins, sous Photoshop, vous ne pouvez accéder qu"aux fichiers

.jsx à partir de l"application. Vous devez utiliser les scripts AppleScript ou Visual Basic en dehors de

l"application. Cela ne constitue pas un inconvénient majeur, mais il vous faudra quelques clics de plus

pour exécuter vos scripts.

Vous pouvez configurer les scripts .jsx pour qu"ils s"exécutent automatiquement lorsque vous ouvrez

l"application, en les plaçant dans le dossier Startup Scripts de l"application. Pour plus d"informations

sur les dossiers Startup Scripts, reportez-vous au guide d"écriture de scripts de votre application.

Pour écrire des scripts en JavaScript, vous pouvez utiliser n"importe quel éditeur de texte, ou encore l"ESTK

(ExtendScript Tool Kit) fourni avec vos applications Adobe. L"ESTK possède un large éventail de fonctionnalités

qui rendent son utilisation plus facile qu"un éditeur de texte, notamment grâce à un correcteur de syntaxe

intégré qui identifie les problèmes liés à votre script et suggère des moyens de les résoudre, et grâce à la

possibilité d"exécuter vos scripts directement à partir de l"ESTK sans sauvegarder le fichier. Cette deuxième

fonctionnalité vous permet de gagner beaucoup de temps, surtout au début s"il vous faut tester et modifier

un script plus d"une fois avant que celui-ci ne soit prêt à fonctionner. Dans une installation Adobe par défaut, l"ESTK se trouve à l"emplacement suivant :

Mac OS :

disque système:Applications:Utilities:Adobe Utilities - CS5:ExtendScript Toolkit CS5 Windows : lecteur:/Program Files/Adobe/Adobe Utilities - CS5/ExtendScript Toolkit CS5 Pour plus d"informations, reportez-vous au Guide JavaScript Tools. CHAPITRE 1 : IntroductionPar où dois-je commencer ? 8

Par où dois-je commencer ?

Il est temps d"écrire votre premier script.

R

EMARQUE : Si vous rencontrez des problèmes pour exécuter votre script, reportez-vous au Chapitre 5,

"Résolution des problèmes». AS

1. Ouvrez l"Editeur de scripts et tapez (en changeant le nom de l"application Adobe entre guillemets) :

tell application "Adobe Photoshop CS5" make document end tell

2. Cliquez sur Exécuter.

JS

1. Ouvrez l"ESTK et sélectionnez une application dans la liste déroulante située en haut à gauche de la

fenêtre du document.

2. Dans la palette Console de JavaScript, tapez :

app.documents.add()

3. Effectuez l"une des opérations suivantes :

Cliquez sur l"icône Exécuter dans la barre d"outils située en haut de la fenêtre du document.

Appuyez sur la touche F5.

Sélectionnez Debug (Débogage) -> Run (Exécuter). VBS

1. Dans un éditeur de texte, tapez (en changeant le nom de l"application Adobe entre guillemets de la

deuxième ligne) : Set appRef = CreateObject("Photoshop.Application") appRef.Documents.Add()

2. Sauvegardez le fichier au format texte avec une extension .vbs (par exemple, creer_doc.vbs).

3. Double-cliquez sur le fichier dans Windows Explorer.

9 2

Bases de l"écriture de scripts

Ce chapitre présente les concepts de base de l"écriture de scripts sous Windows et sous Mac OS. Pour des

instructions spécifiques à un produit, reportez-vous au guide d"écriture de scripts de votre application Adobe.

Modules de l"écriture de scripts

Votre premier script, qui a créé un nouveau document, a été construit comme une phrase en français, avec

un nom ( document) et un verbe (make en langage AS, add() en langage JS et Add en langage VBS). Dans

l"écriture de scripts, un nom est appelé un objet et un verbe une commande (en AS) ou une méthode (en JS

et VBS). Exactement comme vous pouvez modifier un nom en utilisant un adjectif, vous pouvez modifier un objet

de script en utilisant des propriétés. Pour modifier une commande ou une méthode, vous utilisez des

paramètres. Utilisation des objets, des propriétés, des méthodes et des commandes Lorsque vous utilisez une application Adobe, vous ouvrez un fichier ou un document, puis, au sein du

document, vous créez ou manipulez des calques, du texte, des blocs, des couches, des lignes de graphique,

des couleurs et d"autres éléments créatifs. Ces éléments sont des objets.

Pour créer une instruction de script, vous créez un objet ou faites référence à un objet existant, puis vous

procédez comme suit :

Définissez des valeurs pour les propriétés de l"objet. Par exemple, vous pouvez indiquer le nom,

la hauteur ou la largeur d"un document. Vous pouvez spécifier le nom, la couleur ou l"opacité d"un calque.

Spécifiez des commandes ou des méthodes pour indiquer au script ce qu"il doit faire à vos objets.

Par exemple, vous pouvez ouvrir, fermer, enregistrer et imprimer un document. Vous pouvez fusionner, déplacer ou pixelliser un calque.

Gardez à l"esprit lorsque vous rédigez un script que vous ne pouvez utiliser que les propriétés ou

méthodes/commandes autorisées pour l"objet. Comment savoir quelles propriétés et méthodes sont

autorisées pour quel objet ? La plupart du temps, c"est logique. En général, si vous pouvez indiquer quelque

chose dans votre application Adobe, vous pouvez l"indiquer dans un script.

Néanmoins, Adobe l"explique également en détail dans les ressources de l"écriture de scripts qui contiennent

les informations dont vous avez besoin pour créer, définir et manipuler les objets de script. Pour plus

d"informations sur l"emplacement et l"utilisation de ces ressources, reportez-vous au Chapitre 3, " Recherche

de propriétés et de méthodes d"objets ». CHAPITRE 2 : Bases de l"écriture de scriptsUtilisation des objets 10

Utilisation des objets

Le principal concept à comprendre pour utiliser des objets dans des scripts est de savoir comment faire

référence à un objet. Comment faire savoir à l"application quel objet vous voulez que votre script modifie ?

Dans l"interface utilisateur de l"application, vous pouvez simplement sélectionner l"objet en cliquant dessus.

Dans un script, il y a un peu plus à faire.

Concepts DOM

Les langages de script utilisent un Document Object Model (DOM) pour organiser les objets de façon à ce

qu"ils soient faciles à identifier. Le principe sous-jacent un DOM est la hiérarchie de confinement. En d"autres

termes, les objets de niveau supérieur contiennent les objets du niveau suivant, qui contiennent le niveau

suivant d"objets, etc.

Par exemple, l"objet de niveau supérieur de tout DOM d"une application Adobe est l"objet application.

Ensuite vient l"objet document qui contient tous les autres objets, comme les calques, les couches, les

pages, les blocs de texte, etc. Ces objets peuvent contenir des objets que le document ne peut pas contenir

directement. Par exemple, sous InDesign ou Illustrator, un bloc de texte peut contenir des mots. Un document

ne peut pas contenir de mots sans bloc de texte. De même, sous Photoshop, un document peut contenir

un calque et un calque peut contenir un bloc de texte mais un document ne peut pas contenir de bloc de

texte si le document ne contient pas de calque. R EMARQUE : Un objet contenant un objet est également appelé objet parent.

Dans votre premier script, vous avez tout d"abord nommé l"objet application (ou vous l"avez sélectionné

dans l"ESTK), puis vous avez créé le document dans cette application. Si, comme étape suivante, vous

vouliez créer un calque, votre script aurait eu besoin d"identifier le document dans lequel vous voulez créer

le calque. Si votre script n"indique pas à l"application exactement où créer un objet, votre script échoue.

R

EMARQUE : Pour consulter un tableau du DOM pour une application spécifique, reportez-vous au guide

d"écriture de scripts de l"application.

Donc, en utilisant votre principe DOM, comment ajoutez-vous un calque à un document ? (Pour modifier

ce script pour Photoshop, notez qu"un calque est appelé art layer en AS et les calques sont appelés artLayers en JS ou ArtLayers en VBS). AS tell application "Adobe Illustrator CS5" make document make layer in document end tell

JSapp.documents.layers.add()

VBSSet appRef = CreateObject("Illustrator.Application")docRef.Documents.Add appRef.Documents.Layers.Add

Si vous tentez d"exécuter ces scripts, vous obtiendrez une erreur car l"application ne sait pas quel document

choisir. Bien sûr, vous n"avez qu"un seul document d"ouvert mais cela ne sera pas toujours le cas.

En conséquence, les langages de script sont soumis à des conditions strictes spécifiant que tous les objets

soient explicitement identifiés dans chaque instruction de script. CHAPITRE 2 : Bases de l"écriture de scriptsUtilisation des objets 11 Ce guide présente trois moyens de faire référence aux objets :

Variables

Numéros d"ensemble ou d"élément

Objet " actuel » ou propriété de l"objet " actif »

Variables

Une variable est un élément que vous créez pour contenir des données dans votre script. Les données,

appelées valeur de la variable, peuvent être un objet de votre script ou une propriété qui décrit un objet.

Vous pouvez également considérer une variable comme un surnom que vous donnez à un objet ou à

d"autres données.

L"utilisation d"une variable pour contenir un objet facilite la référence à cet objet. La plupart des rédacteurs

de script créent une variable pour chaque objet de leur script.

Les scripts suivants créent un document, comme vous l"avez fait dans votre premier script. Néanmoins,

cette version du script crée une variable nommée myDoc pour contenir le document. Etudiez ces scripts, puis comparez-les à votre premier script. (Reportez-vous à "

Par où dois-je commencer ?», page 8.)

ASPour créer une variable en langage AS, utilisez la commande set suivie par le nom de la variable. Pour affecter une valeur de données à la variable, utilisez to suivi de la valeur. tell application "Adobe Illustrator CS5" set myDoc to make document end tell

JSPour créer une variable en langage JS, utilisez la commande var suivie par le nom de la variable. Pour

affecter une valeur de données, utilisez le symbole égal ( =) suivi de la valeur. Les espaces n"ont aucune importance de quelque côté que ce soit du symbole égal. var myDoc = app.documents.add()

VBSPour créer une variable en langage VBS, utilisez la commande Set suivie du nom de la variable. Pour

affecter une valeur de données, utilisez le symbole égal (=) suivi de la valeur. Les espaces n"ont aucune

importance de quelque côté que ce soit du symbole égal. Set appRef = CreateObject("Illustrator.Application")

Set docRef = appRef.Documents.Add

Les références d"objet facilitent la vie

Maintenant que vous connaissez une méthode pour faire référence à l"objet document créé dans le script,

il est facile d"ajouter le calque. (Pour modifier ce script pour Photoshop, notez qu"un calque est appelé

art layer en AS et les calques sont appelés artLayers en JS ou ArtLayers en VBS). AS tell application "Adobe Illustrator CS5" set myDoc to make document make layer in myDoc end tell CHAPITRE 2 : Bases de l"écriture de scriptsUtilisation des objets 12

Mieux : vous pouvez créer une autre variable pour contenir le calque. Cela nous permettrait de faire

facilement référence au calque si nous souhaitions définir ses propriétés ou ajouter un objet au calque.

tell application "Adobe Illustrator CS5" set myDoc to make document set myLayer to make layer in myDoc end tell

JSvar myDoc = app.documents.add()

myDoc.layers.add() Le même script à nouveau, cette fois-ci en créant une variable pour contenir le calque. var myDoc = app.documents.add() var myLayer = myDoc.layers.add() VBSSet appRef = CreateObject("Illustrator.Application")Set docRef = appRef.Documents.Add docRef.Layers.Add Le même script à nouveau, cette fois-ci en créant une variable pour contenir le calque. Set appRef = CreateObject("Photoshop.Application")

Set docRef = appRef.Documents.Add

Set layerRef = docRef.Layers.Add

Les variables offrent un raccourci convivial

Les variables qui contiennent des objets contiennent également l"ensemble de la hiérarchie de confinement

qui identifie l"objet. Par exemple, pour faire référence à myLayer, vous n"avez pas besoin de faire référence au document qui contient le calque. Les scripts suivants créent un bloc de texte dans myLayer. Notez que, lorsque vous utilisez myLayer, vous n"avez pas besoin de fournir d"informations de hiérarchie de confinement relatives au calque. R

EMARQUE : Le script suivant utilise la propriété contents pour ajouter du texte au bloc. Pour l"instant,

ne vous souciez pas du mécanisme d"utilisation des propriétés.

Le script suivant utilise des objets et des propriétés définis dans le modèle objet Illustrator CS5 ; il ne

fonctionne donc pas pour, par exemple, InDesign ou Photoshop. AS tell application "Adobe Illustrator CS5" set myDoc to make document set myLayer to make layer in myDocquotesdbs_dbs17.pdfusesText_23

[PDF] adobe illustrator scripting tutorial

[PDF] adobe illustrator scripts

[PDF] adobe illustrator scripts free download

[PDF] adobe illustrator sdk download

[PDF] adobe illustrator social media icons

[PDF] adobe illustrator social media templates

[PDF] adobe illustrator student free

[PDF] adobe illustrator trademark symbol

[PDF] adobe illustrator tutorials 2019

[PDF] adobe illustrator vector

[PDF] adobe ims

[PDF] adobe ims authentication

[PDF] adobe ims configuration

[PDF] adobe indesign cc 2019 tutorial pdf

[PDF] adobe indesign cc scripting guide javascript