| パッケージ | spark.filters |
| クラス | public class BlurFilter |
| 継承 | BlurFilter  BaseFilter EventDispatcher Object |
| 実装 | IBitmapFilter |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
quality プロパティを低く設定すると、ソフトフォーカスがかかっているように見えるぼかしになります。quality プロパティを高く設定すると、ガウスぼかしフィルターに似たものになります。このフィルターは、MovieClip、SimpleButton、TextField、Video オブジェクトなどの DisplayObject クラスから継承した表示オブジェクト、および BitmapData オブジェクトに適用できます。
新しいフィルターを作成するには、コンストラクター new BlurFilter() を使用します。フィルターの使用方法は、フィルターの適用先オブジェクトによって異なります。
- ムービークリップ、テキストフィールド、ボタン、およびビデオにフィルターを適用する場合は、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 ピクセルになります）。例えば、フィルターが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルターがオフになります。
MXML シンタックス
MXML シンタックスを表示
MXML シンタックスを隠すThe <s:BlurFilter> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:BlurFilter
Properties
blurX="4.0"
blurY="4.0"
quality="low"
/>
さらに例を参照
関連する API エレメント
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.BitmapData.applyFilter()
| プロパティ | 定義元 | ||
|---|---|---|---|
| blurX : Number
水平方向のぼかし量。 | BlurFilter | ||
| blurY : Number
垂直方向のぼかし量。 | BlurFilter | ||
 | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| quality : int
フィルターを適用する回数。 | BlurFilter | ||
| メソッド | 定義元 | ||
|---|---|---|---|
コンストラクターです。 | BlurFilter | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
このフィルターオブジェクトのコピーを返します。 | BlurFilter | ||
|
イベントをイベントフローに送出します。 | EventDispatcher | |
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
フィルターの変更時に変更イベントを伝播します。 | BaseFilter | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
blurX | プロパティ |
blurX:Number| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
水平方向のぼかし量。指定できる値は 0 ～ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。デフォルト値は 4 です。2 のべき乗（2、4、8、16、32 など）は、他の値と比べて速くレンダリングできるよう最適化されます。
デフォルト値： 4.0。
実装
public function get blurX():Number public function set blurX(value:Number):voidblurY | プロパティ |
blurY:Number| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
垂直方向のぼかし量。指定できる値は 0 ～ 255 です。1 以下の値を指定すると、元のイメージがそのままコピーされます。デフォルト値は 4 です。2 のべき乗（2、4、8、16、32 など）は、他の値と比べて速くレンダリングできるよう最適化されます。
デフォルト値： 4.0。
実装
public function get blurY():Number public function set blurY(value:Number):voidquality | プロパティ |
quality:int| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
フィルターを適用する回数。デフォルト値は、フィルターを 1 回適用することに相当する BitmapFilterQuality.LOW です。値 BitmapFilterQuality.MEDIUM はフィルターを 2 回適用します。値 BitmapFilterQuality.HIGH はフィルターを 3 回適用します。フィルターに設定された値が小さいほど、速くレンダリングできます。
多くのアプリケーションでは、quality の値は低、中、または高で十分です。最大 15 までの値を使用してさまざまな効果を出すことができますが、値が大きくなるほどレンダリング速度が低下します。quality の値を増やす代わりに、blurX と blurY の値を増やすだけで、同様の効果が得られます。この方法を実行すると、より高速にレンダリングされます。
デフォルト値： "low"。
実装
public function get quality():int public function set quality(value:int):voidBlurFilter | () | コンストラクター |
public function BlurFilter(blurX:Number = 4.0, blurY:Number = 4.0, quality:int = 1)| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
コンストラクターです。デフォルト値では、ソフトフォーカスのかかったイメージが作成されます。
パラメーターblurX:Number (default = 4.0) | |
blurY:Number (default = 4.0) | |
quality:int (default = 1)
高品質にすると、ガウスぼかしに似たものになります。多くのアプリケーションでは、これら 3 つの値で十分です。最大 15 までの値を使用して様々な効果を出すことができますが、値が大きくなるほどレンダリング速度が低下することに注意してください。 |
clone | () | メソッド |
public function clone():BitmapFilter| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このフィルターオブジェクトのコピーを返します。
戻り値BitmapFilter — 元の BlurFilter インスタンスとプロパティがすべて同じである新しい BlurFilter インスタンスです。
|
<?xml version="1.0"?>
<!-- filters/examples/BlurFilterExample.mxml -->
<s:Application
xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:mx="library://ns.adobe.com/flex/mx"
xmlns:s="library://ns.adobe.com/flex/spark"
creationComplete="createFilters()">
<fx:Script><![CDATA[
import spark.filters.*;
import flash.filters.BitmapFilterQuality;
import flash.filters.BitmapFilterType;
private var myBlurFilter:BlurFilter;
private var color:Number = 0xFF33FF;
public function createFilters():void {
myBlurFilter = new BlurFilter(3, 3, BitmapFilterQuality.MEDIUM);
b1.filters = [myBlurFilter];
}
]]></fx:Script>
<s:VGroup>
<!-- This button has a filter applied in ActionScript. -->
<s:Button id="b1" label="Click me"/>
<!-- This button has a filter applied in MXML. -->
<s:Button id="b2" label="Click me">
<s:filters>
<s:BlurFilter
blurX="3"
blurY="3"
quality="{BitmapFilterQuality.MEDIUM}"/>
</s:filters>
</s:Button>
</s:VGroup>
</s:Application>
Tue Jun 12 2018, 10:34 AM Z