applyFilter (BitmapData.applyFilter メソッド)

public applyFilter(sourceBitmap: BitmapData , sourceRect: Rectangle , destPoint: Point , filter: BitmapFilter ) : Number

ソースイメージとフィルタオブジェクトを受け取り、フィルタを適用して得られるイメージを生成します。

このメソッドはビルトインフィルタオブジェクトの動作によって変わります。そのオブジェクトには、入力ソース矩形によって影響を受けるターゲット矩形を決定するコードがあります。

フィルタを適用した後、結果として得られるイメージが入力イメージよりも大きくなることがあります。たとえば、BlurFilter クラスを使用してソース矩形 (50,50,100,100) とターゲットポイント (10,10) をぼかすと、ターゲットイメージで変更される領域は、ぼかしのために、(10,10,60,60) よりも大きくなります。このことは、applyFilter() 呼び出し中に内部で発生します。

sourceBitmapData パラメータの sourceRect パラメータが内側領域 (200 x 200 のイメージ内の (50,50,100,100) など) である場合、フィルタは、sourceRect パラメータの外側にあるソースピクセルを使用して、ターゲット矩形を生成します。

対応バージョン : ActionScript 1.0、Flash Player 8

パラメータ

sourceBitmap:BitmapData - 使用する入力ビットマップイメージ。ソースイメージは、別の BitmapData オブジェクトにすることも、現在の BitmapData インスタンスを参照することもできます。

sourceRect:Rectangle - 入力として使用するソースイメージの領域を定義する矩形。

destPoint:Point - ソース矩形の左上隅に対応するターゲットイメージ (現在の BitmapData インスタンス) 内のポイント。

filter:BitmapFilter - フィルタ適用処理を実行する場合に使用するフィルタオブジェクト。各種類のフィルタは、次のように所定の要件を備えています。

BlurFilter -- このフィルタは、透明または不透明なソースイメージとターゲットイメージを使用できます。イメージのフォーマットが一致しない場合、フィルタ適用中に作成されるソースイメージのコピーがターゲットイメージのフォーマットに合わせられます。
BevelFilter, DropShadowFilter, GlowFilter -- これらのフィルタのターゲットイメージは透明イメージでなければなりません。DropShadowFilter または GlowFilter を呼び出すと、ドロップシャドウまたはグローのアルファチャンネルデータを含むイメージが作成されます。ドロップシャドウはターゲットイメージ上に作成されません。これらのフィルタを不透明なターゲットイメージに対して使用すると、エラーコード値 -6 が返されます。
ConvolutionFilter -- このフィルタは、透明または不透明なソースイメージとターゲットイメージを使用できます。
ColorMatrixFilter -- このフィルタは、透明または不透明なソースイメージとターゲットイメージを使用できます。
DisplacementMapFilter -- このフィルタは、透明または不透明なソースイメージとターゲットイメージを使用できますが、イメージの形式はソースとターゲットで同じでなければなりません。

戻り値

Number - フィルタが正常に適用されたかどうかを示す数値。フィルタが正常に適用されると、ゼロが返されます。フィルタの適用中にエラーが発生すると、負の数値が返されます。

例

次の例では、BitmapData インスタンスにベベルフィルタを適用する方法について説明します。

import flash.display.BitmapData;
import flash.filters.BevelFilter;
import flash.geom.Point;

var myBitmapData:BitmapData = new BitmapData(100, 80, true, 0xCCCCCCCC);

var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth());
mc.attachBitmap(myBitmapData, this.getNextHighestDepth());

var filter:BevelFilter = new BevelFilter(5, 45, 0xFFFF00, 0.8, 0x0000FF, 0.8, 20, 20, 1, 3, "inner", false);

mc.onPress = function() {
    myBitmapData.applyFilter(myBitmapData, myBitmapData.rectangle, new Point(0, 0), filter);
}

applyFilter (BitmapData.applyFilter メソッド)

パラメータ

戻り値

例

関連項目