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

Adobe 26001360 Scripting Guide - Page 56

Transformation matrices, Print Option, Description

UPC - 718659321840

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

Page 56 highlights

56 Scripting Illustrator When printing, you may provide an options parameter to more fully control the printing process. Illustrator CS supports an extensive list of new printing options, all of which have default values. As a scripter, you can override any one of these printing options. If you do not override those printing options or if you override those printing options with illegal values (such as specifying a printer or paper that does not exist), an error will be returned. The following lists the categories of printing options that you can specify. Each one of these categories is optional. Within each category, default values have been provided for all properties. Print Option Printer name PPD file name Print style name Paper options Print job options Color separation options Page marks options Coordinate options Font options PostScript options Color management Flattener options Description Name of the selected priner File name of the selected PPD file Specifies the printing style Specifies the paper name and custom paper sizes Options which control things such as number of print copies Specifies the separation mode, ink list, etc. Controls the printing of page marks Specifies the positioning and scaling of artwork on the media Controls the fonts used for printing Controls parameters such as the PostScript LanguageLevel Sets color profiles Controls the transparency flattening The print settings are determined through the following precedence order: 1. The print style settings, if any are specified, will override the default print settings. 2. The specific printing options (if there are any) will override the print style settings. Transformation matrices Thanks to the matrix class and the many commands that support matrices, you have access to the power of geometric transformation matrices. Transformation matrices are mathematical concepts originating in the field of linear algebra. Geometric manipulations like scaling, rotating and moving can all be described using transformation matrices. 12 Aug 03

Section	Page
Introduction	13
About this manual	13
What is scripting?	14
Why use scripting?	14
What about actions?	15
System requirements	15
Mac OS	16
Windows	16
Scripting Basics	17
Object model concepts	17
Object classes	18
Object inheritance	18
Object elements or collections	19
Object references	19
Scripting concepts	19
Comments	19
About long script lines	20
Values Types	21
Variables	22
Properties	23
Operators	24
Commands and methods	24
Conditional statements	25
Control structures	25
Handlers and subroutines	27
Testing and troubleshooting	29
About error handling	31
Scripting Illustrator	33
Illustrator’s object model	33
Looking at Illustrator’s objects and commands	34
AppleScript	34
Visual Basic	36
The application	36
Your first Illustrator script	37
Creating an AppleScript script	37
Creating a Visual Basic script	37
VBScript	39
Adding features to “Hello World”	40
Measurement units	42
Unit conversion to points	43
Em Space Units	43
Coordinates	44
Fixed points	44
Zero point	44
Fixed rectangle	45
Page item positioning and dimensions	45
Object references	46
Object references in AppleScript	46
Object references in Visual Basic	47
Object containment: document vs. layer	48
Working with selections	49
Working with paths	52
Working with color	52
Working with symbols	53
Working with symbol items	53
Working with text art	53
Content of a Text Range	55
Character Style, Character Attributes, Local Character Attributes	55
Printing Illustrator Documents	55
Transformation matrices	56
Using a matrix in an AppleScript script	57
Using a matrix in a Visual Basic script	57
Working with variables and datasets	58
Datasets	58
Launching and quitting Illustrator from a script	58
Launching and quitting from AppleScript	58
Launching and quitting from Visual Basic	59
Some objects that cannot be created by a script	59
User Interaction Levels	59
AppleScript	60
Visual Basic and JavaScript	60
The Scripts menu	60
Notes	61
Supported scripting languages	61
Script files	61
Installing scripts	61
Executing other scripts	62
AppleScript Reference	63
About the script examples	63
application	64
brush, brushes	67
character	69
character style, character styles	76
CMYK color info	82
color info	83
color management options	84
color separation options	84
compound path item, compound path items	85
coordinate options	87
dataset, datasets	88
document, documents	91
ellipse	98
EPS save options	100
Flash export options	102
flattening options	104
font, fonts	105
font options	105
GIF export options	107
gradient, gradients	110
gradient color info	112
gradient stop, gradient stops	113
gradient stop info	115
graph item, graph items	116
graphic style, graphic styles	118
gray color info	119
group item, group items	120
Illustrator preferences	125
Illustrator save options	125
ink	128
ink properties	128
insertion point	129
job options	132
JPEG export options	134
layer, layers	136
line	140
matrix	146
mesh item, mesh items	148
no color info	149
Open Options	150
page item, page items	150
page marks options	154
paper	155
paper options	155
paper properties	156
paragraph, paragraphs	157
paragraph style, paragraph styles	166
path item, path items	173
path point, path points	176
path point info	178
pattern, patterns	179
pattern color info	180
PDF options	181
PDF save options	183
Photoshop options	188
Photoshop export options	190
placed item, placed items	192
plugin item, plugin items	194
PNG24 export options	194
PNG8 export options	196
polygon	199
postscript options	200
PPD file	200
PPD properties	201
print options	203
printer	204
printer properties	206
raster item, raster items	207
rectangle	209
RGB color info	211
rounded rectangle	212
screen properties	213
screen spot function	214
separation screen	215
spot, spots	215
spot color info	217
star	218
story, stories	219
SVG export options	221
swatch, swatches	223
symbol, symbols	224
symbol item, symbol items	226
tab stop info	227
tag, tags	228
text, texts	229
text frame, text frames	231
variable, variables	234
view, views	235
word	238
Command reference	245
apply	246
apply character style	247
apply paragraph style	247
change case	248
close	248
colorize	249
concatenate matrix	249
concatenate rotation matrix	250
concatenate scale matrix	250
concatenate translation matrix	251
convert	251
convert to paths	252
copy	252
count	253
cut	254
delete	255
deselect	256
display	256
do javascript	256
do script	257
duplicate	258
equal matrices	259
exists	259
export	260
export PDF preset	261
export print presets	261
export variables	262
get	262
get identity matrix	263
get rotation matrix	264
get scale matrix	264
get translation matrix	265
import character styles	265
import paragraph styles	266
import PDF preset	267
import print preset	267
import variables	268
invert matrix	268
make	269
move	270
open	271
paste	272
print	273
quit	273
redraw	274
rotate	275
save	276
scale	279
select	280
set	281
show presets	281
singular matrix	281
transform	283
translate	284
translate placeholder text	285
update	285
Visual Basic Reference	287
About the script examples	287
Referencing and creating objects in Visual Basic	288
Syntax differences between Sub and Function methods	289
Application	290
Brush	295
Brushes	296
CharacterAttributes	297
Characters	300
CharacterStyle	301
CharacterStyles	301
CMYKColor	303
CompoundPathItem	304
CompoundPathItems	309
DataSet	310
DataSets	311
Document	312
Documents	319
EPSSaveOptions	320
ExportOptionsFlash	321
ExportOptionsGIF	322
ExportOptionsJPEG	324
ExportOptionsPhotoshop	326
ExportOptionsPNG24	327
ExportOptionsPNG8	328
ExportOptionsSVG	330
Gradient	331
Gradients	333
GradientColor	334
GradientStop	336
GradientStops	336
GraphicStyle	338
GraphicStyles	339
GraphItem	340
GraphItems	344
GrayColor	345
GroupItem	346
GroupItems	350
IllustratorSaveOptions	351
Ink	353
InkInfo	354
InsertionPoint	355
InsertionPoints	355
Layer	356
Layers	359
LegacyTextItem	360
LegacyTextItems	364
Lines	364
Matrix	366
MeshItem	367
MeshItems	370
NoColor	372
OpenOptions	373
PageItems	374
Paper	376
PaperInfo	377
ParagraphAttributes	377
Paragraphs	380
ParagraphStyle	381
ParagraphStyles	383
PathItem	383
PathItems	389
PathPoint	391
PathPoints	392
Pattern	393
Patterns	394
PatternColor	395
PDFFileOptions	397
PDFSaveOptions	398
PhotoshopFileOptions	401
PlacedItem	402
PlacedItems	406
PluginItem	406
PluginItems	410
PPDFile	410
PPDFileInfo	411
Preferences	412
PrintColorManagementOptions	412
PrintColorSeparationOptions	413
PrintCoordinateOptions	415
Printer	416
PrinterInfo	417
PrintFlattenerOptions	419
PrintFontOptions	421
PrintJobOptions	422
PrintOptions	424
PrintPageMarksOptions	426
PrintPaperOptions	427
PrintPostScriptOptions	428
RasterItem	429
RasterItems	433
RGBColor	434
Screen	435
ScreenInfo	436
ScreenSpotFunction	436
Spot	437
Spots	439
SpotColor	440
Story	441
Stories	442
Swatch	443
Swatches	444
Symbol	445
Symbols	445
SymbolItem	447
SymbolItems	451
TabStopInfo	452
Tag	452
Tags	454
TextFont	455
TextFonts	456
TextFrame	457
TextFrames	461
TextRange	464
TextRanges	466
Variable	466
Variables	467
View	468
Views	469
Words	470
Enumerations reference	471
Changes Since Earlier Versions	487
Changes InThe Object Model for Illustrator CS	487
Macintosh / AppleScript	487
Windows / COM (Visual Basic, et al)	487
Deprecated	489
Bibliography	491
AppleScript	491
Visual Basic	491
Internet resources	492
Adobe Systems, Inc.	492
AppleScript	492

Match case Limit results 1 per page

Scripting Illustrator

12 Aug 03

When printing, you may provide an options parameter to more fully control the printing

process. Illustrator CS supports an extensive list of new printing options, all of which have

default values. As a scripter, you can override any one of these printing options. If you do not

override those printing options or if you override those printing options with illegal values

(such as specifying a printer or paper that does not exist), an error will be returned.

The following lists the categories of printing options that you can specify. Each one of these

categories is optional. Within each category, default values have been provided for all

properties.

The print settings are determined through the following precedence order:

The print style settings, if any are specified, will override the default print settings.

The specific printing options (if there are any) will override the print style settings.

Transformation matrices

Thanks to the

matrix

class and the many commands that support matrices, you have access

to the power of geometric transformation matrices. Transformation matrices are mathematical

concepts originating in the field of linear algebra. Geometric manipulations like scaling,

rotating and moving can all be described using transformation matrices.

Print Option

Description

Printer name

Name of the selected priner

PPD file name

File name of the selected PPD file

Print style name

Specifies the printing style

Paper options

Specifies the paper name and custom paper sizes

Print job options

Options which control things such as number of print copies

Color separation options

Specifies the separation mode, ink list, etc.

Page marks options

Controls the printing of page marks

Coordinate options

Specifies the positioning and scaling of artwork on the media

Font options

Controls the fonts used for printing

PostScript options

Controls parameters such as the PostScript LanguageLevel

Color management

Sets color profiles

Flattener options

Controls the transparency flattening