Flashドキュメンテーション 
ActionScript 2.0 リファレンスガイド > ActionScript クラス > DisplacementMapFilter (flash.filters.DisplacementMapFilter)

DisplacementMapFilter (flash.filters.DisplacementMapFilter)


Object
    |
    +-flash.filters.BitmapFilter
        |
        +-flash.filters.DisplacementMapFilter

public class DisplacementMapFilter
extends BitmapFilter

DisplacementMapFilter クラスは、指定された BitmapData オブジェクト (置き換えマップイメージといいます) のピクセル値を使用して、MovieClip インスタンスなど、ステージ上のオブジェクトの置き換え (変位) を実行します。このフィルタを使用すると、BitmapData や MovieClip のインスタンスでワープ効果や斑点効果を実現できます。

フィルタの使い方は、フィルタの適用先オブジェクトによって異なります。

実行時にムービークリップにフィルタを適用する場合は、filters プロパティを使用します。オブジェクトの filters プロパティを設定してもオブジェクトは変更されません。また、filters プロパティをクリアすることで元に戻すことができます。

BitmapData インスタンスにフィルタを適用するには、BitmapData.applyFilter() メソッドを使用します。BitmapData オブジェクトの applyFilter() を呼び出すと、その BitmapData オブジェクトは変更されて元に戻せなくなります。

イメージやビデオにもオーサリング時にフィルタ効果を適用できます。詳細については、オーサリングのマニュアルを参照してください。

ムービークリップやボタンにフィルタを適用する場合は、ムービークリップやボタンの cacheAsBitmap プロパティを true に設定します。すべてのフィルタをクリアすると、cacheAsBitmap は元の値に戻ります。

このフィルタでは次の式を使用します。

dstPixel[x, y] = srcPixel[x + ((componentX(x, y) - 128) * scaleX) / 256, y + ((componentY(x, y) - 128) * scaleY) / 256]

componentX(x, y) は、(x - mapPoint.x ,y - mapPoint.y) の mapBitmap プロパティから componentX カラー値を取得します。

フィルタで使用するマップイメージは、ステージの拡大・縮小率に一致するように拡大・縮小されます。オブジェクト自体が拡大・縮小される場合には拡大・縮小されません。

このフィルタは、ステージの拡大・縮小をサポートしていますが、通常の拡大・縮小、回転、傾斜はサポートしていません。オブジェクト自体を拡大・縮小する場合 (x 方向の尺度と y 方向の尺度が 100% でない場合)、フィルタ効果は拡大・縮小されません。フィルタ効果が拡大・縮小するのは、ステージをズームインする場合のみです。

これが DisplacementMapFilter クラスの動作方法です。ターゲットビットマップの各ピクセル (x,y) に対し、、DisplacementMapFilter クラスは次のように動作します。

結果として得られるイメージの幅または高さが 2880 ピクセルを超える場合、フィルタは適用されません。たとえば、フィルタが適用されたサイズの大きいムービークリップをズームインする場合、結果として得られるイメージが 2880 ピクセルの制限を超える場合には、フィルタはオフになります。

使用できるバージョン : ActionScript 1.0、Flash Player 8

関連項目

applyFilter (BitmapData.applyFilter メソッド), filters (MovieClip.filters プロパティ), cacheAsBitmap (MovieClip.cacheAsBitmap プロパティ)

プロパティ一覧

オプション

プロパティ

説明

 

alpha:Number

範囲外置き換えの場合に使用するアルファ透明度値を指定します。

 

color:Number

範囲外置き換えの場合に使用する色を指定します。

 

componentX:Number

x の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。

 

componentY:Number

y の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。

 

mapBitmap:BitmapData

置き換えマップデータが含まれる BitmapData オブジェクトです。

 

mapPoint:Point

マップイメージの左上隅を基準としたターゲットムービークリップの左上隅のオフセットが含まれる flash.geom.Point 値です。

 

mode:String

フィルタのモードです。

 

scaleX:Number

マップ計算の x 置き換え結果を拡大・縮小する場合に使用する乗数です。

 

scaleY:Number

マップ計算の y 置き換え結果を拡大・縮小する場合に使用する乗数です。

Object クラスから継承されるプロパティ

constructor (Object.constructor プロパティ), __proto__ (Object.__proto__ プロパティ), prototype (Object.prototype プロパティ), __resolve (Object.__resolve プロパティ)


コンストラクタ一覧

署名

説明

DisplacementMapFilter(mapBitmap:BitmapData, mapPoint:Point, componentX:Number, componentY:Number, scaleX:Number, scaleY:Number, [mode:String], [color:Number], [alpha:Number])

指定されたパラメータで DisplacementMapFilter インスタンスを初期化します。

メソッド一覧

オプション

署名

説明

 

clone() : DisplacementMapFilter

このフィルタオブジェクトのコピーを返します。

BitmapFilter クラスから継承されるメソッド

clone (BitmapFilter.clone メソッド)


Object クラスから継承されるメソッド

addProperty (Object.addProperty メソッド), hasOwnProperty (Object.hasOwnProperty メソッド), isPropertyEnumerable (Object.isPropertyEnumerable メソッド), isPrototypeOf (Object.isPrototypeOf メソッド), registerClass (Object.registerClass メソッド), toString (Object.toString メソッド), unwatch (Object.unwatch メソッド), valueOf (Object.valueOf メソッド), watch (Object.watch メソッド)


 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/8_jp/main/00002169.html