渐变

渐变

gradient

描述

文档中包含的渐变定义。脚本可以创建新的渐变。

---

属性

Gradient.gradientStops

gradient.gradientStops

描述

此渐变中包含的渐变停止点。

类型

GradientStops; 只读。

---

Gradient.name

gradient.name

描述

渐变的名称。

类型

字符串。

---

Gradient.parent

gradient.parent

描述

包含此渐变的文档。

类型

Document; 只读。

---

Gradient.type

gradient.type

描述

渐变的类型，径向或线性。

类型

GradientType

---

Gradient.typename

gradient.typename

描述

引用对象的类名。

类型

字符串; 只读。

---

方法

Gradient.remove()

app.activeDocument.gradients[index].remove()

描述

从文档中移除引用的对象。

返回值

无。

---

示例

创建并应用渐变

// 在当前文档中创建一个新渐变，然后将渐变应用到最前面的路径项

if (app.documents.length > 0) {
 // 为渐变的两个端点创建颜色
 var startColor = new RGBColor();
 startColor.red = 0;
 startColor.green = 100;
 startColor.blue = 255;

 var endColor = new RGBColor();
 endColor.red = 220;
 endColor.green = 0;
 endColor.blue = 100;

 // 创建一个新渐变
 // 新渐变始终有2个停止点
 var newGradient = app.activeDocument.gradients.add();
 newGradient.name = "NewGradient";
 newGradient.type = GradientType.LINEAR;

 // 修改第一个渐变停止点
 newGradient.gradientStops[0].rampPoint = 30;
 newGradient.gradientStops[0].midPoint = 60;
 newGradient.gradientStops[0].color = startColor;

 // 修改最后一个渐变停止点
 newGradient.gradientStops[1].rampPoint = 80;
 newGradient.gradientStops[1].color = endColor;

 // 构造一个引用新创建的渐变的 Illustrator.GradientColor 对象
 var colorOfGradient = new GradientColor();
 colorOfGradient.gradient = newGradient;

 // 获取第一个路径项，将新渐变应用为其填充
 var topPath = app.activeDocument.pathItems[0];
 topPath.filled = true;
 topPath.fillColor = colorOfGradient;
}