| パッケージ | flash.filters |
| クラス | public final class DropShadowFilter |
| 継承 | DropShadowFilter BitmapFilter Object |
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
フィルタの使用方法は、フィルタの適用先オブジェクトによって異なります。
filters プロパティを使用します。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルタを取り消すことができます。 BitmapData.applyFilter() メソッドを使用します。BitmapData オブジェクトで applyFilter() を呼び出すことによって、\'83\'5cース BitmapData オブジェクトとフィルタオブジェクトが取得され、フィルタを適用した結果として得られるイメージが生成されます。表示オブジェクトにフィルタを適用すると、表示オブジェクトの cacheAsBitmap プロパティの値が true に設定されます。すべてのフィルタをクリアすると、cacheAsBitmap の元の値が復元されます。
このフィルタはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体が拡大 / 縮小される場合 (scaleX と scaleY プロパティの値が 1.0 以外に設定されている場合) 、フィルタは拡大 / 縮小されません。フィルタが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。
結果として得られるイメージが最大サイズを超える場合、フィルタは適用されません。AIR 1.5 および Flash Player 10 における最大サイズは、幅または高さが 8,191 ピクセルで、合計のピクセル数は 16,777,215 ピクセルを超えないようにしてください (つまり、幅が 8,191 ピクセルのイメージでは、高さが 2,048 ピクセルになります)。 Flash Player 9 以前および AIR 1.1 以前では、高さ 2,880 ピクセル、幅 2,880 ピクセルに制限されていました。例えば、フィルタが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルタがオフになります。
関連項目
| プロパティ | 定義元 | ||
|---|---|---|---|
| alpha : Number
シャドウカラーのアルファ透明度の値です。 | DropShadowFilter | ||
| angle : Number
シャドウの角度です。 | DropShadowFilter | ||
| blurX : Number
水平方向のぼかし量です。 | DropShadowFilter | ||
| blurY : Number
垂直方向のぼかし量です。 | DropShadowFilter | ||
| color : uint
シャドウのカラーです。 | DropShadowFilter | ||
![]() | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。 | Object | |
| distance : Number
シャドウのオフセット距離 (ピクセル単位) です。 | DropShadowFilter | ||
| hideObject : Boolean
オブジェクトが非表示であるかどうかを示します。 | DropShadowFilter | ||
| inner : Boolean
シャドウが内側のシャドウであるかどうかを指定します。 | DropShadowFilter | ||
| knockout : Boolean
true の場合は、ノックアウト効果を適用します。その結果、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。 | DropShadowFilter | ||
![]() | prototype : Object [静的]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。 | 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 | ||
[override]
このフィルタオブジェクトのコピーを返します。 | DropShadowFilter | ||
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
![]() |
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() |
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
![]() |
指定されたオブジェクトのストリング表現を返します。 | Object | |
![]() |
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
| alpha | プロパティ |
alpha:Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 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| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
シャドウの角度です。指定できる値は 0 ~ 360 度 (浮動小数) です。デフォルト値は 45 です。
public function get angle():Number public function set angle(value:Number):void| blurX | プロパティ |
blurX:Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
水平方向のぼかし量。指定できる値は 0 ~ 255.0 (浮動小数) です。デフォルト値は 4.0 です。
public function get blurX():Number public function set blurX(value:Number):void| blurY | プロパティ |
blurY:Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
垂直方向のぼかし量。指定できる値は 0 ~ 255.0 (浮動小数) です。デフォルト値は 4.0 です。
public function get blurY():Number public function set blurY(value:Number):void| color | プロパティ |
color:uint| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
シャドウのカラーです。指定できる値は、16 進数形式 (0xRRGGBB) です。デフォルト値は 0x000000 です。
public function get color():uint public function set color(value:uint):void| distance | プロパティ |
distance:Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
シャドウのオフセット距離 (ピクセル単位) です。デフォルト値は 4.0 (浮動小数) です。
public function get distance():Number public function set distance(value:Number):void| hideObject | プロパティ |
hideObject:Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
オブジェクトが非表示であるかどうかを示します。true を指定すると、オブジェクト自体は描画されず、シャドウだけが表示されます。デフォルトは false で、オブジェクトが表示されます。
public function get hideObject():Boolean public function set hideObject(value:Boolean):void| inner | プロパティ |
inner:Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
シャドウが内側のシャドウであるかどうかを指定します。true の場合は、内側シャドウであることを示します。デフォルトは false (外側シャドウ) で、オブジェクトの外周にあるシャドウを示します。
public function get inner():Boolean public function set inner(value:Boolean):void| knockout | プロパティ |
knockout:Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
true の場合は、ノックアウト効果を適用します。その結果、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。デフォルトは false (ノックアウトなし) です。
public function get knockout():Boolean public function set knockout(value:Boolean):void| quality | プロパティ |
quality:int| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
フィルタを適用する回数。デフォルト値は、フィルタを 1 回適用することに相当する BitmapFilterQuality.LOW です。値 BitmapFilterQuality.MEDIUM はフィルタを 2 回適用します。値 BitmapFilterQuality.HIGH はフィルタを 3 回適用します。フィルタに設定された値が小さいほど、速くレンダリングできます。
多くのアプリケーションでは、画質低、中、または高で十分です。最大 15 までの値を使用してさまざまな効果を出すことができますが、値が大きくなるほどレンダリング速度が低下します。quality の値を増やす代わりに、blurX と blurY の値を増やすだけで、同様の効果が得られます。この方法を実行すると、より高速にレンダリングされます。
public function get quality():int public function set quality(value:int):void関連項目
| strength | プロパティ |
strength:Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 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 |
| ランタイムバージョン: | AIR 1.0 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 定数を使用します。
これらの値については、 | |
inner:Boolean (default = false) — シャドウが内側のシャドウであるかどうかを指定します。true の場合は、内側シャドウを示します。値 false は外側シャドウ (オブジェクトの外側のエッジにあるシャドウ) を示します。
| |
knockout:Boolean (default = false) — true の場合は、ノックアウト効果を適用します。その結果、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。
| |
hideObject:Boolean (default = false) — オブジェクトが非表示であるかどうかを示します。true を指定すると、オブジェクト自体は描画されず、シャドウだけが表示されます。
|
関連項目
| clone | () | メソッド |
override public function clone():BitmapFilter| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
このフィルタオブジェクトのコピーを返します。
戻り値BitmapFilter — 元の DropShadowFilter インスタンスのプロパティをすべて備えた新しい DropShadowFilter インスタンスです。
|
draw() メソッドを呼び出します。このメソッドでは、Sprite の graphics プロパティを介してアクセスする Graphics クラスのメソッドを使用して、オレンジ色の四角形を描画します。filter を BitmapFilter オブジェクトとして宣言し、これを getBitmapFilter() () を呼び出した戻り値に割り当てます。getBitmapFilter() メソッドでは、使用するドロップシャドウフィルタを定義します。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/flex/3_jp/langref/flash/filters/DropShadowFilter.html