Home » Adobe Manuals » Computer Software » Adobe 65010248 » Manual Viewer

Adobe 65010248 Scripting Guide - Page 14

contains all, objects in a document. It has two

UPC - 883919156484

Add to My Manuals
Save this manual to your list of manuals

Page 14 highlights

CHAPTER 1: Introduction Changes since CS3 14 ➤ Two new methods were added to the Document class. WindowCapture captures the current document to a TIFF image. Rasterize rasterizes the source art within a specified clip bounds. ➣ AppleScript - capture document 1, rasterize document 1 ➣ JavaScript - app.activeDocument.windowCapture, app.activeDocument.rasterize ➣ VBScript - App.ActiveDocument.WindowCapture, App.ActiveDocument.Rasterize ➤ A new method in the Swatches collection, GetSelected, returns a SwatchList of Swatch objects currently selected. ➣ AppleScript - get selected swatches of document 1 ➣ JavaScript - app.activeDocument.swatches.getSelected ➣ VBScript - App.ActiveDocument.Swatches.GetSelected ➤ A new class, SwatchGroup, contains a group of Swatch objects. It has two methods: GetAllSwatches and AddSwatch. ➣ AppleScript - swatch group 1 of document 1 ➣ JavaScript - app.activeDocument.swatchGroups[0] ➣ VBScript - App.ActiveDocument.SwatchGroups(1) ➤ A new collection, SwatchGroups, contains all SwatchGroup objects in a document. It has two methods: Remove and Add. ➣ AppleScript - swatch groups in document 1 ➣ JavaScript - app.activeDocument.swatchGroups ➣ VBScript - App.ActiveDocument.SwatchGroups ➤ A new type, SwatchList, defines a collection of Swatch objects. It is used by the SwatchGroup object and Swatches collection. ➤ A new property in the GradientStop class, opacity, allows each stop to define its own degree of transparency. Alpha blending occurs between stops. ➣ AppleScript - stop opacity of gradient stop ➣ JavaScript - gradientStop.opacity ➣ VBScript - GradientStop.Opacity ➤ A new property in the OpenOptionsAutoCAD class, MergeLayers, defines whether the layers in the AutoCAD file being opened should be merged into a single layer in the Illustrator document. ➣ AppleScript - merge layers: true ➣ JavaScript - mergeLayers = true ➣ VBScript - MergeLayers = true

Section	Page
Introduction	6
What is scripting?	6
Why use scripting?	6
What about actions?	6
Script support in Adobe Illustrator CS4	7
ExtendScript features	7
ExtendScript tools	7
Script file extensions	7
Viewing sample scripts	8
Viewing the object model	8
Viewing the JavaScript object model	8
Viewing the AppleScript object model	8
Viewing the VBScript object model	9
Executing scripts	9
Installing scripts in the Scripts menu	10
Executing scripts from the Other Scripts menu item	10
Startup scripts (.jsx scripts only)	10
Application-specific startup scripts folder	10
General startup scripts folder	11
Changes since CS3	11
Known issues	16
The Illustrator Scripting Object Model	17
Object-naming conventions	18
Top-level (containing) objects	18
Application	18
Document	19
Layer	19
The artwork tree	19
Art styles	20
Color objects	21
Text objects	21
Text frames	21
Text geometry	22
Objects that represent text content	22
Text ranges	23
Text styles	23
Dynamic objects	24
Symbols	24
Transformations	24
Scripting Illustrator	25
Launching and quitting Illustrator from a script	25
Launching and activating Illustrator	25
AppleScript	25
JavaScript	25
VBScript	25
Quitting Illustrator	26
AppleScript	26
JavaScript	26
VBScript	26
Working with objects	26
Getting the frontmost document or layer	26
Creating new objects	26
Collection objects	27
AppleScript	27
JavaScript	27
VBScript	28
Selected objects	28
Selecting text	28
Selecting art items	28
Referring to selected art items	28
Notes on renaming objects stored in the application’s panels	28
Measurement units	29
Em space units	29
Page-item positioning and dimensions	29
Art item bounds	30
Paths and shapes	31
User-interaction levels	31
AppleScript	31
JavaScript	32
VBScript	32
Printing Illustrator documents	32
Scripting with AppleScript	33
For more information	33
Your first Illustrator script	33
Adding features to “Hello World”	34
Object references	34
Obtaining objects from documents and layers	35
Creating new objects	35
Working with selections	35
Selecting artwork objects	36
Working with text frames	36
Threaded frames	36
Threaded frames make one story object	37
Creating paths and shapes	37
Paths	37
Specifying a series of x-y coordinates	37
Using path point objects	37
Combining path point types	38
Shapes	38
Write-once access	39
Creating a rectangle	39
Creating a polygon	39
Scripting with JavaScript	40
For more information	40
Your first Illustrator script	40
Adding features to “Hello World”	41
Working with methods in JavaScript	41
Accessing and referencing objects	42
Referencing the application object	42
Accessing objects in collections	42
Creating new objects	43
Working with selections	44
Selecting artwork objects	44
Working with text frames	44
Threaded frames	44
Threaded frames make a single story object	45
Creating paths and shapes	45
Paths	45
Specifying a series of x-y coordinates	45
Using pathPoint objects	45
Combining path point types	46
Shapes	46
Creating a rectangle	47
Creating a polygon	47
Scripting with VBScript	48
For more information	48
Your first Illustrator script	48
Adding features to “Hello World”	49
Accessing and referencing objects	49
Obtaining objects from collections	49
Creating new objects	50
Working with selections	50
Selecting artwork objects	50
Working with text frames	51
Threaded frames	51
Threaded frames make a single story object	51
Creating paths and shapes	51
Paths	51
Specifying a series of x-y coordinates	52
Using path point objects	52
Combining path-point types	53
Shapes	53
Creating a rectangle	53
Creating a polygon	54
Working with enumeration values	54

Match case Limit results 1 per page

HAPTER

1: Introduction

Changes since CS3

➤

Two new methods were added to the

Document

class.

WindowCapture

captures the current document

to a TIFF image.

Rasterize

rasterizes the source art within a specified clip bounds.

➣

AppleScript —

capture

document

rasterize

document

➣

JavaScript —

app.activeDocument.windowCapture,

app.activeDocument.rasterize

➣

VBScript —

App.ActiveDocument.WindowCapture,

App.ActiveDocument.Rasterize

➤

A new method in the

Swatches

collection,

GetSelected

, returns a

SwatchList

Swatch

objects

currently selected.

➣

AppleScript —

get

selected

swatches

document

➣

JavaScript —

app.activeDocument.swatches.getSelected

➣

VBScript —

App.ActiveDocument.Swatches.GetSelected

➤

A new class,

SwatchGroup

, contains a group of

Swatch

objects. It has two methods:

GetAllSwatches

and

AddSwatch

➣

AppleScript —

swatch

group

document

➣

JavaScript —

app.activeDocument.swatchGroups[0]

➣

VBScript —

App.ActiveDocument.SwatchGroups(1)

➤

A new collection,

SwatchGroups

, contains all

SwatchGroup

objects in a document. It has two

methods:

Remove

and

Add

➣

AppleScript —

swatch

groups

document

➣

JavaScript —

app.activeDocument.swatchGroups

➣

VBScript —

App.ActiveDocument.SwatchGroups

➤

A new type,

SwatchList

, defines a collection of

Swatch

objects. It is used by the

SwatchGroup

object

and

Swatches

collection.

➤

A new property in the

GradientStop

class,

opacity

, allows each stop to define its own degree of

transparency. Alpha blending occurs between stops.

➣

AppleScript —

stop

opacity

gradient

stop

➣

JavaScript —

gradientStop.opacity

➣

VBScript —

GradientStop.Opacity

➤

A new property in the

OpenOptionsAutoCAD

class,

MergeLayers

, defines whether the layers in the

AutoCAD file being opened should be merged into a single layer in the Illustrator document.

➣

AppleScript —

merge

layers:

true

➣

JavaScript —

mergeLayers

true

➣

VBScript —

MergeLayers

true