GraphicsGradientFill  - AS3

colors 数组中的对应颜色的 Alpha 值的数组。有效值为 0 到 1。如果值小于 0，则使用 0。如果值大于 1，则使用 1。

渐变中使用的 RGB 十六进制颜色值数组。例如，红色为 0xFF0000，蓝色为 0x0000FF 等等。可以至多指定 15 种颜色。对于每种颜色，请在 alphas 和 ratios 属性中指定对应值。

一个控制渐变的焦点位置的数字。值 0 将焦点设置在中心。值 1 表示焦点位于渐变圆的一条边界上；值 -1 表示焦点位于渐变圆的另一条边界上。小于 -1 或大于 1 的值将分别舍入为 -1 或 1。例如，下例显示了设置为 0.75 的 focalPointRatio：

InterpolationMethod 类中用于指定要使用的值的值。有效值为：InterpolationMethod.LINEAR_RGB 或 InterpolationMethod.RGB

例如，下例显示了两种颜色之间的简单线性渐变（spreadMethod 参数设置为 SpreadMethod.REFLECT）。不同的插值方法会更改外观，如下所示：

InterpolationMethod.LINEAR_RGB	InterpolationMethod.RGB

相关 API 元素

一个由 Matrix 类定义的转换矩阵。flash.geom.Matrix 类包括一个 createGradientBox() 方法，可通过该方法设置与 beginGradientFill() 方法一起使用的矩阵。

相关 API 元素

颜色分布比例的数组。有效值为 0 到 255。该值定义 100% 采样的颜色所在位置的宽度百分比。值 0 表示渐变框中的左侧位置，值 255 表示渐变框中的右侧位置。

注意：此值表示渐变框中的位置，而不是最终渐变的坐标空间。最终渐变可能会比渐变框更宽或更窄。为 colors 属性中的每个值指定一个对应值。

例如，对于包括蓝和绿两种颜色的线性渐变，以下示例显示了渐变中的颜色基于不同 ratios 数组值的配比：

ratios	渐变
[0, 127]
[0, 255]
[127, 255]

数组中的值必须持续增加；例如，[0, 63, 127, 190, 255]。

SpreadMethod 类中用于指定要使用的扩展方法的值。有效值为：SpreadMethod.PAD、SpreadMethod.REFLECT 或 SpreadMethod.REPEAT。

例如，下例显示了两种颜色之间的简单线性渐变：

     import flash.geom.*
     import flash.display.*
     var fillType:String = GradientType.LINEAR;
     var colors:Array = [0xFF0000, 0x0000FF];
     var alphas:Array = [1, 1];
     var ratios:Array = [0x00, 0xFF];
     var matr:Matrix = new Matrix();
     matr.createGradientBox(20, 20, 0, 0, 0);
     var spreadMethod:String = SpreadMethod.PAD;
     this.graphics.beginGradientFill(fillType, colors, alphas, ratios, matr, spreadMethod);       
     this.graphics.drawRect(0,0,100,100);
     

此示例将 SpreadMethod.PAD 用于 spread 方法，并且渐变填充看起来将类似于下图：

如果将 SpreadMethod.REFLECT 用于 spread 方法，则渐变填充看起来将类似于下图：

如果将 SpreadMethod.REPEAT 用于 spread 方法，则渐变填充看起来将类似于下图：

相关 API 元素

GradientType 类中用于指定要使用的渐变类型的值。值为 GradientType.LINEAR 或 GradientType.RADIAL。

相关 API 元素

创建新的 GraphicsGradientFill 对象。

相关 API 元素