Adobe PHOTOSHOP CS2 User Manual [de]

Photoshop

Skript-Handbuch

Adobe

bbc

Adobe® Creative Suite 2 Photoshop® Skript-Handbuch für Windows® und Macintosh®.

HINWEIS: Alle in dieser Dokumentation enthaltenen Informationen sind Eigentum von Adobe Systems Incorporated. Kein Teil dieser Publikation (einschließlich aller gedruckten und elektronischen Dokumente) darf ohne vorherige schriftliche Genehmigung durch Adobe Systems Incorporated auf irgendeine Weise vervielfältigt oder übertragen werden, weder elektronisch, noch mechanisch, noch durch Fotokopien, noch durch Aufzeichnungen, noch auf sonstige Art. Die hier beschriebene Software wird unter Lizenz bereitgestellt und darf nur gemäß den Bedingungen dieser Lizenz verwendet oder kopiert werden.

Diese Publikation und die enthaltenen Informationen werden ohne Mängelgewähr bereitgestellt, können jederzeit ohne Vorankündigung geändert werden und stellen keinerlei Verpflichtung seitens Adobe Systems Incorporated dar. Adobe Systems Incorporated übernimmt in Zusammenhang mit dieser Publikation keine Verantwortung oder Haftung für Fehler oder Ungenauigkeiten und gewährt keinerlei Garantien (ausdrücklich, stillschweigend oder aus gesetzlicher Haftung) und gewährt ausdrücklich keinerlei Garantie zur Marktfähigkeit, Eignung für einen bestimmten Zweck und der Nichtverletzung von Rechten Dritter.

Alle Verweise auf Firmennamen in Beispieldateien dienen nur der Veranschaulichung; Übereinstimmungen mit tatsächlichen Unternehmen oder Organisationen sind rein zufällig.

Adobe, das Adobe-Logo, Illustrator und Photoshop sind entweder eingetragene Marken oder Marken von Adobe Systems Incorporated in den USA und/oder anderen Ländern.

Apple, Mac und Macintosh sind eingetragene Marken von Apple Computer, Inc., in den USA und anderen Ländern . Microsoft und Windows sind entweder eingetragene Marken oder Marken der Microsoft Corporation in den USA und anderen Ländern. JavaScript und alle Java-bezogenen Marken sind entweder eingetragene Marken oder Marken von Sun Microsystems, Inc. in den USA und anderen Ländern. UNIX ist eine eingetragene Marke von The Open Group. Alle anderen Marken sind Eigentum ihrer jeweiligen Inhaber.

Alle anderen Marken sind Eigentum ihrer jeweiligen Inhaber.

Wenn dieses Handbuch mit Software vertrieben wird, die eine Endbenutzer-Lizenzvereinbarung umfasst, werden dieses Handbuch sowie die darin beschriebene Software unter Lizenz bereitgestellt und dürfen nur entsprechend den Bedingungen der Lizenz verwendet oder vervielfältigt werden. Kein Teil dieser Dokumentation darf ohne vorherige schriftliche Genehmigung von Adobe Systems Incorporated reproduziert, in Datenbanken gespeichert oder in irgendeiner Form – elektronisch, mechanisch, auf Tonträgern oder auf irgendeine andere Weise – übertragen werden, es sei denn, die Lizenz gestattet dies ausdrücklich. Beachten Sie, dass der Inhalt dieses Handbuchs urheberrechtlich geschützt ist, auch wenn er nicht zusammen mit Software vertrieben wird, die eine Endbenutzer-Lizenzvereinbarung umfasst.

Der Inhalt des Handbuchs dient lediglich zu Informationszwecken, kann jederzeit ohne Vorankündigung geändert werden und stellt keinerlei Verpflichtung seitens Adobe Systems Incorporated dar. Adobe Systems Incorporated übernimmt keine Verantwortung oder Haftung für Fehler oder Ungenauigkeiten in den Informationen in diesem Handbuch.

Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.

Inhalt

1 Einführung ................................................................................................................................... 1

Einführung zu diesem Handbuch.............................................................................................................................................1

Was sind Skripten?.........................................................................................................................................................................2

Warum Skripterstellung?.............................................................................................................................................................2

Warum Skripten statt Aktionen?............................................................................................................................................... 2

Systemanforderungen.................................................................................................................................................................. 3

Auswählen der Skriptsprache.................................................................................................................................................... 4

Neue Funktionen............................................................................................................................................................................ 5

2 Grundlagen der Skripterstellung ...............................................................................................6

Einführung in Objekte .................................................................................................................................................................. 6

Erstellen von Skriptanweisungen............................................................................................................................................. 7

Grundlagen des Objektmodells................................................................................................................................................7

Objektmodell von Photoshop CS2 .......................................................................................................................................... 9

Objektelemente und Sammlungen.......................................................................................................................................10

Objektverweise .............................................................................................................................................................................12

Befehle und Methoden ..............................................................................................................................................................13

Variablen..........................................................................................................................................................................................15

Objekteigenschaften...................................................................................................................................................................20

Objektklassen und Vererbung.................................................................................................................................................21

Arrays................................................................................................................................................................................................22

Dokumentieren von Skripten ..................................................................................................................................................22

Überlange Skriptzeilen...............................................................................................................................................................23

Erstellen eines Beispielskripts „Hello World“......................................................................................................................24

Operatoren .....................................................................................................................................................................................28

Bedingungsanweisungen .........................................................................................................................................................28

Subroutinen, Handler und Funktionen ................................................................................................................................32

Ausführen von JavaScripts aus AS oder VBS ......................................................................................................................34

Übergeben von AS- oder VBS-Argumenten an JavaScript............................................................................................34

Testen von Skripts und Beheben von Fehlern...................................................................................................................35

Bibliografie......................................................................................................................................................................................38

3 Skripten für Photoshop CS2 .....................................................................................................39

Anzeigen von Objekten, Befehlen und Methoden für Photoshop CS2....................................................................39

Festlegen des Application-Objekts als Ziel und Erstellen von Verweisen...............................................................40

Erstellen neuer Objekte in einem Skript ..............................................................................................................................41

Festlegen des aktiven Objekts.................................................................................................................................................43

Öffnen eines Dokuments...........................................................................................................................................................46

Speichern eines Dokuments ....................................................................................................................................................48

Festlegen von Anwendungsvoreinstellungen .................................................................................................................50

Zulassen oder Verhindern von Dialogfeldern....................................................................................................................50

Arbeiten mit dem Objektmodell von Photoshop CS2....................................................................................................51

Arbeiten mit Color-Objekten ...................................................................................................................................................68

Arbeiten mit Filtern .....................................................................................................................................................................71

Verwenden der Zwischenablage............................................................................................................................................72

Arbeiten mit Maßeinheiten ......................................................................................................................................................73

JavaScript-Beispiele für die Automatisierung des Workflows .....................................................................................78

Erweiterte Skripterstellung.......................................................................................................................................................78

Index ...........................................................................................................................................91

iii

Einführung

Einführung zu diesem Handbuch

Dieses Handbuch bietet eine Einführung zur Skripterstellung in Adobe® Photoshop CS2® unter Mac OS® und Windows Handbuch gelten, und Sie erhalten einen Überblick über die Voraussetzungen zur Skripterstellung in Photoshop CS2.

Im zweiten Kapitel sind das Objektmodell von Photoshop CS2 sowie die grundlegende Terminologie, die Konzepte und die Methoden der Skripterstellung beschrieben. Die Beispielcodes werden in drei Skriptsprachen angegeben:

● AppleScript

● VBScript

● JavaScript

Hinweis: Für jede dieser Sprachen stehen separate Referenzhandbücher zur Verfügung, die dieses

Im dritten Kapitel werden die Photoshop CS2-spezifischen Objekte und Komponenten behandelt und die erweiterten Skriptingmethoden für Photoshop CS2 beschrieben.

Hinweis: Beachten Sie auch die Datei Bitte lesen im Lieferumfang von Photoshop CS2. Dort finden Sie

. Im ersten Kapitel werden die grundlegenden Konventionen beschrieben, die in diesem

Skript-Handbuch ergänzen. Diese Referenzhandbücher befinden sich auf der Installations-CD.

aktuellste Informationen, Skriptbeispiele und Informationen zu Problemlösungen.

Konventionen in diesem Handbuch

Code und spezifische Sprachbeispiele sind in nicht-proportionaler Courier-Schrift formatiert:

app.documents.add

Bei AppleScript, VBScript und JavaScript gelten mehrere Konventionen. Folgende Abkürzungen werden verwendet:

● AS steht für AppleScript

● VBS steht für VBScript

● JS steht für JavaScript

Der Begriff „Befehle“ bezieht sich sowohl auf Befehle in AppleScript als auch auf Methoden in VBScript und JavaScript.

Wenn in diesem Handbuch bestimmte Eigenschaften und Befehle genannt werden, gelten dabei die Namenskonventionen von AppleScript für die jeweilige Eigenschaft. Die Entsprechungen in VBScript und JavaScript werden in Klammern angegeben. Beispiel:

„Die Eigenschaft Application-Objekts.“

In diesem Fall ist VBScript-Eigenschaft und

Bei umfangreicheren Codeblöcken werden die Skriptbeispiele in separaten Zeilen angegeben.

display dialogs (DisplayDialogs/displayDialogs) ist Teil des

display dialogs die AppleScript-Eigenschaft, DisplayDialogs ist die

displayDialogs ist die JavaScript-Eigenschaft.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Einführung 2

layer 1 of layer set 1 of current document

VBS

appRef.ActiveDocument.LayerSets(1).Layers(1)

app.activeDocument.layerSets[0].layers[0]

In manchen Fällen werden Wertelisten entsprechend den Skriptsprachen tabellarisch organisiert.

Was sind Skripten?

Ein Skript ist eine Reihe von Befehlen, mit denen Photoshop CS2 angewiesen wird, bestimmte Aktionen auszuführen, z. B. verschiedene Filter auf Auswahlen im geöffneten Dokument anzuwenden. Hierbei kann es sich um einfache Aktionen handeln, die nur ein einzelnes Objekt betreffen, oder um komplexe Operationen, die sich auf viele Objekte in einem Photoshop CS2-Dokument auswirken. Die Aktionen können auf Photoshop CS2 begrenzt sein oder auch andere Anwendungen aufrufen.

Skripten dienen der Automatisierung sich wiederholender Aufgaben und werden oft als kreatives Werkzeug eingesetzt, um Aufgaben zu rationalisieren, deren manuelle Ausführung zu zeitaufwendig wäre. Sie könnten z. B. ein Skript erstellen, um eine Reihe lokalisierter Versionen eines bestimmten Bildes zu erstellen oder um Informationen über die verschiedenen Farbprofile einer Sammlung von Bildern zusammenzustellen.

Warum Skripterstellung?

Grafikdesign hat zwar viel mit Kreativität zu tun, einige Aspekte der täglichen Arbeit beim Illustrieren und Bearbeiten von Bildern sind jedoch alles andere als kreativ. Durch Skripten können professionelle Grafikdesigner Zeit sparen, indem sie repetitive Produktionsaufgaben automatisieren, zum Beispiel das Skalieren oder Neuformatieren von Dokumenten.

Alle repetitiven Aufgaben eignen sich grundsätzlich für Skripten. Sobald Sie alle Schritte und Bedingungen kennen, die zum Ausführen einer Aufgabe erforderlich sind, können Sie ein Skript erstellen, das diese Aufgabe für Sie ausführt.

Warum Skripten statt Aktionen?

Wenn Sie bereits Photoshop CS2-Aktionen verwendet haben, dann sind Ihnen die großen Vorteile der Automatisierung repetitiver Aufgaben bekannt. Mit Skripten können Sie diese Vorteile erheblich erweitern, da Sie Funktionen einsetzen können, die in Photoshop CS2-Aktionen nicht verfügbar sind. Folgende Aufgabe können Sie beispielsweise mit Skripten automatisieren, nicht jedoch mit Aktionen:

● Sie können Bedingungslogik einsetzen, sodass das Skript je nach vorliegender Situation automatisch

„Entscheidungen“ trifft. Beispiel: Sie können ein Skript erstellen, das je nach Größe eines ausgewählten Bildbereichs eine andersfarbige Umrandung hinzufügt: „Wenn der ausgewählte Bereich kleiner als 2 x 4 Zoll ist, grüne Umrandung hinzufügen; andernfalls rote Umrandung hinzufügen.“

● Sie können mit einem einzigen Skript Aktionen ausführen, an denen mehrere Anwendungen beteiligt

sind. Beispielsweise könnten Sie je nach verwendeter Skriptsprache sowohl Photoshop CS2 als auch eine andere Anwendung der Adobe Creative Suite 2, z. B. Illustrator ansteuern.

● Sie können Dateien mit Skripten öffnen, speichern und umbenennen.

CS2, vom selben Skript aus

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Einführung 3

● Sie können Skripten von einem Computer auf einen anderen kopieren. Wenn Sie eine Aktion

verwenden und dann den Computer wechseln, müssen Sie dagegen die Aktion neu erstellen.

● Skripten sind flexibler beim automatischen Öffnen von Dateien. Wenn Sie eine Datei über eine Aktion

öffnen, müssen Sie den Speicherort der Datei hartcodieren. In einem Skript können Sie dagegen Variablen für die Dateipfade verwenden.

Hinweis: Weitere Informationen zu Photoshop CS2-Aktionen finden Sie in der Online-Hilfe von

Photoshop CS2.

Systemanforderungen

Skripterstellung wird auf allen Systemen unterstützt, auf denen Photoshop CS2 ausgeführt werden kann.

Mac OS

Auf einem Macintosh-System können Sie AppleScripts oder JavaScripts zur Verwendung in Photoshop CS2 erstellen.

Anforderungen für AppleScript

Auf einem Macintosh können Sie AppleScripts mit dem Skripteditor erstellen, der zum Lieferumfang von Mac OS gehört und im Ordner „Applications/AppleScript“ installiert ist. Wenn der Skripteditor nicht auf Ihrem System installiert wurde, können Sie ihn mithilfe der System-CD-ROM installieren.

Außerdem benötigen Sie AppleScript, das automatisch mit dem Betriebssystem installiert wurde. Sollte AppleScript nicht auf dem System vorhanden sein, können Sie es ebenfalls mithilfe der System-CD-ROM installieren.

Hinweis: Wenn Ihre Skripten komplexer werden, möchten Sie möglicherweise Debug- und

Produktivitätsfunktionen einsetzen, die im Skripteditor nicht verfügbar sind. Hierfür stehen zahlreiche Skripteditoren von Drittanbietern zur Verfügung, mit denen Sie Apple Scripts erstellen und debuggen können. Weitere Informationen finden Sie unter http://www.apple.com/applescript.

Weitere Informationen zur Skripterstellung mit AppleScript finden Sie unter „Anzeigen des

AppleScript-Wörterbuchs von Photoshop CS2“ auf Seite 39.

In den Beschreibungen in diesem Handbuch wird der Apple-Skripteditor für die Erstellung von AppleScripts verwendet. Weitere Informationen zur Verwendung des Skripteditors finden Sie unter

„Erstellen und Ausführen eines AppleScripts“ auf Seite 25

Anforderungen für JavaScript (Mac OS)

Sie können JavaScripts mit einem beliebigen Texteditor erstellen, der das Speichern von Textdateien mit der Erweiterung

Mit den Editoren der Standardinstallation des Apple-Betriebssystems, Skripteditor und TextEdit, können Sie keine JavaScript-Dateien erstellen und speichern. Auf der Mac OS-Installations-CD ist jedoch die Entwickleranwendung Project Builder enthalten, mit der Sie JavaScripts erstellen können.

.jsx unterstützt.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Einführung 4

Windows

Sie können auf Windows-Plattformen VBScript-Skripten mit einem beliebigen Texteditor erstellen, der das Speichern von Textdateien mit der Erweiterung

Weitere Informationen finden Sie unter „Erstellen und Ausführen eines VBScripts“ auf

Seite 26.

.vbs unterstützt.

JavaScript

Sie können JavaScripts auf Mac OS- oder Windows-Plattformen mit beliebigen Texteditoren erstellen. JavaScript-Dateien müssen Sie als Textdateien mit der Erweiterung

Weitere Informationen finden Sie unter „Erstellen und Ausführen eines JavaScripts“

auf Seite 26.

.jsx speichern.

Auswählen der Skriptsprache

Zwei Faktoren sind entscheidend dafür, welche Skriptsprache Sie verwenden:

1. Müssen Sie dasselbe Skript sowohl auf Macintosh- als auch auf Windows-Computern ausführen?

Wenn ja, müssen Sie JavaScript verwenden. Siehe „Plattformunabhängige Skripten“ auf

Seite 5.

2. Sind an der Aufgabe, die Sie mit dem Skript ausführen möchten, mehrere Anwendungen beteiligt (z. B. Photoshop CS2 und Illustrator CS2 oder ein Datenbankprogramm)?

Wenn ja, müssen Sie auf einem Macintosh ein AppleScript und unter Windows ein VBScript erstellen. Siehe „Skripten zum Steuern mehrerer Anwendungen“ auf Seite 5

Tipp:Sie können die Flexibilität von JavaScripts mit den plattformspezifischen Vorteilen von AppleScript

bzw. VBScript kombinieren, indem Sie JavaScripts aus Ihren AppleScripts oder VBScripts heraus aufrufen. Weitere Informationen finden Sie unter „Ausführen von JavaScripts aus AS

oder VBS“ auf Seite 34.

Hinweis: Sie können auch andere Skriptsprachen verwenden. Diese sind jedoch in diesem Handbuch

nicht dokumentiert.

● Unter Mac OS können Sie jede Sprache verwenden, mit der Sie Apple-Ereignisse auslösen

können.

● Unter Windows können Sie jede Sprache verwenden, die OLE-Automatisierung unterstützt.

Skripterstellung für frühere Versionen der OLE-Automatisierung

Photoshop CS2 unterstützt die Skripterstellung für frühere Versionen der OLE-Automatisierung, sofern Sie die Syntax anpassen, mit der Sie das Photoshop CS2Beispielsweise müssen Sie den Code

Application-Objekt in Ihren Skripten ansprechen.

Set appRef = CreateObject("Photoshop.Application")

wie folgt anpassen:

Set appRef = CreateObject("Photoshop.Application.9.1")

Weitere Anpassungen sind nicht erforderlich, um frühere Versionen von COM-Skripten unter Photoshop CS2 ausführen zu können.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Einführung 5

Plattformunabhängige Skripten

Da JavaScripts auf Windows- und Macintosh-Computern gleichermaßen ausgeführt werden können, gilt JavaScript als plattformunabhängige Skriptsprache.

Zum Ausführen eines JavaScript von Photoshop CS2 aus speichern Sie das Skript im Ordner „...Vorgaben\Skripten“ im Installationsverzeichnis von Photoshop CS2 und wählen das Skript aus dem Menü „Datei“ > „Skripten“ aus.

Wenn Sie JavaScripts von Photoshop CS2 aus ausführen, können andere Anwendungen nicht mehr direkt über das Skript angesprochen werden. Beispielsweise können Sie nicht einfach ein JavaScript für einen Workflow erstellen, an dem Photoshop CS2 und ein Datenbankverwaltungsprogramm beteiligt sind.

Skripten zum Steuern mehrerer Anwendungen

Sie können Skripten in AppleScript oder VBScript erstellen, die mehrere Anwendungen steuern. Beispielsweise können Sie auf einem Macintosh ein AppleScript erstellen, mit dem zunächst ein Bitmap-Bild in Photoshop bearbeitet und anschließend eine Webdesign-Anwendung aufgerufen wird, die dieses Bild integriert. Unter Windows können Sie ein entsprechendes Skript in VBScript erstellen.

Neue Funktionen

Die Skripting-Oberfläche bietet folgende neue Funktionen:

● Festlegen von Camera Raw-Optionen beim Öffnen von Dokumenten

● Optimieren von Dokumenten für das Web

● Erstellen und Formatieren von Kontaktabzügen

● Festlegen von Optionen für den Befehl „Stapelverarbeitung“

● Anwenden des Tiefenschärfe-abmildern-Filters

● Automatisches Ausführen von Skripten nach bestimmten Ereignissen. Beispiel: Mit einem

notifier-Objekt können Sie ein Skript mit einem Ereignis verknüpfen, zum Beispiel dem Start der

Photoshop CS2-Anwendung. Das Skript wird dann bei jedem Start der Anwendung ausgeführt.

Grundlagen der Skripterstellung

In diesem Kapitel finden Sie eine kurze Einführung in die grundlegenden Konzepte und die Syntax der Skriptsprachen AppleScript, VBScript und JavaScript. Wenn Sie mit der Skripterstellung noch nicht vertraut sind, sollten Sie dieses Kapitel vollständig lesen.

Wenn Sie bereits mit Skripten oder Programmiersprachen gearbeitet haben, können Sie höchstwahrscheinlich viele Abschnitte in diesem Kapitel überspringen. Sie können sich an folgender Liste orientieren, um die für Sie relevanten Informationen einzugrenzen.

● Informationen zum Objektmodell von Photoshop CS2 finden Sie unter „Objektmodell von

Photoshop CS2” auf Seite 9.

● Informationen zum Auswählen der Skriptsprache finden Sie unter „Auswählen der

Skriptsprache” auf Seite 4.

● Beispiele für Skripten, die speziell für Photoshop CS2 entwickelt wurden, finden Sie in Kapitel 3 unter

„Skripten für Photoshop CS2” auf Seite 39

● Ausführliche Informationen zu den Objekten und Befehlen/Methoden in Photoshop CS2 finden Sie in

folgenden Dokumentationen, die sich auf der Installations-CD im selben Verzeichnis befinden wie das vorliegende Handbuch:

● Adobe Photoshop CS2 AppleScript Scripting Reference

● Adobe Photoshop CS2 Visual Basic Scripting Reference

● Adobe Photoshop CS2 JavaScript Scripting Reference

Einführung in Objekte

Ein Skript ist eine Reihe von Befehlen, die bestimmte Anweisungen an Photoshop CS2 übermitteln. Im Wesentlichen manipulieren diese Befehle Objekte.

Was versteht man im Zusammenhang mit Skriptsprachen unter einem Objekt? Wenn Sie mit Photoshop CS2 arbeiten, erstellen Sie Dokumente, Ebenen, Kanäle und Designelemente. Außerdem können Sie einen bestimmten Bereich eines Bildes bearbeiten, indem Sie eine Auswahl erstellen. Alle diese Komponenten sind Objekte. Die Anwendung Photoshop CS2 ist ebenfalls ein Objekt.

Jedes Objekt besitzt spezifische Eigenschaften und Befehle (AppleScript) bzw. Methoden (VBScript und JavaScript).

Eigenschaften beschreiben oder charakterisieren das Objekt. Beispiel:

● Ein Ebenenobjekt besitzt eine Hintergrundfarbe. Außerdem kann es ein Textelement besitzen.

● Ein Kanalobjekt besitzt Farbeigenschaften, z. B. rot, grün und blau.

● Der ausgewählte Bereich eines Bildes, also das Auswahlobjekt, besitzt die Eigenschaften Größe und

Form.

Befehle und Methoden beschreiben die Aktionen, die auf das Objekt angewendet werden sollen. Um beispielsweise ein Dokument zu drucken, verwenden Sie den Befehl/die Methode

print/PrintOut/print()des Document-Objekts.

Hinweis: Weitere Informationen zu Befehlen und Methoden finden Sie unter „Befehle und

Methoden” auf Seite 13.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 7

Wenn Sie ein Skript erstellen, mit dem ein Objekt bearbeitet werden soll, können Sie nur die Eigenschaften und Befehle/Methoden verwenden, die für dieses Objekt definiert sind. Beispielsweise besitzt das Channel-Objekt natürlich nicht den Befehl/die Methode

print/PrintOut/print().

Woher wissen Sie, welche Eigenschaften oder Befehle/Methoden Sie verwenden können? Adobe stellt Ihnen auf der Installations-CD alle benötigten Informationen in Form folgender Dokumentationen zur Verfügung:

● Adobe Photoshop CS2 AppleScript Scripting Reference

● Adobe Photoshop CS2 Visual Basic Scripting Reference

● Adobe Photoshop CS2 JavaScript Scripting Reference

Tipp:In diesem Handbuch folgen nach den Erläuterungen zum Erstellen eines Skripts für eine bestimmte

Aufgabe häufig Anleitungen zum Nachschlagen der im Skript verwendeten Elemente in den jeweiligen Dokumentationen. So werden Sie schnell verstehen, wie Sie Skripten für Photoshop CS2 erstellen.

Erstellen von Skriptanweisungen

Wie in der menschlichen Sprache erfolgt die Kommunikation in einer Skriptsprache mithilfe von Sätzen, so genannten Anweisungen. So schreiben Sie eine Skriptanweisung:

● Nennen Sie ein Objekt.

● Nennen Sie die Eigenschaft, die Sie ändern oder erstellen möchten.

● Nennen Sie die Aufgabe, die bezüglich der Objekteigenschaft ausgeführt werden soll. In AppleScript

verwenden Sie einen Befehl. In VBScript und JavaScript verwenden Sie eine Methode.

Um beispielsweise ein neues Dokument namens myDocument zu erstellen, würden Sie eine Skriptanweisung folgenden Inhalts formulieren:

Add a document called myDocument

In diesem Beispiel ist document das Objekt, die Eigenschaft „Name“ ist myDocument und der Befehl/die Methode ist add (hinzufügen).

Syntax

Skriptsprachen dienen der Kommunikation mit dem Computer. Daher müssen Sie sich an strenge Regeln halten, die der Computer „versteht“. Diese Regeln werden als Syntax einer Sprache bezeichnet.

AppleScript, VBScript und JavaScript unterscheiden sich in der Syntax. In diesem Handbuch werden die grundlegenden Konzepte der Skripterstellung beschrieben, die für alle diese Sprachen gelten. Außerdem lernen Sie die für jede Sprache spezifische Syntax teilweise kennen.

Grundlagen des Objektmodells

In einer Skriptanweisung erfolgt der Verweis auf ein Objekt basierend auf der Position des Objekts in einem Objektmodell. Ein Objektmodell ist eine Anordnung von Objekten. Diese Anordnung wird Enthaltenseinshierarchie genannt.

Sie können sich Objektmodelle folgendermaßen vorstellen:

1. Sie leben in einem Haus, das wir von nun an als Ihr

2. Das Haus enthält Zimmer, bei denen es sich um

house-Objekt betrachten.

room-Objekte handelt.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 8

3. Jedes Zimmer wiederum hat Fenster und Türen, also window- und door-Objekte.

Fenster können geöffnet oder geschlossen sein. (Mit anderen Worten: Ein

open-Eigenschaft, die anzeigt, ob das Fenster geöffnet ist oder nicht.)

Wenn Sie ein Skript erstellen möchten, das ein Fenster in Ihrem Haus öffnet, müssen Sie die Eigenschaft oder den Befehl/die Methode verwenden, um die Aufgabe auszuführen. Zunächst müssen Sie jedoch das Fenster identifizieren. Und hier kommt das Objektmodell ins Spiel: Sie identifizieren das Fenster, indem Sie dessen Position in der klar strukturierten Anordnung der Objekte im Haus angeben.

Das Fenster befindet sich im Haus. Aber es gibt viele Fenster, also müssen Sie genauere Angaben machen, zum Beispiel, in welchem Zimmer des Hauses sich das Fenster befindet. Wieder gibt es wahrscheinlich nicht nur ein Fenster pro Raum, also müssen Sie die Wand angeben, in der sich das Fenster befindet. Im Objektmodell des Hauses würden Sie das zu öffnende Fenster z. B. als „das Fenster an der nördlichen Wand des Wohnzimmers in meinem Haus“ angeben. Zum Erstellen des Skripts, das dieses Fenster öffnet, müssten Sie lediglich den Befehl/die Methode ergänzen, der/die das Fenster öffnet. Die Skriptanweisung hätte also folgenden Inhalt:

In my house, in the living room, the window on the north wall: open it.

Auf dieselbe Weise können Sie auch ein Skript in Ihrem Haus-Modell erstellen, das die Farbe einer Tür in Blau ändert. In diesem Fall können Sie die Befehls/einer Methode verwenden:

In my house, in the bedroom, the door to the bathroom: blue.

Enthaltenseinshierarchie

window-Objekt besitzt eine

color-Eigenschaft des door-Objekts anstelle eines

Die Bezeichnung Enthaltenseinshierarchie für ein Objektmodell bedeutet, dass Objekte im Modell teilweise anhand der übergeordneten Objekte identifiziert werden, in denen sie enthalten sind. Stellen Sie sich die Objekte im Haus-Modell in einer Hierarchie vor, ähnlich einem Familienstammbaum, in der sich das Haus ganz oben befindet, dann folgen die Zimmer in der nächsten Ebene und in einer dritten Ebene zweigen die Fenster und Türen von den Zimmern ab.

Übertragen des Konzepts auf Photoshop CS2

Wenden Sie das Konzept des Objektmodells nun auf Photoshop CS2 an. Die Anwendung Photoshop CS2 ist das Haus, die Dokumente sind die Zimmer und die Ebenen, Gruppen, Kanäle und ausgewählten Bereiche in den Dokumenten entsprechen den Fenstern, Türen, Wänden, Decken und Böden. Sie können Dokumente in Photoshop CS2 anweisen, Objekte hinzuzufügen oder zu entfernen, oder Sie können einzelne Objekteigenschaften wie Farbe, Größe und Form ändern. Außerdem können Sie Befehle oder Methoden verwenden, zum Beispiel Dateien öffnen, speichern und schließen.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 9

Objektmodell von Photoshop CS2

Damit Ihre Skripten möglichst effizient sind, müssen Sie die Enthaltenseinshierarchie des Objektmodells von Photoshop CS2 verstehen.

Objektmodellklassen

Application

Document

Selection

Path Item

Path Point

Channel

Histogram

Array

Art Layer

Text Item

(Object)

Art Layer

Layer Set

In der folgenden Tabelle sind die einzelnen Objekte beschrieben.

Objekt Beschreibung

Document

Info

Layer Set

Notifier

History

State

So erstellen Sie das Objekt ohne Skript

Application Die Anwendung Photoshop CS2. Starten Sie die Anwendung

Photoshop CS2.

Document Das Arbeitsobjekt, in dem Sie Ebenen, Kanäle,

Aktionen usw. erstellen. In einem Skript benennen, öffnen und speichern Sie ein Dokument genauso,

Wählen Sie in Photoshop CS2

Datei > Neu oder Datei > Öffnen.

wie Sie dies mit einer Datei in der Anwendung tun.

Selection Der ausgewählte Bereich einer Ebene oder eines

Dokuments.

Wählen Sie das Auswahlrechteck oder das Lasso und ziehen Sie mit der Maus.

Path Item Ein Zeichnungsobjekt, z. B. die Kontur einer Form,

eine gerade Linie oder eine Kurve.

Wählen Sie das Pfadauswahl-Werkzeug oder den Zeichenstift und ziehen Sie einen Pfad mit der Maus.

Channel Pixelinformationen über eine Bildfarbe. Wählen Sie Fenster > Kanäle.

Art Layer Eine Ebenenklasse in einem Dokument, die es Ihnen

ermöglicht, ein Objekt im Bild ohne Auswirkungen auf andere Objekte zu bearbeiten.

Layer Set Eine Gruppe von

Art Layer-Objekten. Wählen Sie Ebene > Neu >

Wählen Sie Ebene > Neu > Ebene oder Fenster > Ebenen.

Ebenenset.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 10

So erstellen Sie das Objekt

Objekt Beschreibung

ohne Skript (Fortsetzung)

Document Info Metadaten über ein

Document-Objekt.

Hinweis: Metadaten sind alle Daten, mit denen

Inhalte oder Eigenschaften einer Datei beschrieben werden können, z. B. Dateiname, Erstellungsdatum, Name des Autors, Name des in der Datei gespeicherten Bildes usw.

Notifier Benachrichtigt ein Skript, wenn ein Ereignis auftritt.

Das Ereignis löst dann die Ausführung des Skripts aus. Beispiel: Wenn ein Anwender auf die Schaltfläche „OK“ klickt, teilt das notifier-Objekt dem Skript mit, welche Operation folgen soll.

History State Speichert eine Version des Dokuments in dem

Status, in dem es jeweils beim Speichern vorlag.

Hinweis: Sie können mit dem

State

-Objekt ein Selection-Objekt belegen oder ein Dokument auf einen früheren Status zurücksetzen.

Objektelemente und Sammlungen

History

Wählen Sie Datei > Datei-Information.

Wählen Sie Datei > Skripten > Skriptereignis-Manager.

Wählen Sie Fenster > Protokoll und wählen Sie

anschließend einen Status aus der Protokollpalette.

Wenn Sie Ihrem Skript ein Objekt hinzufügen, wird dieses Objekt automatisch in ein Objektelement (AppleScript) oder eine Sammlung (VBScript, JavaScript) aufgenommen. Die Objekte innerhalb eines Elements bzw. einer Sammlung besitzen alle denselben Objekttyp. Beispielsweise gehört jedes

Channel-Objekt in Ihrem Skript zu einem Channels-Element bzw. einer Channels-Sammlung und

Art Layer-Objekt gehört zu einem Art Layers-Element bzw. einer Art Layers-Sammlung.

jedes

Hinweis: Skripten platzieren ein Objekt selbst dann in Elementen bzw. Sammlungen, wenn der Typ des

Objekts im gesamten Skript nur einmal enthalten ist. Das heißt, im Element bzw. in der Sammlung ist dann nur ein einziges Objekt enthalten.

Wenn Sie ein Objekt hinzufügen, wird dem Objekt innerhalb des jeweiligen Elements bzw. der Sammlung automatisch eine Nummer zugewiesen. Sie können das Objekt dann in anderen Skriptanweisungen anhand des Namens seines Elements bzw. seiner Sammlung in Verbindung mit der zugewiesenen Nummer identifizieren.

Bezogen auf das Beispiel mit dem Haus bedeutet dies: Wenn Sie Ihrem Haus ein Zimmer hinzufügen, wird durch das Skript eine Nummer gespeichert, anhand derer das Zimmer identifiziert wird. Wenn es sich um das erste Zimmer handelt, erhält das Zimmer in AppleScript die Bezeichnung room1, in VBScript oder JavaScript die Bezeichnung room0.

Beim Hinzufügen eines zweiten Zimmers wird die automatische Nummerierung in den verschiedenen Skriptsprachen folgendermaßen gehandhabt:

● AppleScript bezeichnet das neue Zimmer als room1, das zuvor hinzugefügte Zimmer wird in room2

umbenannt. Die Objektnummern in AppleScript verschieben sich also und zeigen stets an, mit welchem Objekt Sie zuletzt gearbeitet haben. Weitere Informationen hierzu finden Sie im AppleScript-Abschnitt unter „Verweisen auf ein Objekt in einem Element bzw.

einer Sammlung” auf Seite 11.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 11

● Die Nummern in VBScript oder JavaScript sind statisch und ändern sich beim Hinzufügen weiterer

Objekte zur Sammlung nicht. Die Nummerierung in VBScript und JavaScript zeigen also stets die Reihenfolge an, in der die Objekte im Skript eingefügt wurden. Da das erste Zimmer mit room0 bezeichnet wurde, ist die Bezeichnung des zweiten Zimmers room1. Wenn Sie ein drittes Zimmer hinzufügen, wird dies room2.

Wenn Sie ein Objekt hinzufügen, das kein Zimmer ist, beginnt die Nummerierung für das entsprechende Objektelement oder die Sammlung wieder neu. Beispiel: Wenn Sie eine Tür hinzufügen, wird diese in AppleScript als door1 bezeichnet, in VBScript oder JavaScript als door0.

Hinweis: Sie können Objekte beim Hinzufügen auch benennen. Beispielsweise können Sie die Zimmer

livingRoom und bedRoom nennen. Wenn ein Objekt einen Namen hat, können Sie entweder über den Namen auf das Objekt verweisen oder über den Namen des Elements/der Sammlung in Verbindung mit der zugewiesenen Objektnummer.

Im Allgemeinen wird Anwendern ohne Skripterfahrung empfohlen, in AppleScript Objektnamen zu verwenden.

In VBScript oder JavaScript sind dagegen Objektnummern sehr nützlich. Angenommen, Sie möchten in mehreren Dateien die Farbe der Hintergrundebene durch Weiß ersetzen. Sie können ein Skript erstellen, das besagt: „Alle Dateien in diesem Ordner öffnen und die Farbe der ersten Ebene durch Weiß ersetzen.“ Wenn Sie nicht anhand der Nummern auf die Ebenen verweisen könnten, müssten Sie in Ihrem Skript die Namen der Hintergrundebenen jeder Datei nennen. Wenn Sie die Dateien aber nicht mit einem Skript sondern in Photoshop CS2 erstellt haben, dann besitzen die Ebenen höchstwahrscheinlich gar keine Namen.

Indizes

Die Nummer eines Objekts in einem Element bzw. einer Sammlung wird Index genannt.

Verweisen auf ein Objekt in einem Element bzw. einer Sammlung

Der Name eines Elements bzw. einer Sammlung ist stets die Pluralform des jeweiligen Namens des Objekttyps. Zum Beispiel hat ein Element bzw. eine Sammlung von documents. In JavaScript und VBScript können Sie über den Namen der Sammlung in Verbindung mit dem Index auf ein Objekt verweisen. In AppleScript wird eine leicht abweichende Syntax verwendet.

Die folgenden Beispielcodes zeigen die korrekte Syntax beim Verwenden von Indizes zum Verweisen auf ein Objekt.

Tipp:Beachten Sie, dass die Indizes in VBScript und JavaScript jeweils bei 0 beginnen. Das Zählen auf der

Basis 0 mag Ihnen am Anfang verwirrend vorkommen. Wenn Sie etwas Erfahrung mit dem Erstellen von Skripten gesammelt haben, werden Sie jedoch feststellen, dass Sie durch Verwendung von 0 die Funktionsmöglichkeiten Ihrer Skripten individueller anpassen können.

Document-Objekten den Namen

In AppleScript verwenden Sie den Namen des Objekttyps gefolgt von einem Leerzeichen und dem Index. Die folgende Anweisung verweist auf das aktuelle Dokument. Beachten Sie, dass der Name des Elements nicht explizit genannt, sondern lediglich impliziert wird.

document 1

Hinweis: Wenn der Elementname auch genannt würde, lautete die Anweisung document 1 of

documents

Objekttyps abgeleitet wird.

. AppleScript kürzt die Syntax, indem der Elementname aus dem Namen des

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 12

In AppleScript ändert sich die Nummer, mit der auf ein Objekt innerhalb eines Elements verwiesen wird, sobald das Skript andere Objekte manipuliert. Verweise auf verweisen also auf die neue Ebene, sofern Sie nicht den Status der früheren Zeichnungsebene in „aktive Ebene“ aktualisieren.

Hinweis: Weitere Informationen zur Auswahl der aktiven Ebene finden Sie unter „Festlegen des

aktiven Objekts” auf Seite 43.

Tipp:Anwendern ohne Skripterfahrung wird empfohlen, alle Objekte in AppleScripts zu benennen und

über die Namen auf diese Objekte zu verweisen.

art layer 1 des aktuellen Dokuments

VBS

In VBScript verwenden Sie den Namen der Sammlung gefolgt vom Index in runden Klammern. Zwischen dem Namen der Sammlung und der öffnenden Klammer darf kein Leerzeichen stehen.

Documents(1)

In JavaScript folgt auf den Namen der Sammlung der Index in eckigen Klammern. Zwischen dem Namen der Sammlung und der öffnenden Klammer darf kein Leerzeichen stehen.

documents[0]

Objektverweise

Da in Skripten eine Enthaltenseinshierarchie verwendet wird, können Sie sich den Verweis auf ein Objekt wie den Pfad zu einer Datei vorstellen.

Sie können über den Namen oder über den Index auf ein Objekt verweisen. (Siehe „Indizes” auf

Seite 11).

Die folgenden Beispielcodes zeigen die Syntax für den Verweis auf ein Bei diesem Objekt handelt es sich um die erste Ebene, die dem hinzugefügt wurde, welches wiederum die erste Ebene war, die dem aktuellen Dokument hinzugefügt wurde:

Verweis über Objektindex:

layer 1 of layer set 1 of current document

Verweis über Objektname:

layer "Profile" of layer set "Silhouettes" of current document

artLayer-Objekt namens Profile.

layerSet-Objekt namens Silhouettes

Hinweis: Wenn Sie für den Verweis auf ein Objekt den Namen verwenden, müssen Sie den Namen in

doppelte Anführungszeichen ("") setzen.

Sie können auch beide Syntaxtypen kombinieren:

layer 1 of layer set "Silhouettes" of current document

VBS

Verweis über Objektindex:

appRef.ActiveDocument.LayerSets(0).Layers(0)

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 13

Verweis über Objektname:

appRef.ActiveDocument.LayerSet("Silhouettes").Layer("Profile")

Sie können auch beide Syntaxtypen kombinieren:

appRef.ActiveDocument.LayerSets(1).Layer("Profile")

Tipp:Beachten Sie, dass bei Verweisen auf ein Objekt über dessen zugewiesenen Namen der Klassenname

des Objekts, also der Singular zu verwenden ist (

LayerSet oder Layer). Bei Verweisen auf ein

Objekt über dessen numerischen Index verwenden Sie den Namen der Sammlung, also den Plural

LayerSets oder Layers).

(

Verweis über Objektindex:

app.documents[1].layerSets[0].layers[0]

Verweis über Objektname:

appRef.document("MyDocument").layerSet("Silhouettes").layer("Profile")

Sie können auch beide Syntaxtypen kombinieren:

appRef.activeDocument.layerSet("Silhouettes").layers[0]

Hinweis: Beachten Sie, dass bei Verweisen auf ein Objekt über dessen zugewiesenen Namen der

Klassenname des Objekts, also der Singular zu verwenden ist (

layer). Bei Verweisen auf ein Objekt über dessen numerischen Index verwenden Sie den

Namen der Sammlung, also den Plural (

Befehle und Methoden

Befehle (in AppleScript) und Methoden (in VBScript und JavaScript) sind Anweisungen im Skript, mit denen Aufgaben ausgeführt oder Ergebnisse ermittelt werden. Beispielsweise können Sie mit dem Befehl/der Methode

Hinweis: Sie können nur die Befehle/Methoden verwenden, die für den jeweiligen Objekttyp gültig sind.

Zum Beispiel können Sie den Befehl/die Methode

Document-Objekt anwenden, nicht jedoch auf ein Selection-Objekt, denn Letzteres kann

nicht geöffnet werden.

● Bevor Sie einen Befehl auf ein AppleScript-Objekt anwenden, schlagen Sie entweder den

Objekttyp oder den Befehl im Handbuch Adobe Photoshop CS2 AppleScript Scripting Reference nach, um die Gültigkeit des Befehls für dieses Objekt zu überprüfen.

Beispielsweise können Sie unter

Document-Objekt im Kapitel „Objekte“.

open/Open/open() eine bestimmte Datei öffnen.

document oder layerSet oder

documents oder layerSets oder layers).

open/Open/open() auf ein

open im Kapitel „Befehle“ nachlesen oder unter

● Bevor Sie eine Methode auf ein VBScript- oder JavaScript-Objekt anwenden, schlagen Sie die

Methode in der Methodentabelle des Objekttyps im Handbuch Adobe Photoshop CS2 Visual Basic Scripting Reference oder Adobe Photoshop CS2 JavaScript Scripting Reference nach.

Beispielsweise können Sie unter

Document-Objekt im Kapitel „Interface“ (Schnittstelle) in der

Methodentabelle des Objekts nachlesen.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 14

Befehle und Befehlseigenschaften

Die Syntax von AppleScript-Befehlen entspricht der Syntax englischer Befehlssätze. Die Skriptanweisung beginnt mit einem Verb im Imperativ, gefolgt von einem Verweis auf ein Objekt, auf das die Aufgabe angewendet werden soll. Mit folgendem AppleScript-Befehl wird die erste Ebene des aktuellen Dokuments gedruckt:

print layer 1 of current document

Manche Befehle erfordern zusätzliche Daten. Der AppleScript-Befehl make new erstellt ein neues Objekt. Sie können Eigenschaften für das Objekt festlegen, indem Sie die Eigenschaften in geschweiften Klammern angeben und vor den Klammern den Ausdruck with properties einfügen. Die folgende Anweisung erstellt ein neues Dokument, das vier Zoll breit und zwei Zoll hoch ist:

make new document with properties {width:4 as inches, height:2 as inches}

Hinweis: Informationen darüber, wie Sie sicherstellen können, dass Ihr Skript das korrekte Objekt

bearbeitet, finden Sie unter „Festlegen des aktiven Objekts” auf Seite 43

Methoden und Argumente

Methoden werden am Ende von VBScript- oder JavaScript-Anweisungen eingefügt. Der Methodenname muss durch einen Punkt vom Rest der Anweisung getrennt sein.

Mit folgender VBScript-Anweisung wird das aktuelle Dokument gedruckt:

appRef.Documents(1).PrintOut

In JavaScript müssen auf eine Methode Klammern folgen, wie in folgender Anweisung:

app.documents[0].print()

Manche Methoden erfordern zusätzliche Daten, so genannte Argumente, die in diesen Klammern angegeben werden müssen. Andere Methoden besitzen optionale Argumente. Durch die folgende Anweisung wird mit der das 4000 Pixel breit und 5000 Pixel hoch ist und eine Auflösung von 72 ppi besitzt:

Hinweis: Obwohl das

(myDocument), verwenden Sie den Namen der Objektsammlung beim Hinzufügen des Objekts. Weitere Informationen zu Objektsammlungen finden Sie unter „Verweisen auf ein

Objekt in einem Element bzw. einer Sammlung” auf Seite 11.

Informationen zum Unterschied zwischen Namen von Objektsammlungen und Objektnamen im Singular finden Sie unter „Objektverweise” auf Seite 12

Add/add()-Methode ein Bitmap-Dokument namens myDocument hinzugefügt,

Document-Objekt in der folgenden Skriptanweisung einen Namen hat

VBS

appRef.Documents.Add(4000, 5000, 72, "myDocument", 5)

Hinweis: Der numerische Wert 5 am Ende der Skriptanweisung bezeichnet den Wert psNewBitmap für

die Konstante Reference finden Sie ausführliche Informationen zu numerischen Werten und Konstanten.

PsNewDocumentMode. Im Handbuch Adobe Photoshop CS2 Visual Basic Scripting

app.documents.add(4000, 5000, 72, "myDocument", DocumentMode.BITMAP)

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 15

Variablen

Eine Variable ist ein Container für im Skript verwendete Daten. In den folgenden AppleScript-Anweisungen ersetzen die Variablen Angaben zu Breite und Höhe des neuen Dokuments.

● Ohne Variablen:

make new document with properties {width:4 as inches, height:2 as inches}

● Mit Variablen:

set docWidth to 4 inches set docHeight to 2 inches make new document with properties {docWidth, docHeight}

Warum Variablen?

Es gibt mehrere Gründe, Variablen zu verwenden, anstatt Werte direkt im Skript festzulegen.

● Wenn Sie Variablen verwenden, können Sie Ihre Skripten leichter aktualisieren oder ändern. Beispiel:

Wenn ihr Skript mehrere Dokumente im Format 4 x 2 Zoll erstellt und Sie später das Format in 4 x 3 Zoll ändern möchten, dann ändern Sie einfach am Anfang des Skripts den Wert der Variablen von 2 in 3. Dadurch wird das gesamte Skript mit dem neuen Wert aktualisiert.

docWidth und docHeight beispielsweise die

docHeight

Wenn Sie jedoch für jedes Dokument direkt den Wert 2 inches für die Höhe festgelegt hätten, wäre eine Aktualisierung der Dokumentformate wesentlich aufwendiger. Sie müssten im ganzen Skript jede Anweisung suchen und ändern, mit der ein Dokument erstellt wird.

● Mit Variablen können Sie Ihre Skripten flexibler wiederverwenden. Bei Ausführung des Skripts können

den Variablen entsprechend dem Status des aktuellen Dokuments und der aktuellen Auswahl Werte zugewiesen werden. Basierend auf den Variableninhalten können dann Entscheidungen getroffen werden.

Daten in Variablen

Die in einer Variablen enthaltenen Daten sind der Wert der Variablen. Um einer Variablen einen Wert zuzuweisen, müssen Sie eine Zuweisungsanweisung verwenden. Beim Wert einer Variablen kann es sich um eine Zahl, eine Zeichenfolge (ein Wort, einen Ausdruck oder eine Gruppe von Zeichen in Anführungszeichen), einen Objektverweis, einen mathematischen Ausdruck, eine andere Variable oder eine Liste handeln (einschließlich Sammlungen, Elemente und Arrays).

Weitere Informationen zum Verwenden von mathematischen Ausdrücken oder anderen Variablen als Variablenwerte finden Sie unter „Operatoren” auf Seite 28 unter „Objekteigenschaften” auf Seite 20

Zuweisungsanweisungen erfordern je nach Skriptsprache eine andere Syntax. Weitere Informationen finden Sie unter „Erstellen von Variablen und Zuweisen von Werten” auf Seite 15

. Informationen über Arrays finden Sie

Erstellen von Variablen und Zuweisen von Werten

Der folgende Abschnitt verdeutlicht, wie Sie zwei Variablen erstellen (thisNumber und thisString) und anschließend die folgenden Werte zuweisen:

Variable Wer t

thisNumber

thisString

"Hello World"

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 16

Hinweis: Wenn Sie einer Variablen eine Zeichenfolge als Wert zuweisen, müssen Sie den Wert in gerade

doppelte Anführungszeichen setzen (""). Durch die Anführungszeichen wird das Skript angewiesen, den Wert unverändert zu übernehmen und nicht zu interpretieren oder zu verarbeiten. Beispiel: 2 ist ein numerischer Wert, "2" ist ein Zeichenfolgenwert. Zahlenwerte können im Skript addiert, subtrahiert oder mittels anderweitiger mathematischer Operationen verarbeitet werden. Zeichenfolgenwerte können lediglich angezeigt werden.

In AppleScript müssen das Erstellen einer Variablen und das Zuweisen eines Wertes in derselben Anweisung erfolgen. Sie können eine Variable mit dem Befehl

set oder dem Befehl copy erstellen.

Beim Befehl

set geben Sie zunächst den Variablennamen an (in AppleScript Bezeichner genannt) und

anschließend den Wert:

set thisNumber to 10 set thisString to "Hello, World"

Beim Befehl copy geben Sie zuerst den Wert und dann den Bezeichner an.

copy 10 to thisNumber copy "Hello World" to thisString

Verwenden der Variablen in einem Skript

Nachdem Sie Variablen deklariert und ihnen Werte zugewiesen haben, können Sie diese Variablen im Skript anstelle der Werte verwenden. Hierfür nennen Sie lediglich die Variablennamen ohne den Befehl

set oder copy. Mit folgender Anweisung wird über den Befehl display dialog ein Dialogfeld mit dem

Te xt Hello World erstellt:

display dialog thisString

Zuweisen eines Objektverweises als Wert

Sie können in Variablen auch Verweise auf Objekte speichern. (Erläuterungen zu Objektverweisen finden Sie unter „Objektverweise” auf Seite 12

thisLayer sowie ein neues Art Layer-Objekt, das der Variablen als Wert zugewiesen wird. Wenn Sie

anschließend

thisLayer in einer Skriptanweisung verwenden, verweisen Sie dadurch auf die neue

.) Die folgende Anweisung erstellt die Variable namens

Ebene.

set thisLayer to make new art layer in current document

Sie können auch einen Verweis auf ein bereits vorhandenes Objekt als Wert zuweisen:

set thisLayer to art layer 1 of current document

Datentypen in AppleScript

Sie können folgende Datentypen bei Werten für Variablen in AppleScript verwenden.

Hinweis: Zum jetzigen Zeitpunkt müssen Sie noch nicht alle dieser Typen kennen.

Datentyp Beschreibung Beispielwert

Boolesch

Logisches „true“ (wahr) oder

true

„false“ (falsch).

integer

Ganzzahl (ohne Dezimalstellen).

14 Integer können positiv oder negativ sein.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 17

Datentyp Beschreibung Beispielwert (Fortsetzung)

real

Eine reelle Zahl, die

13.9972

Dezimalstellen enthalten kann.

string

Eine Reihe von Textzeichen.

"Ich bin ein String"

Hinweis: Strings stehen in

(geraden) Anführungszeichen.

list

Eine sortierte Werteliste. Die

{10.0, 20.0, 30.0, 40.0} Werte einer Liste können beliebigen Typs sein.

object

Ein spezifischer Verweis auf ein

current document Objekt.

record

Eine unsortierte Liste von

{name: "du", index: 1} Eigenschaften. Jede Eigenschaft wird anhand ihrer Bezeichnung identifiziert.

VBS

In VBScript erstellen Sie Variablen mit dem Schlüsselwort Dim zu Beginn der Anweisung. Die folgenden Anweisungen erstellen die Variablen

thisNumber und thisString.

Dim thisNumber Dim thisString

Sie können in einer Dim-Anweisung auch mehrere Variablen deklarieren, wenn Sie die Variablen durch ein Komma (,) voneinander trennen:

Dim thisNumber, thisString

Zum Zuweisen eines Wertes zu einer Variablen verwenden Sie das Gleichheitszeichen (=):

thisNumber = 10 thisString = "Hello, World"

Hinweis: Beachten Sie, dass string-Werte in geraden, doppelten Anführungszeichen ("") stehen müssen.

Als weitere nützliche Faustregel für korrekte VBScripts gilt, dass Sie alle Variablen möglichst zu Beginn des Skripts deklarieren sollten. So können Sie problemlos erkennen, welche Variablen verwendet werden, ohne das gesamte Skript durchsuchen zu müssen.

Mit dem Ausdruck

Option Explicit können Sie VBScript anweisen, die Deklaration jeder Variablen vor

deren erster Verwendung im Skript zu erzwingen. So können Sie Situationen vermeiden, in denen Sie einen Variablennamen versehentlich falsch schreiben oder eine nicht deklarierte Variable verwenden. Fügen Sie den Ausdruck

Option Explicit vor der ersten Variablendeklaration ein, wie im folgenden

Beispiel gezeigt:

Option Explicit Dim thisNumber Dim thisString thisNumber = 10 thisString = "Hello, World"

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 18

Zuweisen eines Objektverweises als Wert

Um einer Variablen einen Objektverweis als Wert zuzuweisen, verwenden Sie die Methode Set und das Gleichheitszeichen. Im folgenden Beispiel werden mit den Methoden

thisLayer und ein neues Art Layer-Objekt erstellt, anschließend wird das Art Layer-Objekt der

Variablen

thisLayer als Wert zugewiesen:

Dim thisLayer Set thisLayer = AppRef.Documents(0).ArtLayers.Add

Set und Add die Variable

Im nächsten Beispiel wird der Variablen thisLayer mit der Methode Set ein vorhandenes Art

Layer

-Objekt (in diesem Fall das dritte Art Layer-Objekt im Skript) als Wert zugewiesen:

Dim thisLayer Set thisLayer =AppRef.Documents(0).ArtLayers(2)

Verwenden der Variablen in einer Skriptanweisung

Wenn Sie in Ihren Skripten Variablen verwenden, die bestimmte Werte repräsentieren, geben Sie lediglich die Variablennamen ohne die Schlüsselwörter ausgewählte Bereich im

Art Layer-Objekt, das durch die Variable thisLayer angegeben ist, um

Dim oder Set an. Im folgenden Beispiel wird der

45 Grad gedreht:

thisLayer.Selection.Rotate(45)

Datentypen in VBScript

Sie können folgende Datentypen bei Werten für Variablen in VBScript verwenden.

Hinweis: Zum jetzigen Zeitpunkt müssen Sie noch nicht alle dieser Typen kennen.

Datentyp Beschreibung Beispiel

Boolean

Empty

Logisches „true“ (wahr) oder „false“ (falsch).

Die Variable enthält

true false

myVar = Empty

keinen Wert.

Error

Speichert eine Fehlernummer.

Null

Die Variable enthält

null keinen gültigen Wert (wird vor allem zum Prüfen von Fehlerbedingungen verwendet).

Number

Beliebige Zahl, die nicht in doppelten

3.7

2000 Anführungszeichen steht.

Object

String

Eigenschaften und Methoden eines Objekts oder Arrays.

Eine Reihe von Textzeichen. Strings stehen in (geraden) Anführungszeichen.

activeDocument

Documents(1).ArtLayers(2)

"Hallo"

"Hauptstr. 123"

" "

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 19

Mit dem Schlüsselwort var deklarieren (d. h. erstellen) Sie Variablen in JavaScript. Im folgenden Beispiel werden zwei Anweisungen verwendet, um die Variable zuzuweisen. Für die Variable

thisString erfolgen Deklaration und Zuweisung eines Wertes in einer

einzigen Anweisung.

var thisNumber thisNumber = 10 var thisString = "Hello, World"

Beim Zuweisen eines Objektverweises in JavaScript verwenden Sie dieselbe Syntax wie bei anderen Zuweisungsanweisungen:

var docRef = app.activeDocument

Datentypen in JavaScript

Sie können folgende Datentypen bei Werten für Variablen verwenden.

Hinweis: Zum jetzigen Zeitpunkt müssen Sie noch nicht alle dieser Typen kennen.

Datentyp Beschreibung Beispiele

thisNumber zu deklarieren und ihr einen Wert

String

Number

Boolean

Null

Object

Funktion

Undefined

Eine Reihe von Textzeichen in (geraden) Anführungszeichen.

Beliebige Zahl, die nicht in doppelten

"Hallo"

"Hauptstr. 123"

" "

3.7

15000 Anführungszeichen steht.

Logisches „true“ (wahr)

true oder „false“ (falsch).

Ein Verweis auf einen Nullwert.

Eigenschaften und Methoden eines Objekts oder Arrays.

Ein Wert, der durch eine Funktion zurückgegeben wird.

activeDocument

Documents(1).artLayers(2)

Siehe „Subroutinen,

Handler und

Funktionen” auf

Seite 32.

Ohne jeden Wert. undefined

Benennen von Variablen

Es empfiehlt sich, beschreibende Namen für Variablen zu verwenden, z. B. firstPage oder

corporateLogo, statt Namen, die nur Sie selbst verstehen und die Sie möglicherweise nach einem Jahr

nicht mehr erkennen, z. B. verwenden, um sie von Objekten, Befehlen und Schlüsselwörtern im Skript unterscheiden zu können. Beispielsweise können Sie das Präfix „doc“ für alle Variablen mit Variablen mit

Art Layer-Objekten verwenden.

x oder c. Sie können auch ein einheitliches Präfix für Ihre Variablennamen

Document-Objekten oder „layer“ für

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 20

● Variablennamen dürfen nur aus einem Wort bestehen, also keine Leerzeichen enthalten. Viele

Skriptautoren verwenden gemischte Groß-/Kleinschreibung (z. B.

my_first_page), um einfach lesbare Namen zu erzielen.

(

● Variablennamen dürfen nicht mit einer Zahl beginnen und dürfen keine Interpunktions- oder

myFirstPage) oder Unterstriche

Anführungszeichen enthalten.

Sie können den Unterstrich ( _ ) im Namen verwenden, jedoch nicht als erstes Zeichen.

● Bei Variablennamen in JavaScript und VBScript wird zwischen Groß- und Kleinschreibung

unterschieden.

thisString ist nicht dieselbe Variable wie thisstring oder ThisString.

Bei Variablennamen in AppleScript wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Objekteigenschaften

Eigenschaften beschreiben ein Objekt. Zum Beispiel beschreiben die Eigenschaften „height“ und „width“

Document-Objekts die Größe eines Dokuments.

eines

Um auf die Eigenschaften eines Objekts zuzugreifen und sie zu ändern, nennen Sie zunächst das Objekt und dann die Eigenschaft. Die exakte Syntax ist je nach Skriptsprache unterschiedlich. In den folgenden Beispielen wird die Eigenschaft „kind“ des zu ändern.

ArtLayer-Objekts verwendet, um die Ebene in eine Textebene

Sie legen Eigenschaften fest, indem Sie am Ende der Anweisung den Ausdruck with properties, gefolgt von den entsprechenden Eigenschaften in geschweiften Klammern ({ }), angeben. Innerhalb der Klammern nennen Sie die Eigenschaft gefolgt von einem Doppelpunkt (:). Nach dem Doppelpunkt folgt die Definition der Eigenschaft:

make new art layer with properties {kind:text}

VBS

In VBScript verwenden Sie die Eigenschaft eines Objekts, indem Sie das Objekt benennen und die Eigenschaft durch einen Punkt (.) getrennt nennen. Den Wert der Eigenschaft legen Sie mit einem Gleichheitszeichen (=) fest.

Set layerRef toArtLayers.Add layerRef.Kind = 2

Hinweis: Beim Wert der Eigenschaft Kind, also 2, handelt es sich um eine Konstante. In VBScript wird der

numerische Konstantenwert statt eines Wertes in Textform verwendet. Eine Liste der Konstanten finden Sie im Kapitel „Constants“ (Konstanten) der jeweiligen Skript-Referenz. Weitere Informationen finden Sie unter „Suchen von Konstanten” auf Seite 21

In JavaScript benennen Sie das Objekt, geben einen Punkt (.) ein, benennen die Eigenschaft und legen den Wert mit einem Gleichheitszeichen (=) fest.

var layerRef = artLayers.add() layerRef.kind = LayerKind.TEXT

Hinweis: Die Eigenschaft kind in JavaScript verwendet eine Konstante. Dies erkennen Sie an der

Formatierung in Großbuchstaben. In JavaScript müssen Sie die Konstantenwerte exakt so eingeben, wie Sie in der Skript-Referenz angegeben sind. Eine Liste der Konstanten finden Sie im Kapitel „Constants“ (Konstanten) der jeweiligen Skript-Referenz. Weitere Informationen finden Sie unter „Suchen von Konstanten” auf Seite 21

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 21

Suchen von Konstanten

Konstanten sind ein Wertetyp zur Definition einer Eigenschaft. Im Beispiel mit der Eigenschaft kind eines

Art Layer-Objekts können Sie nur bestimmte, in Photoshop CS2 zulässige Typen verwenden.

In JavaScript müssen Sie Konstanten exakt so verwenden, wie sie definiert wurden, also in exakt derselben Schreibweise. In VBScript verwenden Sie numerische Konstantenwerte.

Hinweis: In dieser Dokumentation werden die eigentlichen Werte der numerischen Konstanten wie folgt

verdeutlicht:

newLayerRef.Kind = 2 '2 indicates psLayerKind --> 2 (psTextLayer)

Durch den Apostroph (') vor der Erläuterung wird ein Kommentar erstellt. Der auf den Apostroph folgende Text wird von der Skript-Engine ignoriert. Weitere Informationen zu Kommentaren finden Sie unter Dokumentieren von Skripten

In der Referenz zur jeweiligen Skriptsprache sind Konstanten als Hyperlinks in der Spalte „Value Type“ (Datentyp) der Tabelle „Properties“ (Eigenschaften) angegeben. Wenn Sie auf diesen Link klicken, wird eine Liste der möglichen Werte für die Eigenschaft angezeigt.

Suchen Sie beispielsweise in einer beliebigen der folgenden Referenzen auf der Installations-CD im Kapitel „Interface“ (Schnittstelle) nach dem

Art Layer-Objekt:

● Adobe Photoshop CS2 Visual Basic Scripting Reference

● Adobe Photoshop CS2 JavaScript Scripting Reference

Suchen Sie in der Tabelle „Properties“ (Eigenschaften) nach

kind ein Hyperlink enthalten. Klicken Sie auf den Link, um die möglichen Werte für die Eigenschaft

für

kind anzuzeigen.

Hinweis: Verschiedene Objekte können dieselbe Eigenschaft mit unterschiedlichen Konstantenwerten

verwenden. Die Konstantenwerte für die Eigenschaft sich beispielsweise von den Konstantenwerten für die Eigenschaft

Layer

-Objekts.

Objektklassen und Vererbung

In Photoshop CS2 gehört jeder Objekttyp – document, layer usw. – zu einer eigenen Klasse, die wiederum eigene Eigenschaften und Verhalten besitzt.

Objektklassen können die Eigenschaften einer übergeordneten Klasse, einer so genannten Superklasse, „erben“, d. h. gemeinsam verwenden. Wenn eine Klasse Eigenschaften erbt, spricht man von einer untergeordneten Klasse oder Subklasse der Klasse, von der die Eigenschaften geerbt werden. In Photoshop CS2 erben

Klassen können auch Eigenschaften besitzen, die die jeweiligen Superklassen nicht aufweisen. Im Beispiel mit dem Haus-Objekt können Fenster- und Tür-Objekte die Eigenschaft „opened“ (geöffnet) von der übergeordneten

numberOfPanes (Anzahl der Scheiben) verfügen, die die Opening-Klasse nicht besitzt.

Art Layer-Objekte beispielsweise die Eigenschaften der Layer-Klasse.

Opening-Klasse erben, ein Fenster könnte aber zusätzlich über die Eigenschaft

kind. In der Spalte „Value Type“ (Datentyp) ist

kind des Channel-Objekts unterscheiden

kind des Art

In Photoshop CS2 besitzen

Layer-Klasse vererbt wurde.

Art Layer-Objekte zum Beispiel die Eigenschaft grouped, die nicht aus der

In den Referenzdokumenten zu den Skriptsprachen auf der Installations-CD zeigt der Begriff inherited from an, dass die jeweilige Objektklasse eine untergeordnete Klasse der in der Definition genannten übergeordneten Klasse ist.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 22

Arrays

In VBScript und JavaScript entsprechen Arrays in etwa Sammlungen. Allerdings werden Arrays nicht automatisch erstellt.

Sie können sich ein Array als Liste mit Werten für eine einzelne Variable vorstellen. Das folgende JavaScript-Array gibt beispielsweise vier mögliche Werte für die Variable

var myFiles = new Array () myFiles[0] = “clouds.bmp” myFiles[1] = “clouds.gif” myFiles[2] = “clouds.jpg” myFiles[3] = “clouds.pdf”

Beachten Sie, dass die Werte nummeriert sind. Zum Verwenden des entsprechenden Wertes in einer Anweisung, müssen Sie die Nummer angeben. Die folgende Anweisung öffnet die Datei

open(myFiles[1])

Das folgende Beispiel zeigt dieselbe Anweisung in VBScript:

Dim myFiles (4) myFiles(0) = “clouds.bmp” myFiles(1) = “clouds.gif” myFiles(2) = “clouds.jpg” myFiles(3) = “clouds.pdf”

myFiles an:

clouds.gif:

appRef.Open myFiles(1)

Dokumentieren von Skripten

Mithilfe von Kommentaren können Sie detaillierte Informationen in Ihre Skripten einfügen. Aufgrund der speziellen Formatierung von Kommentaren werden die Kommentarinhalte von der Skript-Engine beim Ausführen der Skripten ignoriert.

Mit Kommentaren können Sie den Lesern des Skripts (einschließlich sich selbst) mitteilen, welche Aufgaben Ihre Skripten genau ausführen. Im Allgemeinen ist es eine gute Programmierpraxis, jeden funktionalen Teil in Skripten zu dokumentieren.

Vorteile von Kommentaren:

● Sie können den Zweck bestimmter Skriptabschnitte besser nachvollziehen.

● Sie können verhindern, dass Sie geplante Skriptkomponenten vergessen. Wenn Sie kein erfahrener

Programmierer sind, fällt es Ihnen sicher leichter, Ihre Kommentare zu lesen als den eigentlichen Code.

● Andere Leser verstehen Ihre Skripten besser. Möglicherweise müssen andere Mitarbeiter in Ihrem

Unternehmen Ihre Skripten verwenden, aktualisieren oder debuggen.

Kommentarsyntax

Sie können folgende Arten von Kommentaren erstellen:

● Ganzzeilig: Eine ganze Zeile wird als Kommentar formatiert und beim Ausführen des Skripts ignoriert.

● Zeilenende: Die Zeile beginnt mit ausführbarem Code, anschließend folgt ein Kommentar, der bei der

Ausführung des Skripts ignoriert wird.

● Mehrzeilig: Ein ganzer Textblock, der sich über mehrere Zeilen erstreckt, ist als Kommentar formatiert.

In den folgenden Abschnitten wird erläutert, wie Sie Kommentare in Ihren Skripts formatieren.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 23

Um einen ganzzeiligen Kommentar oder einen Kommentar am Zeilenende in AppleScript einzufügen, geben Sie vor dem Kommentar zwei Bindestriche (--) ein.

-- this is a single-line comment set thisNumber to 10 --this is an end-of-line comment

Um einen mehrzeiligen Kommentar einzufügen, beginnen Sie den Kommentar mit einer öffnenden Klammer und einem Sternchen ( (* ) und beenden ihn mit einem Sternchen und einer schließenden Klammer ( *) ), wie im folgenden Beispiel gezeigt:

(* this is a multi-line comment *)

Hinweis: Im Allgemeinen ist Ihr Skript leichter lesbar, wenn Sie ausschließlich einzeilige Kommentare

verwenden, da dann jede Kommentarzeile als solche erkennbar ist.

VBS

In VBScript geben Sie vor dem Kommentar einen Apostroph ( ' ) ein.

' this is a comment Dim thisString ' this is an end-of-line comment

Hinweis: In VBScript werden mehrzeilige Kommentare nicht unterstützt. Wenn Sie mehrzeilige

Kommentare benötigen, müssen Sie jede Zeile mit einem Apostroph beginnen.

In JavaScript verwenden Sie einen doppelten Schrägstrich für ganzzeilige Kommentare oder Kommentare am Zeilenende:

// This comments until the end of the line var thisString = "Hello, World" // this comments until the end of the line as well

Geben Sie mehrzeilige Kommentare mit der Notation /* */ ein:

/* This entire block of text is a comment*/

Hinweis: Im Allgemeinen ist Ihr Skript leichter lesbar, wenn Sie ausschließlich einzeilige Kommentare

verwenden, da dann jede Kommentarzeile als solche erkennbar ist.

Überlange Skriptzeilen

In einigen Fällen sind einzelne Skriptzeilen zu lang, um im Editor in einer einzigen Zeile angezeigt werden zu können.

In AppleScript wird das Sonderzeichen (¬) verwendet, um darauf hinzuweisen, dass die Information in der nächsten Zeile fortgesetzt wird. Dieses Fortsetzungszeichen zeigt einen „weichen Zeilenumbruch“ im Skript an. Drücken Sie die Wahltaste und den Zeilenschalter, um dieses Zeichen einzugeben.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 24

VBS

In VBScript verwenden Sie ein Leerzeichen, gefolgt von einem Unterstrich ( _).

In JavaScript ist kein Zeichen für die Fortsetzung der Zeile erforderlich. Wenn eine einzelne Anweisung zu lang für eine Zeile ist, wird sie in die nächste Zeile umbrochen. Sie können jedoch die Fortsetzungszeilen mit Leerzeichen oder Tabulatoren einrücken, um die Lesbarkeit des Skripts zu verbessern.

Hinweis: Sie können in JavaScript mehrere Anweisungen in dieselbe Zeile eingeben, wenn Sie die

Anweisungen jeweils durch ein Semikolon ( Sie jede Anweisung als neue Zeile eingeben. Das folgende Beispiel zeigt zwei Anweisungen in derselben Zeile:

var thisNumber= 10; var thisString = "Hello, World"

;) trennen. Das Skript ist aber leichter zu lesen, wenn

Erstellen eines Beispielskripts „Hello World“

Nun setzen Sie die Grundlagen der Skripterstellung in die Praxis um. Die erste Aufgabe in allen Programmiersprachen besteht traditionell im Anzeigen der Meldung „Hello World“.

➤ Unser „Hello World“-Skript wird Folgendes tun:

1. Die Anwendung Photoshop CS2 starten.

2. Ein neues

Beim Erstellen des Dokuments wird ferner die Variable Verweis auf das Dokument als Wert zugewiesen. Das Dokument soll eine Breite von 4 Zoll und eine Höhe von 2 Zoll haben.

3. Erstellen eines

Im Skript wird die Variable das

4. Definieren der Variablen

5. Festlegen des Textelementinhalts auf „Hello World“.

Hinweis: Außerdem werden Kommentare in das Skript eingefügt. Da dies das erste Skript ist, wird die

Diese Schritte spiegeln einen bestimmten Pfad durch die Enthaltenseinshierarchie wider, wie im Folgenden veranschaulicht:

Document-Objekt erstellen.

docRef erstellt, anschließend wird docRef ein

Art Layer-Objekts.

artLayerRef erstellt, anschließend wird artLayerRef ein Verweis auf

Art Layer-Objekt als Wert zugewiesen.

artLayerRef als Textelement.

Kommentarfunktion sehr umfangreich eingesetzt.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 25

Application

Document

Art Layer

Text Item

Erstellen und Ausführen eines AppleScripts

Für diese Aufgabe müssen Sie zunächst den Skripteditor von Apple öffnen.

Hinweis: Der Standardpfad für den Skripteditor lautet Programme > AppleScript > Skripteditor.

➤ So erstellen Sie Ihr erstes AppleScript für Photoshop CS2 und führen es aus

1. Geben Sie folgendes Skript im Skripteditor ein:

Hinweis: Die Zeilen, die mit „--“ beginnen, sind Kommentare. Die Eingabe von Kommentaren ist

optional.

-- Sample script to create a new text item and

-- change its contents.

--target Photoshop CS2 tell application "Adobe Photoshop CS2"

-- Create a new document and art layer. set docRef to make new document with properties ¬

{width:3 as inches, height:2 as inches}

set artLayerRef to make new art layer in docRef

-- Change the art layer to be a text layer. set kind of artLayerRef to text layer

-- Get a reference to the text object and set its contents. set contents of text object of artLayerRef to "Hello, World"

end tell

2. Klicken Sie auf Ausführen, um das Skript auszuführen. Photoshop CS2 erstellt ein neues Dokument,

fügt eine neue Ebene hinzu, ändert den Ebenentyp in eine Textebene und setzt den Text auf „Hello, World“.

Hinweis: Sollten Sie Fehlermeldungen erhalten, lesen Sie unter „Debuggen von AppleScript”

auf Seite 35 nach.

Photoshop CS2

Adobe Photoshop CS2 Skript-Handbuch Grundlagen der Skripterstellung 26

Erstellen und Ausführen eines VBScripts

Im Folgenden sind die Schritte zum Erstellen und Ausführen eines VBScripts angegeben, das den Text Hello, World! in einem Photoshop CS2-Dokument anzeigt.

➤ So erstellen Sie Ihr erstes VBScript für Photoshop CS2 und führen es aus

1. Geben Sie folgendes Skript in einen Skript- oder Texteditor ein.

Hinweis: Die Eingabe von Kommentaren ist optional.

Dim appRef Set appRef = CreateObject( "Photoshop.Application" )

' Remember current unit settings and then set units to ' the value expected by this script Dim originalRulerUnits originalRulerUnits = appRef.Preferences.RulerUnits appRef.Preferences.RulerUnits = 2

' Create a new 4x4 inch document and assign it to a variable. Dim docRef Dim artLayerRef Dim textItemRef Set docRef = appRef.Documents.Add(4, 4)

' Create a new art layer containing text Set artLayerRef = docRef.ArtLayers.Add artLayerRef.Kind = 2

' Set the contents of the text layer. Set textItemRef = artLayerRef.TextItem textItemRef.Contents = "Hello, World!"

' Restore unit setting appRef.Preferences.RulerUnits = originalRulerUnits

2. Speichern Sie die Datei als Textdatei mit der Erweiterung .vbs.

3. Doppelklicken Sie im Windows-Explorer auf die Datei, um das Skript auszuführen.

Das Skript öffnet Photoshop CS2.

Erstellen und Ausführen eines JavaScripts

Im Folgenden sind die Schritte zum Erstellen und Ausführen eines JavaScripts angegeben, das den Text Hello, World! in einem Photoshop CS2-Dokument anzeigt.

Da Sie Ihre JavaScripts direkt in Photoshop CS2 ausführen, müssen Sie zu Beginn des Skripts keinen Code einfügen, mit dem Photoshop CS2 geöffnet wird.

Hinweis: Adobe hat die Skriptsprache „Extend Script“ entwickelt, die JavaScript für die Verwendung mit

Photoshop CS2 ergänzt. Sie können den Extend Script-Befehl

#target verwenden, um die

Anwendung Photoshop CS2 aufzurufen. So können Sie JavaScripts ausführen, die von beliebigen Anwendungen aus auf Photoshop CS2 zugreifen können. Weitere Informationen finden Sie in der Adobe Photoshop CS2 JavaScript Scripting Reference im Kapitel „Script UI“.

➤ So erstellen Sie Ihr erstes JavaScript für Photoshop CS2 und führen es aus

1. Geben Sie das folgende Skript ein.

+ 67 hidden pages