パッケージ | flash.filters |
クラス | public final class BevelFilter |
継承 | BevelFilter BitmapFilter Object |
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9 |
新しいフィルターを作成するには、コンストラクター new BevelFilter()
を使用します。フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。
- ムービークリップ、テキストフィールド、ボタン、およびビデオにフィルターを適用する場合は、DisplayObject から継承した
filters
プロパティを使用します。オブジェクトのfilters
プロパティを設定しても、オブジェクトは変更されません。filters
プロパティをクリアすることにより、フィルターを取り消すことができます。 - BitmapData オブジェクトにフィルターを適用するには、
BitmapData.applyFilter()
メソッドを使用します。BitmapData オブジェクトでapplyFilter()
を呼び出すことによって、ソース BitmapData オブジェクトとフィルターオブジェクトが取得され、フィルターを適用したイメージが生成されます。
表示オブジェクトにフィルターを適用すると、オブジェクトの cacheAsBitmap
プロパティの値が true
に設定されます。すべてのフィルターを削除すると、cacheAsBitmap
の元の値が復元されます。
このフィルターはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。オブジェクト自体が拡大 / 縮小される場合(scaleX
と scaleY
プロパティが 100% に設定されていない場合)、フィルターは拡大 / 縮小されません。フィルターが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。
結果として得られるイメージが最大サイズを超えると、フィルターは適用されません。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.cacheAsBitmap
flash.display.BitmapData.applyFilter()
プロパティ | 定義元 | ||
---|---|---|---|
angle : Number
ベベルの角度です。 | BevelFilter | ||
blurX : Number
水平方向のぼかし量(ピクセル単位)です。 | BevelFilter | ||
blurY : Number
垂直方向のぼかし量(ピクセル単位)です。 | BevelFilter | ||
constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | ||
distance : Number
ベベルのオフセット距離です。 | BevelFilter | ||
highlightAlpha : Number
ハイライトカラーのアルファ透明度の値です。 | BevelFilter | ||
highlightColor : uint
ベベルのハイライトカラーです。 | BevelFilter | ||
knockout : Boolean
true の場合は、ノックアウト効果を適用します。その結果、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。 | BevelFilter | ||
quality : int
フィルターを適用する回数。 | BevelFilter | ||
shadowAlpha : Number
シャドウカラーのアルファ透明度の値です。 | BevelFilter | ||
shadowColor : uint
ベベルのシャドウカラーです。 | BevelFilter | ||
strength : Number
インプリントの強さまたは広がりです。 | BevelFilter | ||
type : String
オブジェクトでのベベルの配置です。 | BevelFilter |
メソッド | 定義元 | ||
---|---|---|---|
BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
指定されたパラメーターで新しい BevelFilter インスタンスを初期化します。 | BevelFilter | ||
[オーバーライド]
このフィルターオブジェクトのコピーを返します。 | BevelFilter | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
指定されたオブジェクトのストリング表現を返します。 | Object | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object |
angle | プロパティ |
angle:Number
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9 |
ベベルの角度です。有効な値の範囲は 0 ~ 360°です。デフォルト値は 45° です。
角度の値は、オブジェクトに対する架空の光源の角度を表し、オブジェクトに対する効果の相対位置を決定します。distance
プロパティが 0 に設定された場合、効果がオブジェクトからオフセットされないため、angle
プロパティは適用されません。
実装
public function get angle():Number
public function set angle(value:Number):void
blurX | プロパティ |
blurY | プロパティ |
distance | プロパティ |
highlightAlpha | プロパティ |
highlightColor | プロパティ |
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
の値を増やすだけで、同様の効果が得られます。この方法を実行すると、より高速にレンダリングされます。
次の BitmapFilterQuality
定数を使用して、quality
プロパティの値を指定できます。
BitmapFilterQuality.LOW
BitmapFilterQuality.MEDIUM
BitmapFilterQuality.HIGH
実装
public function get quality():int
public function set quality(value:int):void
shadowAlpha | プロパティ |
shadowColor | プロパティ |
strength | プロパティ |
type | プロパティ |
type:String
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9 |
オブジェクトでのベベルの配置です。内側および外側のベベルは、内側または外側のエッジに配置され、フルベベルはオブジェクト全体に配置されます。指定できる値は、次の BitmapFilterType
定数です。
BitmapFilterType.INNER
BitmapFilterType.OUTER
BitmapFilterType.FULL
実装
public function get type():String
public function set type(value:String):void
例外
TypeError — 文字列は、設定時に null に設定されます。
|
BevelFilter | () | コンストラクター |
public function BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9 |
指定されたパラメーターで新しい BevelFilter インスタンスを初期化します。
パラメーターdistance:Number (default = 4.0 ) — ベベルのオフセット距離(ピクセル単位)です(浮動小数)。
| |
angle:Number (default = 45 ) — ベベルの角度(0 ~ 360 度)です。
| |
highlightColor:uint (default = 0xFFFFFF ) — ベベルのハイライトカラー 0xRRGGBB です。
| |
highlightAlpha:Number (default = 1.0 ) — ハイライトカラーのアルファ透明度の値です。0.0 ~ 1.0 の値を指定できます。例えば .25 と指定すると、透明度は 25% になります。
| |
shadowColor:uint (default = 0x000000 ) — ベベルのシャドウカラー 0xRRGGBB です。
| |
shadowAlpha: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 ~ 255.0 です。
| |
quality:int (default = 1 ) — ベベルの品質です。指定できる値は 0 ~ 15 ですが、多くのアプリケーションでは BitmapFilterQuality 定数を使用できます。
フィルターに設定された値が小さいほど、速くレンダリングできます。指定できる他の数値を使用すると、異なる効果を作り出すことができます。 | |
type:String (default = "inner ") — ベベルの種類です。指定できる値は、次の BitmapFilterType 定数です。BitmapFilterType.INNER 、BitmapFilterType.OUTER 、または BitmapFilterType.FULL 。
| |
knockout:Boolean (default = false ) — true の場合は、ノックアウト効果を適用します。その結果、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。
|
関連する API エレメント
clone | () | メソッド |
override public function clone():BitmapFilter
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9 |
このフィルターオブジェクトのコピーを返します。
戻り値BitmapFilter — 元の BevelFilter インスタンスとプロパティがすべて同じである新しい BevelFilter インスタンスです。
|
- 必要なクラスを読み込みます。
draw()
関数で使用する 3 つのプロパティを宣言します。この関数は、ベベルフィルターを適用するオブジェクトを描画します。BevelFilterExample()
コンストラクター関数を作成します。この関数は、次の処理を行います。draw()
関数を呼び出します。この関数は後で宣言されます。filter
変数を BitmapFilter オブジェクトとして宣言し、これをgetBitmapFilter()
を呼び出した戻り値に割り当てます。- 新しい配列オブジェクト
myFilters
を作成し、その配列にfilter
を追加します。さらにmyFilters
を BevelFilterExample オブジェクトのfilters
プロパティに割り当てます。これにより、myFilters
で見つかったすべてのフィルターが適用されます。この場合は、filter
だけです。
getBitmapFilter
関数を作成して、フィルターのプロパティを作成して設定します。draw()
関数を作成します。この関数は、Sprite クラスのgraphics
プロパティを介してアクセスする Graphics クラスのメソッドを使用して、四角形を描画します。
package { import flash.display.Sprite; import flash.filters.BevelFilter; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.BitmapFilterType; public class BevelFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function BevelFilterExample() { draw(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } private function getBitmapFilter():BitmapFilter { var distance:Number = 5; var angleInDegrees:Number = 45; var highlightColor:Number = 0xFFFF00; var highlightAlpha:Number = 0.8; var shadowColor:Number = 0x0000FF; var shadowAlpha:Number = 0.8; var blurX:Number = 5; var blurY:Number = 5; var strength:Number = 5; var quality:Number = BitmapFilterQuality.HIGH; var type:String = BitmapFilterType.INNER; var knockout:Boolean = false; return new BevelFilter(distance, angleInDegrees, highlightColor, highlightAlpha, shadowColor, shadowAlpha, blurX, blurY, strength, quality, type, knockout); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(offset, offset, size, size); graphics.endFill(); } } }
Tue Jun 12 2018, 10:34 AM Z