Illustrator scripting的初识

开始方法

// 获取当前文档 
var doc = app.activeDocument;

创建新文档

app.documents.add([documentColorSpace] [, width] [, height] [, numArtBoards] [, artboardLayout] [, artboardSpacing] [, artboardRowsOrCols])

举例：
//创建新文档
var doc = app.documents.add();

//创建新文档,并定义颜色空间为RGB
var doc = app.documents.add(DocumentColorSpace.RGB);

//创建新文档,并定义颜色空间为RGB,长宽为500，500。单位为pt
var doc = app.documents.add(DocumentColorSpace.RGB,500,500);

参数	类型	描述
documentColorSpace	DocumentColorSpace，可选	文档的色彩空间
width	数字（双精度），可选	文档宽度为add
height	数字（双精度），可选	文档高度add
numArtBoards	数字（长），可选	要创建的画板数
artboardLayout	文档画板布局，可选	画板布局
artboardSpacing	编号，可选	间距的像素数
artboardRowsOrCols	整数，可选	行数或列数

 创建形状的常用方法

PathItems

ai 的路径类常用方法

PathItems.ellipse()

使用提供的参数创建一个新的椭圆形 pathItem。

app.activeDocument.pathItems.ellipse([top][, left][, width][, height][, reversed][, inscribed])

默认值

参数	值
top	100 pt.
left	100 pt.
width	50 pt.
height	100 pt.
reversed	false

 参数

参数	类型	描述
top	数字（双精度），可选	路径顶部
left	数字（双精度），可选	路径左侧
width	数字（双精度），可选	路径宽度
height	数字（双精度），可选	路径高度
reversed	布尔值，可选	路径是否反转
inscribed	布尔值，可选	路径是否被写入

返回值：PathItem

PathItems.polygon()

app.activeDocument.pathItems.polygon([centerX][, centerY][, radius][, sides][, reversed])

 使用提供的参数创建多边形形状的新路径项。

默认值

参数	值
centerX	200 pt.
centerY	300 pt.
radius	50 pt.
sides	8
reversed	false

参数	类型	描述
centerX	数字（双精度），可选	路径的中心 X
centerY	数字（双精度），可选	路径的中心 Y
radius	数字（双精度），可选	路径半径
sides	数字（长），可选	边数
reversed	布尔值，可选	路径是否反转

 返回值：PathItem

PathItems.rectangle（）

app.activeDocument.pathItems.rectangle(top, left, width, height[,reversed])

描述

使用提供的参数创建多边形形状的新多边形。pathItem

参数

参数	类型	描述
top	数量（双精度）	路径顶部
left	数量（双精度）	路径左侧
width	数量（双精度）	路径宽度
height	数量（双精度）	路径高度
reversed	布尔值，可选	路径是否反转

返回值：PathItem

 

PathItems.roundedRectangle（）

app.activeDocument.pathItems.roundedRectangle(top, left, width, height[, horizontalRadius][, verticalRadius][, reversed])

描述

使用提供的参数创建具有圆角的矩形形状的新路径项。

违约

参数	值
horizontalRadius	15 pt
verticalRadius	20 pt
reversed	false

参数	类型	描述
top	数量（双精度）	路径顶部
left	数量（双精度）	路径左侧
width	数量（双精度）	路径宽度
height	数量（双精度）	路径高度
horizontalRadius	数字（双精度），可选	圆角的水平半径
verticalRadius	数字（双精度），可选	圆角的垂直半径
reversed	布尔值，可选	路径是否反转

 

PathItems.star（）

app.activeDocument.pathItems.star([centerX][, centerY][, radius][, innerRadius][, points][, reversed])

描述：使用提供的参数创建星形的新路径项。

默认值

参数	值
centerX	200 pt.
centerY	300 pt.
radius	50 pt.
innerRadius	20 pt.
points	5
reversed	false

参数	类型	描述
centerX	数字（双精度），可选	路径的中心 X
centerY	数字（双精度），可选	路径的中心 Y
radius	数字（双精度），可选	路径半径
innerRadius	数字（双精度），可选	路径内半径
points	数字（长），可选	点数
reversed	布尔值，可选	路径是否反转

返回值：PathItem

PathItems.removeAll（）

app.activeDocument.pathItems.removeAll()

描述

删除此集合中的所有元素。

返回

无