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

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

DropShadowFilter クラスは、ドロップシャドウを表示オブジェクトに追加します。シャドウアルゴリズムは、ぼかしフィルタで使用するのと同じボックスフィルタに基づいています。ドロップシャドウのスタイルには複数のオプションがあり、内側シャドウ、外側シャドウ、ノックアウトモードなどがあります。このフィルタは、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


パブリック プロパティ
 プロパティ定義元
  alpha : Number
シャドウカラーのアルファ透明度の値です。
DropShadowFilter
  angle : Number
シャドウの角度です。
DropShadowFilter
  blurX : Number
水平方向のぼかし量。
DropShadowFilter
  blurY : Number
垂直方向のぼかし量。
DropShadowFilter
  color : uint
シャドウのカラーです。
DropShadowFilter
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  distance : Number
シャドウのオフセット距離 (ピクセル単位) です。
DropShadowFilter
  hideObject : Boolean
オブジェクトが非表示であるかどうかを示します。
DropShadowFilter
  inner : Boolean
シャドウが内側のシャドウであるかどうかを指定します。
DropShadowFilter
  knockout : Boolean
true の場合は、ノックアウト効果を適用します。その結果、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。
DropShadowFilter
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  quality : int
フィルタを適用する回数。
DropShadowFilter
  strength : Number
インプリントの強さまたは広がりです。
DropShadowFilter
パブリック メソッド
 メソッド定義元
  
DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
指定されたパラメータで新しい DropShadowFilter インスタンスを作成します。
DropShadowFilter
  
このフィルタオブジェクトのコピーを返します。
DropShadowFilter
 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.0 ~ 1.0 です。たとえば、.25 を指定すると、透明度の値として 25% が設定されます。デフォルト値は 1.0 です。


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

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

シャドウの角度です。指定できる値は 0 ~ 360 度 (浮動小数) です。デフォルト値は 45 です。


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

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

水平方向のぼかし量。指定できる値は 0 ~ 255.0 (浮動小数) です。デフォルト値は 4.0 です。


実装
    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.0 (浮動小数) です。デフォルト値は 4.0 です。


実装
    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) です。デフォルト値は 0x000000 です。


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

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

シャドウのオフセット距離 (ピクセル単位) です。デフォルト値は 4.0 (浮動小数) です。


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

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

オブジェクトが非表示であるかどうかを示します。true を指定すると、オブジェクト自体は描画されず、シャドウだけが表示されます。デフォルトは false で、オブジェクトが表示されます。


実装
    public function get hideObject():Boolean
    public function set hideObject(value:Boolean):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 回適用します。フィルタに設定された値が小さいほど、速くレンダリングできます。

多くのアプリケーションでは、画質低、中、または高で十分です。最大 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.0 です。デフォルトは 1.0 です。


実装
    public function get strength():Number
    public function set strength(value:Number):void
コンストラクタの詳細
DropShadowFilter()コンストラクタ
public function DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)

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

指定されたパラメータで新しい DropShadowFilter インスタンスを作成します。

パラメータ
distance:Number (default = 4.0) — シャドウのオフセット距離 (ピクセル単位) です。
 
angle:Number (default = 45) — 0 ~ 360 度で表されるシャドウの角度 (浮動小数) です。
 
color:uint (default = 0) — シャドウのカラーです。16 進数形式 (0xRRGGBB) で指定します。デフォルト値は 0x000000 です。
 
alpha:Number (default = 1.0) — シャドウカラーのアルファ透明度値です。指定できる値は 0.0 ~ 1.0 です。たとえば、.25 を指定すると、透明度の値として 25% が設定されます。
 
blurX:Number (default = 4.0) — 水平方向のぼかし量です。指定できる値は 0 ~ 255.0 (浮動小数) です。
 
blurY:Number (default = 4.0) — 垂直方向のぼかし量です。指定できる値は 0 ~ 255.0 (浮動小数) です。
 
strength:Number (default = 1.0) — インプリントの強さまたは広がりです。値が大きいほど、濃い色がインプリントされるので、シャドウと背景との間のコントラストが強くなります。指定できる値は 0 ~ 255.0 です。
 
quality:int (default = 1) — フィルタを適用する回数。BitmapFilterQuality 定数を使用します。
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

これらの値については、quality プロパティの説明を参照してください。

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

関連項目

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

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

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

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

次の例では、黄色の四角形を作成してドロップシャドウを適用します。この例に対する一般的なワークフローは、次のようになります。
  1. フィルタを適用する四角形の描画に使用する 3 つのプロパティを宣言します。
  2. コンストラクタ関数を作成します。コンストラクタは draw() メソッドを呼び出します。このメソッドでは、Sprite の graphics プロパティを介してアクセスする Graphics クラスのメソッドを使用して、オレンジ色の四角形を描画します。
  3. このコンストラクタでは、変数 filter を BitmapFilter オブジェクトとして宣言し、これを getBitmapFilter() を呼び出した戻り値に割り当てます。getBitmapFilter() メソッドでは、使用するドロップシャドウフィルタを定義します。
  4. 新しい配列オブジェクト myFilters を作成し、filter を配列に追加します。myFilters 配列を DropShadowFilterExample オブジェクトの 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.DropShadowFilter;

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

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

        private function getBitmapFilter():BitmapFilter {
            var color:Number = 0x000000;
            var angle:Number = 45;
            var alpha:Number = 0.8;
            var blurX:Number = 8;
            var blurY:Number = 8;
            var distance:Number = 15;
            var strength:Number = 0.65;
            var inner:Boolean = false;
            var knockout:Boolean = false;
            var quality:Number = BitmapFilterQuality.HIGH;
            return new DropShadowFilter(distance,
                                        angle,
                                        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/DropShadowFilter.html