パッケージ | flash.filters |
クラス | public final class GlowFilter |
継承 | GlowFilter ![]() ![]() |
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9 |
distance
プロパティと angle
プロパティを 0 に設定したドロップシャドウフィルターによく似ています。このフィルターは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。
フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。
- 表示オブジェクトにフィルターを適用する場合は、DisplayObject から継承した
filters
プロパティを使用します。オブジェクトのfilters
プロパティを設定しても、オブジェクトは変更されません。filters
プロパティをクリアすることにより、フィルターを取り消すことができます。 - BitmapData オブジェクトにフィルターを適用するには、
BitmapData.applyFilter()
メソッドを使用します。BitmapData オブジェクトでapplyFilter()
を呼び出すことによって、ソース 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 ピクセルです。 例えば、フィルターが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルターがオフになります。
関連する API エレメント
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 | ||
![]() | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
inner : Boolean
グローが内側グローであるかどうかを示します。 | GlowFilter | ||
knockout : Boolean
オブジェクトにノックアウト効果を適用するかどうかを指定します。 | GlowFilter | ||
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 | ||
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
![]() |
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() |
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
![]() |
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
![]() |
指定されたオブジェクトのストリング表現を返します。 | Object | |
![]() |
指定されたオブジェクトのプリミティブな値を返します。 | Object |
alpha | プロパティ |
blurX | プロパティ |
blurY | プロパティ |
color | プロパティ |
inner | プロパティ |
knockout | プロパティ |
quality | プロパティ |
quality:int
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9 |
フィルターを適用する回数。デフォルト値は、フィルターを 1 回適用することに相当する BitmapFilterQuality.LOW
です。値 BitmapFilterQuality.MEDIUM
はフィルターを 2 回適用します。値 BitmapFilterQuality.HIGH
はフィルターを 3 回適用します。フィルターに設定された値が小さいほど、速くレンダリングできます。
多くのアプリケーションでは、quality
の値は低、中、または高で十分です。最大 15 までの値を使用してさまざまな効果を出すことができますが、値が大きくなるほどレンダリング速度が低下します。quality
の値を増やす代わりに、blurX
と blurY
の値を増やすだけで、同様の効果が得られます。この方法を実行すると、より高速にレンダリングされます。
実装
public function get quality():int
public function set quality(value:int):void
関連する API エレメント
strength | プロパティ |
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 |
ランタイムバージョン: | AIR 1.0, 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 定数を使用します。
詳細については、 | |
inner:Boolean (default = false ) — グローが内側グローであるかどうかを示します。true の場合は、内側グローであることを示します。値 false は外側グロー(オブジェクトの外周にあるグロー)を示します。
| |
knockout:Boolean (default = false ) — オブジェクトにノックアウト効果を適用するかどうかを指定します。true を指定すると、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。
|
関連する API エレメント
clone | () | メソッド |
override public function clone():BitmapFilter
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9 |
このフィルターオブジェクトのコピーを返します。
戻り値BitmapFilter — 元の GlowFilter インスタンスのプロパティをすべて備えた新しい GlowFilter インスタンスです。
|
- 必要なクラスを読み込みます。
draw
メソッドで使用する 3 つのプロパティを宣言し、Sprite のgraphics
プロパティを介してアクセスする Graphics クラスのメソッドを使用して、オレンジ色の四角形を描画します。- コンストラクター関数を作成します。この関数は、次の処理を行います。
- 長方形を作成するには、
draw
関数を作成します。 - BitmapFilter オブジェクト
glowFilter
を作成し、getBitmapFilter()
関数の戻り値を割り当てます。 glowFilter
オブジェクトの値の配列を、ルート表示オブジェクトのfilters
プロパティに割り当てます。この場合、ルート表示オブジェクトのすべての表示オブジェクトの子は、グローフィルタープロパティを継承します。そのため、draw()
関数で作成された長方形には、グローフィルタープロパティが表示されます。
- 長方形を作成するには、
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 the rectangle using the draw() function below draw(); //assign the values from getBitmapFilter function below //to a BitmapFilter object "glowFilter" var glowFilter:BitmapFilter = getBitmapFilter(); //populate the filters property of the root display object with the array of values //from the glowFilter object. filters = [ glowFilter ]; } 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(); } } }
Tue Jun 12 2018, 10:34 AM Z