パッケージflash.filters
クラスpublic final class GlowFilter
継承GlowFilter Inheritance BitmapFilter Inheritance Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

GlowFilter クラスを使用すると、表示オブジェクトにグロー効果を適用できます。グローのスタイルには複数のオプションがあり、内側グロー、外側グロー、ノックアウトモードなどがあります。グローフィルタは、ドロップシャドウの distance プロパティと angle プロパティを 0 に設定したドロップシャドウフィルタと同様です。このフィルタは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。

フィルタの使用方法は、フィルタの適用先オブジェクトによって異なります。

表示オブジェクトにフィルタを適用すると、表示オブジェクトの cacheAsBitmap プロパティは true に設定されます。すべてのフィルタをクリアすると、cacheAsBitmap は元の値に戻ります。

このフィルタはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体が拡大 / 縮小される場合 (scaleXscaleY プロパティの値が 1.0 以外に設定されている場合)、フィルタは拡大 / 縮小されません。フィルタが拡大 / 縮小されるのは、ステージをズームインする場合のみです。

結果として得られるイメージの幅または高さが 2880 ピクセルを超える場合、フィルタは適用されません。たとえば、フィルタが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが 2880 ピクセルの制限を超える場合は、フィルタがオフになります。

例を表示

関連項目

flash.display.BitmapData.applyFilter()
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.scaleX
flash.display.DisplayObject.scaleY
flash.filters.DropShadowFilter.distance
flash.filters.DropShadowFilter.angle


パブリック プロパティ
 プロパティ定義元
  alpha : Number
カラーのアルファ透明度の値です。
GlowFilter
  blurX : Number
水平方向のぼかし量。
GlowFilter
  blurY : Number
垂直方向のぼかし量。
GlowFilter
  color : uint
グローのカラーを表します。
GlowFilter
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  inner : Boolean
グローが内側グローであるかどうかを示します。
GlowFilter
  knockout : Boolean
オブジェクトにノックアウト効果を適用するかどうかを指定します。
GlowFilter
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  quality : int
フィルタを適用する回数。
GlowFilter
  strength : Number
インプリントの強さまたは広がりです。
GlowFilter
パブリック メソッド
 メソッド定義元
  
GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
指定されたパラメータで新しい GlowFilter インスタンスを初期化します。
GlowFilter
  
このフィルタオブジェクトのコピーを返します。
GlowFilter
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
プロパティの詳細
alphaプロパティ
alpha:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

カラーのアルファ透明度の値です。指定できる値は 0 ~ 1 です。たとえば、.25 を指定すると、透明度の値として 25% が設定されます。デフォルト値は 1 です。


実装
    public function get alpha():Number
    public function set alpha(value:Number):void
blurXプロパティ 
blurX:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

水平方向のぼかし量。指定できる値は 0 ~ 255 (浮動小数) です。デフォルト値は 6 です。2 のべき乗 (2、4、8、16、32 など) は、他の値と比べて速くレンダリングできるよう最適化されます。


実装
    public function get blurX():Number
    public function set blurX(value:Number):void
blurYプロパティ 
blurY:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

垂直方向のぼかし量。指定できる値は 0 ~ 255 (浮動小数) です。デフォルト値は 6 です。2 のべき乗 (2、4、8、16、32 など) は、他の値と比べて速くレンダリングできるよう最適化されます。


実装
    public function get blurY():Number
    public function set blurY(value:Number):void
colorプロパティ 
color:uint  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

グローのカラーを表します。指定できる値は、16 進数形式 (0xRRGGBB) です。デフォルト値は 0xFF0000 です。


実装
    public function get color():uint
    public function set color(value:uint):void
innerプロパティ 
inner:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

グローが内側グローであるかどうかを示します。true の場合は、内側グローであることを示します。デフォルトは false (外側グロー) で、オブジェクトの外側のエッジにあるグローを示します。


実装
    public function get inner():Boolean
    public function set inner(value:Boolean):void
knockoutプロパティ 
knockout:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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


実装
    public function get knockout():Boolean
    public function set knockout(value:Boolean):void
qualityプロパティ 
quality:int  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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

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


実装
    public function get quality():int
    public function set quality(value:int):void

関連項目

strengthプロパティ 
strength:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

インプリントの強さまたは広がりです。値が大きいほど、濃い色がインプリントされるので、グローと背景との間のコントラストが強くなります。指定できる値は 0 ~ 255 です。デフォルトは 2 です。


実装
    public function get strength():Number
    public function set strength(value:Number):void
コンストラクタの詳細
GlowFilter()コンストラクタ
public function GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

指定されたパラメータで新しい GlowFilter インスタンスを初期化します。

パラメータ
color:uint (default = 0xFF0000) — グローのカラーです。16 進数形式 (0xRRGGBB) で指定します。デフォルト値は 0xFF0000 です。
 
alpha:Number (default = 1.0) — カラーのアルファ透明度の値です。指定できる値は 0 ~ 1 です。たとえば、.25 を指定すると、透明度の値として 25% が設定されます。
 
blurX:Number (default = 6.0) — 水平方向のぼかし量。指定できる値は 0 ~ 255 (浮動小数) です。2 のべき乗 (2、4、8、16、32 など) は、他の値と比べて速くレンダリングできるよう最適化されます。
 
blurY:Number (default = 6.0) — 垂直方向のぼかし量。指定できる値は 0 ~ 255 (浮動小数) です。2 のべき乗 (2、4、8、16、32 など) は、他の値と比べて速くレンダリングできるよう最適化されます。
 
strength:Number (default = 2) — インプリントの強さまたは広がりです。値が大きいほど、濃い色がインプリントされるので、グローと背景との間のコントラストが強くなります。指定できる値は 0 ~ 255 です。
 
quality:int (default = 1) — フィルタを適用する回数。BitmapFilterQuality 定数を使用します。
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

詳細については、quality プロパティの説明を参照してください。

 
inner:Boolean (default = false) — グローが内側グローであるかどうかを示します。true の場合は、内側グローであることを示します。値 false は外側グローで、オブジェクトの外側のエッジにあるグローを示します。
 
knockout:Boolean (default = false) — オブジェクトにノックアウト効果を適用するかどうかを指定します。true を指定すると、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。

関連項目

メソッドの詳細
clone()メソッド
public override function clone():BitmapFilter

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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

戻り値
BitmapFilter — 元の GlowFilter インスタンスのプロパティをすべて備えた新しい GlowFilter インスタンスです。
例の使用法
GlowFilterExample.as

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

package {
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.MouseEvent;
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.GlowFilter;

    public class GlowFilterExample extends Sprite {
        private var bgColor:uint = 0xFFCC00;
        private var size:uint    = 80;
        private var offset:uint  = 50;

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

        private function getBitmapFilter():BitmapFilter {
            var color:Number = 0x33CCFF;
            var alpha:Number = 0.8;
            var blurX:Number = 35;
            var blurY:Number = 35;
            var strength:Number = 2;
            var inner:Boolean = false;
            var knockout:Boolean = false;
            var quality:Number = BitmapFilterQuality.HIGH;

            return new GlowFilter(color,
                                  alpha,
                                  blurX,
                                  blurY,
                                  strength,
                                  quality,
                                  inner,
                                  knockout);
        }

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




 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/flash/filters/GlowFilter.html