colors 配列内の各色に対応するアルファ透明度の値の配列です。配列の各エレメントに指定できる値は、0 ～ 1 です。たとえば、.25 を指定すると、透明度の値として 25% が設定されます。

alphas プロパティの値を直接変更することはできません。このプロパティを変更するには、alphas への参照を取得し、その参照を変更した後、alphas をその参照に設定する必要があります。

colors、alphas、および ratios の 3 つのプロパティは関連しています。colors 配列の先頭のエレメントが alphas 配列と ratios 配列の先頭のエレメントに対応するなど、3 つの配列の同じインデックスのエレメントが互いに対応しています。

関連項目

角度 (度数) です。指定できる値は 0 ～ 360 です。デフォルトは 45 です。

角度の値は、オブジェクトに向けられる架空の光源の角度を表します。この値によって、グラデーションカラーがオブジェクトに適用されるときの角度を設定します。これによりハイライトとシャドウの現れる場所や、配列の先頭の色が現れる場所が決まります。先頭の色を適用する場所が決まると、他の色が配列内に格納されている順に適用されます。

関連項目

水平方向のぼかし量。指定できる値は 0 ～ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。デフォルト値は 4 です。2 のべき乗 (2、4、8、16、32 など) は、他の値と比べて速くレンダリングできるよう最適化されます。

垂直方向のぼかし量。指定できる値は 0 ～ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。デフォルト値は 4 です。2 のべき乗 (2、4、8、16、32 など) は、他の値と比べて速くレンダリングできるよう最適化されます。

グラデーションで使用する RGB 16 進数カラー値の配列です。たとえば、赤は 0xFF0000、青は 0x0000FF などです。

colors プロパティの値を直接変更することはできません。このプロパティを変更するには、colors への参照を取得し、その参照を変更した後、colors をその参照に設定する必要があります。

colors、alphas、および ratios の 3 つのプロパティは関連しています。colors 配列の先頭のエレメントが alphas 配列と ratios 配列の先頭のエレメントに対応するなど、3 つの配列の同じインデックスのエレメントが互いに対応しています。

関連項目

オフセット距離です。指定できる値は 0 ～ 8 です。デフォルト値は 4.0 です。

オブジェクトにノックアウト効果を適用するかどうかを指定します。ノックアウト効果を適用すると、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。true を指定すると、ノックアウト効果が適用されます。デフォルトは false で、ノックアウト効果は適用されません。

フィルタを適用する回数。デフォルト値は、フィルタを 1 回適用することに相当する BitmapFilterQuality.LOW です。値 BitmapFilterQuality.MEDIUM はフィルタを 2 回適用します。値 BitmapFilterQuality.HIGH はフィルタを 3 回適用します。フィルタに設定された値が小さいほど、速くレンダリングできます。

多くのアプリケーションでは、quality の値は低、中、または高で十分です。最大 15 までの値を使用してさまざまな効果を出すことができますが、値が大きくなるほどレンダリング速度が低下します。quality の値を増やす代わりに、blurX と blurY の値を増やすだけで、同様の効果が得られます。この方法を実行すると、より高速にレンダリングされます。

関連項目

colors 配列内の対応する色の色分布比率の配列です。配列のエレメントに指定できる値は、0 ～ 255 です。

ratios プロパティの値を直接変更することはできません。このプロパティを変更するには、ratios への参照を取得し、その参照を変更した後、ratios をその参照に設定する必要があります。

colors、alphas、および ratios の 3 つのプロパティは関連しています。colors 配列の先頭のエレメントが alphas 配列と ratios 配列の先頭のエレメントに対応するなど、3 つの配列の同じインデックスのエレメントが互いに対応しています。

グラデーションベベルで色の分布がどのようになるかを理解するために、まず、グラデーションベベルで使用する色を考えます。ベベルを単純化すると、ハイライト 1 色とシャドウ 1 色で構成されています。グラデーションベベルには 1 つのハイライトグラデーションと 1 つのシャドウグラデーションがあります。ハイライトを左上隅に表示し、シャドウを右下隅に表示するとします。ここでは、一例として、ハイライトに 4 色、シャドウに 4 色を使用します。ハイライトとシャドウに加え、ハイライトとシャドウのエッジが交差する部分にベース塗りの色を使用します。この場合、合計 9 色を使用するので、色分布比率の配列のエレメント数は 9 です。

グラデーションを互いに混ざり合ったさまざまな色のストライプで構成されているものと考えた場合、色分布比率の値は、その色のグラデーションの範囲内における位置を表します。この位置は、0 がグラデーションの最も外側の点を表し、255 がグラデーションの最も内側の点を表します。通常、中間値は 128 で、これがベース塗りの値になります。下のイメージのベベル効果を得るには、9 色の例を使用して色分布比率の値を次のように設定します。

• 最初の 4 色は 0 ～ 127 の範囲で、それぞれの値が前の値と等しいか、それより大きくなるように設定します。これがハイライトのベベルエッジです。
• 5 番目のカラー (中央のカラー) がベース塗りで、値は 128 です。ピクセル値 128 でベース塗りが設定され、外側のタイプを選択している場合はシェイプの外側でベベルエッジを囲み、内側のタイプを選択している場合はシェイプの内側でオブジェクトを塗りつぶします。
• 最後の 4 色は 129 ～ 255 の範囲で、それぞれの値が前の値と等しいか、それより大きくなるように設定します。これがシャドウのベベルエッジです。

各エッジの色分布を同じにする場合は、中間色がベース塗りになるように、使用する色数を奇数にします。0 ～ 127 と 129 ～ 255 の範囲で色を均等に分布した後、値を調整してグラデーションの各色のストライプの幅を変更します。9 色のグラデーションベベルの場合、[16, 32, 64, 96, 128, 160, 192, 224, 235] のような配列が考えられます。次の図は、ここまで説明したグラデーションベベルを表しています。

グラデーションの色の広がりは、blurX、blurY、strength、quality プロパティの値、および ratios 値に基づいて変化します。

関連項目

インプリントの強さまたは広がりです。値が大きいほど、濃い色がインプリントされるので、ベベルと背景との間のコントラストが強くなります。指定できる値は 0 ～ 255 です。値を 0 にすると、フィルタが適用されなくなります。デフォルト値は 1 です。

関連項目

ベベル効果の配置です。指定できる値は、BitmapFilterType 定数です。

• BitmapFilterType.OUTER - ベベルがオブジェクトの外側エッジに配置されます。
• BitmapFilterType.INNER - ベベルがオブジェクトの内側エッジに配置されます。
• BitmapFilterType.FULL - ベベルがオブジェクトの上に配置されます。

指定されたパラメータでフィルタを初期化します。

関連項目

このフィルタオブジェクトのコピーを返します。

1. 必要なクラスを読み込みます。
2. 四角形とフィルタを定義するグローバル変数を宣言します。
3. コンストラクタ関数を作成します。この関数は、次の処理を行います。
   • draw() メソッドを呼び出し、Sprite の graphics プロパティを介してアクセスする Graphics クラスのメソッドを使用して灰色の四角形を描画します。
   • filter という名前の BitmapFilter オブジェクトを作成し、このオブジェクトに getBitmapFilter() の呼び出しによる戻り値を割り当てます。これでフィルタが作成されます。
   • myFilters という名前の新しい配列を作成し、それに filter を追加します。
   • myFilters を GradientBevelFilterExample オブジェクトの filters プロパティに割り当てます。これにより、myFilters で見つかったすべてのフィルタが適用されます。この場合は、filter だけです。

package {
    import flash.display.Sprite;
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.BitmapFilterType;
    import flash.filters.GradientBevelFilter;

    public class GradientBevelFilterExample extends Sprite {
        private var bgColor:uint     = 0xCCCCCC;
        private var size:uint        = 80;
        private var offset:uint      = 50;
        private var distance:Number  = 5;
        private var angleInDegrees:Number = 225; // opposite 45 degrees
        private var colors:Array     = [0xFFFFFF, 0xCCCCCC, 0x000000];
        private var alphas:Array     = [1, 0, 1];
        private var ratios:Array     = [0, 128, 255];
        private var blurX:Number     = 8;
        private var blurY:Number     = 8;
        private var strength:Number  = 2;
        private var quality:Number   = BitmapFilterQuality.HIGH
        private var type:String      = BitmapFilterType.INNER;
        private var knockout:Boolean = true;

        public function GradientBevelFilterExample() {
            draw();
            var filter:BitmapFilter = getBitmapFilter();
            var myFilters:Array = new Array();
            myFilters.push(filter);
            filters = myFilters;
        }

        private function getBitmapFilter():BitmapFilter {
            return new GradientBevelFilter(distance,
                                           angleInDegrees,
                                           colors,
                                           alphas,
                                           ratios,
                                           blurX,
                                           blurY,
                                           strength,
                                           quality,
                                           type,
                                           knockout);
        }

        private function draw():void {
            graphics.beginFill(bgColor);
            graphics.drawRect(offset, offset, size, size);
            graphics.endFill();
        }
    }
}