GraphicsGradientFill  - AS3

colors 配列内の各色に対応するアルファ値の配列です。有効な値の範囲は 0 ～ 1 です。値が 0 より小さい場合は、0 が使用されます。値が 1 より大きい場合は、1 が使用されます。

グラデーションで使用する RGB 16 進数カラー値の配列です。例えば、赤は 0xFF0000、青は 0x0000FF などです。最大 15 色まで指定できます。 各色について、alphas プロパティと ratios プロパティで対応する値を指定してください。

グラデーションの焦点の位置を制御する数値です。値が 0 の場合は、焦点が中央に設定されます。値 1 は焦点がグラデーション円のいずれかの境界にあることを示します。値が -1 の場合は、焦点がグラデーション円のもう一方の境界に設定されます。-1 未満または 1 より大きい値は、それぞれ -1 または 1 に丸められます。例えば、次の例では focalPointRatio が 0.75 に設定されています。

使用する値を指定する InterpolationMethod クラスの値です。 有効な値は、InterpolationMethod.LINEAR_RGB または InterpolationMethod.RGB です。

例えば、2 色間のシンプルな線状グラデーション（spreadMethod パラメーターを SpreadMethod.REFLECT に設定）の例を次に示します。それぞれの補間方法で、外観は次のように変化します。

InterpolationMethod.LINEAR_RGB	InterpolationMethod.RGB

関連する API エレメント

Matrix クラスで定義される変換マトリックスです。flash.geom.Matrix クラスには、createGradientBox() メソッドがあります。このメソッドを使用すると、beginGradientFill() メソッドで使用するマトリックスを設定できます。

関連する API エレメント

色分布の比率の配列です。 有効な値の範囲は 0 ～ 255 です。この値は、100％でサンプリングされる色の幅の割合をパーセントで定義します。 値 0 はグラデーションボックスの左の位置を表し、値 255 はグラデーションボックスの右の位置を表します。

注意：この値は、グラデーションボックス内の位置を表すもので、最終グラデーションの座標空間を表すものではありません。最終グラデーションは、グラデーションボックスより広くなったり狭くなったりする場合があります。colors プロパティの値ごとに、対応する値を指定してください。

例えば、青と緑の 2 色を含む線状グラデーションの場合、次の例は、ratios 配列の様々な値に基づいて配置される色を示します。

ratios	グラデーション
[0, 127]
[0, 255]
[127, 255]

配列内の値は、[0, 63, 127, 190, 255] のように順に増やしていく必要があります。

使用する spread メソッドを指定する SpreadMethod クラスの値です。 値は SpreadMethod.PAD、SpreadMethod.REFLECT、または SpreadMethod.REPEAT です。

例えば、2 つの色の間のシンプルな線状グラデーションを次の例に示します。

     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);
     

この例では spread メソッドに SpreadMethod.PAD を使用しているため、グラデーションの塗りは次のようになります。

spread メソッドに SpreadMethod.REFLECT を使用する場合、グラデーションの塗りは次のようになります。

spread メソッドに SpreadMethod.REPEAT を使用する場合、グラデーションの塗りは次のようになります。

関連する API エレメント

使用するグラデーションのタイプを指定する GradientType クラスの値です。値は GradientType.LINEAR または GradientType.RADIAL です。

関連する API エレメント

新しい GraphicsGradientFill オブジェクトを作成します。

関連する API エレメント