[PDF] Illustrator Scripting Guide - Release 0.0.1 Adobe Systems Incorporated

View - Download Illustrator Scripting Guide - Release 0.0.1 Adobe Systems Incorporated

Previous PDF

Next PDF

Illustrator Scripting Guide

Release 0.0.1

Adobe Systems Incorporated

Jun 05, 2023

INTRODUCTION

1 What is Scripting?1

2 Changelog3

3 Scripting language support in Adobe Illustrator CC

5

4 Viewing Sample Scripts9

5 Viewing the object model11

6 Executing Scripts13

7 The Illustrator Scripting Object Model

15

8 Object Naming Conventions

17

9 Top-Level (containing) Objects

19

10 The Artwork Tree21

11 Text Objects23

12 Dynamic Objects27

13 Symbols29

14 Transformations31

15 Launching and quitting Illustrator from a script

33

16 Working with objects35

17 Measurement Units39

18 Page-item positioning and dimensions

41

19 Paths and shapes43

20 User-interaction levels45

21 Printing Illustrator documents

47

22 For more information49i

23 Your first Illustrator script51

24 Object references53

25 Working with text frames57

26 Creating paths and shapes59

27 Working with the perspective grid

63

28 For more information67

29 Your first Illustrator script69

30 Working with methods in JavaScript

71

31 Accessing and referencing objects

73

32 Working with text frames77

33 Creating paths and shapes79

34 Working with the perspective grid

83

35 For more information87

36 Your first Illustrator script89

37 Accessing and referencing objects

91

38 Working with text frames93

39 Creating paths and shapes95

40 Working with enumeration values

99

41 Working with the perspective grid

101

42 Scripting Constants105

43 JavaScript Object Reference

141

44 Application143

45 Artboard163

46 Artboards167

47 Brush171

48 Brushes175

49 CharacterAttributes179

50 Characters193

51 CharacterStyle197

52 CharacterStyles201ii

53 CMYKColor205

54 Color209

55 CompoundPathItem223

56 CompoundPathItems237

57 Dataset241

58 Datasets245

59 Document249

60 DocumentPreset281

61 Documents287

62 EPSSaveOptions291

63 ExportOptionsAutoCAD297

64 ExportOptionsFlash301

65 ExportOptionsGIF309

66 ExportOptionsJPEG315

67 ExportOptionsPhotoshop319

68 ExportOptionsPNG24323

69 ExportOptionsPNG8327

70 ExportOptionsSVG333

71 ExportOptionsTIFF339

72 FXGSaveOptions343

73 Gradient347

74 Gradients351

75 GradientStop355

76 GradientStops359

77 GraphicStyle363

78 GraphicStyles367

79 GraphItem371

80 GraphItems383

81 GroupItem387

82 GroupItems403iii

83 IllustratorSaveOptions407

84 ImageCaptureOptions411

85 Ink413

86 InkInfo415

87 InsertionPoint419

88 InsertionPoints423

89 Layer427

90 Layers437

91 LegacyTextItem441

92 LegacyTextItems453

93 Lines457

94 Matrix459

95 MeshItem463

96 MeshItems475

97 NonNativeItem479

98 NonNativeItems491

99 OpenOptions493

100OpenOptionsAutoCAD497

101OpenOptionsFreeHand501

102OpenOptionsPhotoshop503

103PageItem505

104PageItems517

105Paper601

106PaperInfo603

107ParagraphAttributes607

108Paragraphs619

109ParagraphStyle623

110ParagraphStyles627

111PathItems631

112PathPoint639iv

113PathPoints643

114Pattern647

115Patterns649

116PDFFileOptions653

117PDFSaveOptions655

118PhotoshopFileOptions671

119PlacedItems675

120PluginItems679

121PPDFile683

122PPDFileInfo685

123Preferences689

124PrintColorManagementOptions

695

125PrintColorSeparationOptions

699

126PrintCoordinateOptions703

127Printer707

128PrinterInfo709

129PrintFlattenerOptions715

130PrintFontOptions719

131PrintJobOptions721

132PrintOptions727

133PrintPageMarksOptions733

134PrintPaperOptions737

135PrintPostScriptOptions741

136RasterEffectOptions745

137RasterItems749

138RasterizeOptions753

139Screen757

140ScreenInfo759

141ScreenSpotFunction763

142Spot765v

143Spots769

144Story773

145Stories779

146Swatch781

147Swatches783

148SwatchGroup787

149SwatchGroups791

150SymbolItems795

151Symbol799

152Symbols801

153TabStopInfo805

154Tag809

155Tags813

156TextFont817

157TextFonts819

158TextFrameItems823

159TextPath829

160TextRange839

161TextRanges849

162TracingObject851

163TracingOptions855

164Variable863

165Variables865

166View869

167Views871

168Words873vi

CHAPTER

ONEWHAT IS SCRIPTING?

A script is a series of commands that tells Illustrator to perform one or more tasks. These tasks can be simple, affecting

only one object in the current document, or complex, affecting objects in all your Illustrator documents.

The tasks might even involve other applications, like word processors, spreadsheets, and database management pro-

grams.

For the most part, the building blocks of scripting correspond to the Illustrator tools, menus, panels, and dialog boxes

with which you are already an expert. If you know what you want Illustrator to do, you can write a script to do it.1.1Wh yuse scrip ting?

Graphic design is a field characterized by creativity, but aspects of the work are anything but creative. In fact, you

probably notice that the time you spend placing and replacing images, correcting errors in text, and preparing files for

printing at an image-setting service provider often reduces the time you have available for doing creative work.

With a small investment of time and effort, you can learn to write short, simple scripts that perform repetitive tasks for

you. As your scripting skills grow, you can move on to more complex scripts.

Scripting also can enhance your creativity, by quickly performing tasks you might not have time to try. For example,

you could write a script to systematically create a series of objects, modifying the new objects" position, stroke, and

fill properties along the way. You also could write a script that accesses built-in transformation matrix functions to

stretch, scale, and distort a series of objects. Without scripting, you would likely miss out on the creative potential of

such labor-intensive techniques.1.2What about actions? Both actions and scripts are ways of automating repetitive tasks, but they work very differently:

•Actions use a program"s user interface to do their work. As an action runs, menu choices are executed, objects

are selected, and recorded paths are created.

Scripts do not use a program"s user interface to perform tasks, and scripts can execute faster than actions.

•Actions have very limited facilities for getting and responding to information.

You cannot add conditional logic to an action; therefore, actions cannot make decisions based on the current

situation, like changing the stroke type of rectangles but not ellipses.

Scripts can get information and make decisions and calculations based on the information they receive from

Illustrator.1

Illustrator Scripting Guide, Release 0.0.1

•A script can execute an action, but actions cannot execute scripts.2 Chapter 1. What is Scripting?

CHAPTER

TWOCHANGELOG

What"s new and changed for scripting?2.1Illustr ator24.0 (CC 2020) <> •Added:PageItem.uuid2.2Illustr atorXX.X (CC 2017) <> •Added:Application.getIsFileOpen()2.3Illustr atorXX.X (CC) <> •?3

Illustrator Scripting Guide, Release 0.0.1

4Chapter 2. Changelog

CHAPTER

THREESCRIPTING LANGUAGE SUPPORT IN ADOBE ILLUSTRATOR CC

Illustrator scripting supports VBScript and JavaScript scripts for Windows, and AppleScript and JavaScript scripts for

Mac OS.3.1Scrip tfile e xtensions

For a file to be recognized by Adobe Illustrator CC 2017 as a valid script file, the file must have the correct file name

extension:Script TypeFile type (extension)Platforms AppleScriptcompiled script ( .scpt ) OSAS file (no extension)Mac OS JavaScript or ExtendScripttext ( .js or .jsx)Windows Mac OS

VBScripttext ( .vbs )Windows

3.2

Ja vaScriptde velopmentop tions

You can use the ExtendScript Toolkit to create JavaScript scripts explicitly for Illustrator, or you can use Adobe Exten-

sion Builder and the Creative Cloud SDK to develop extensions in ActionScript.

Extensions are Flash-based (SWF) and can potentially work in a variety of Creative Cloud applications.

3.2.1

De velopinga CC e xtensionusing A ctionScript

Creative Cloud applications have an extensibility infrastructure that allows developers to extend the capabilities of the

applications; the infrastructure is based on Flash/Flex technology, and each extension is delivered as compiled Flash

(SWF) file. Creative Cloud includes the Extension Manager to enable installation of extensions.

An example of an extension that ships with the point products is Adobe Kuler. Kuler has a consistent user interface

across the different suite applications, but has different logic in each, adapted to the host application.

The user interface for an extension is written in ActionScript, using the Flex framework. An extension is typically

accessed through its own menu item in the application"s Extensions menu.5

Illustrator Scripting Guide, Release 0.0.1

Adobe Extension Builder allows you to design the user interface interactively using the Design view of Flash Builder.

The Creative Cloud SDK also allows you to develop all of the application logic for your extension in ActionScript; you

can develop and debug your extension in the familiar Flash Builder environment.

To develop your application logic, we recommend using the ActionScript Wrapper Library ( CSAWLib ), which ex-

poses the scripting DOM of each host application as an ActionScript library. This is tightly integrated with the Adobe

Extension Builder environment, which includes wizards to help you build your extension"s basic structure, and run and

debug your code against suite applications such as Adobe InDesign, Photoshop and Illustrator.

The methods, properties, and behavior of the scripting DOM is as described in the JavaScript Scripting Reference for

the host application.

For details of how to use Adobe Extension Builder and the wrapper libraries, see the Creative Cloud SDK documenta-

tion, which is accessible from within Adobe Extension Builder. 3.2.2

Scrip tingplug-ins

The CC JavaScript scripting interface allows for limited scripting for plug-ins. A plug-in can define a command,

with an event and notifier, and a handler that performs some action. A JavaScript script can then use theapp.

sendScriptMessage()method to send parameters to that plug-in-defined command, and receive a plug-in-defined

response.

For example, the Adobe Custom Workspace plug-in defines a command "Switch Workspace". A script can invoke this

command with the following coderesult= app.sendScriptMessage ( "Adobe Custom Workspace" "Switch Workspace" '' );In this case, the value that the plug-in returns is the string "" 3.2.3

Ext endScriptf eatures

If you write Illustrator-specific scripts that use the Illustrator JavaScript DOM directly, you will create ExtendScript

files, which are distinguished by the .jsx extension.

Giving your JavaScript files a .jsx extension (rather than the standard .js extension for a JavaScript file) allows you to

take advantage of ExtendScript features and tools.

ExtendScript offers all standard JavaScript features, plus a development and debugging environment, the ExtendScript

Toolkit (ESTK).

The ESTK is installed with all scriptable Adobe applications, and is the default editor for JSX files. The ESTK includes

an Object Model Viewer that contains complete documentation of the methods and properties of JavaScript objects.

For information on accessing the ESTK and the Object Model Viewer seeViewing the object model. ExtendScript also provides various tools and utilities, including the following: •A localization utility •Tools that allow you to combine scripts and direct them to particular applications

•Platform-independent file and folder representation6 Chapter 3. Scripting language support in Adobe Illustrator CC

Illustrator Scripting Guide, Release 0.0.1

•Tools for building user interfaces to your scripts

•A messaging framework that allows you to send and receive scripts and data among scripting-enabled Adobe

applications

All of these features are available whether you use the DOM directly with a JSX file, or indirectly through the Ac-

quotesdbs_dbs14.pdfusesText_20

[PDF] adobe indesign certification free

[PDF] adobe indesign certification practice test

[PDF] adobe indesign cs5 5 download

[PDF] adobe indesign cs5 scripting guide

[PDF] adobe indesign cs5 tutorial pdf

[PDF] adobe indesign cs6 scripting guide

[PDF] adobe indesign fonts list

[PDF] adobe indesign free courses

[PDF] adobe indesign price

[PDF] adobe indesign scripting guide javascript

[PDF] adobe indesign scripts free download

[PDF] adobe indesign server scripting guide

[PDF] adobe indesign social media templates

[PDF] adobe indesign website

[PDF] adobe india ceo