GraphicsGradientFill  - AS3

Alpha 值的陣列，這些值對應到 colors 陣列中的顏色。有效值介於 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 散佈方法，所以漸層填色看起來會像下面這樣：

如果是使用 SpreadMethod.REFLECT 散佈方法，漸層填色看起來會像下面這樣：

如果是使用 SpreadMethod.REPEAT 散佈方法，漸層填色看起來會像下面這樣：

相關 API 元素

GradientType 類別的值，可用來指定要使用哪個漸層類型。值為 GradientType.LINEAR 或 GradientType.RADIAL。

相關 API 元素

建立新的 GraphicsGradientFill 物件。

相關 API 元素