DisplacementMapFilter

패키지	spark.filters
클래스	public class DisplacementMapFilter
상속	DisplacementMapFilter BaseFilter EventDispatcher Object
구현	IBitmapFilter

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

The DisplacementMapFilter class uses the pixel values from the specified BitmapData object (called the displacement map image) to perform a displacement of an object. You can use this filter to apply a warped or mottled effect to any object that inherits from the DisplayObject class, such as MovieClip, SimpleButton, TextField, and Video objects, as well as to BitmapData objects.

The use of filters depends on the object to which you apply the filter:

To apply filters to a display object, use the filters property of the display object. Setting the filters property of an object does not modify the object, and you can remove the filter by clearing the filters property.
To apply filters to BitmapData objects, use the BitmapData.applyFilter() method. Calling applyFilter() on a BitmapData object takes the source BitmapData object and the filter object and generates a filtered image.

If you apply a filter to a display object, the value of the cacheAsBitmap property of the display object is set to true. If you clear all filters, the original value of cacheAsBitmap is restored.

The filter uses the following formula:

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

where componentX(x, y) gets the componentX property color value from the mapBitmap property at (x - mapPoint.x ,y - mapPoint.y).

The map image used by the filter is scaled to match the Stage scaling. It is not scaled when the object itself is scaled.

This filter supports Stage scaling. However, general scaling, rotation, and skewing are not supported. If the object itself is scaled (if the scaleX and scaleY properties are set to a value other than 1.0), the filter effect is not scaled. It is scaled only when the user zooms in on the Stage.

MXML 구문

MXML 구문 숨기기

The <s:DisplacementMapFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

 <s:DisplacementMapFilter 
   Properties
   alpha="0"
   color="0x000000"
   componentX="0"
   componentY="0"
   mapBitmap="null"
   mapPoint="null"
   mode="wrap"
   scaleX="0"
   scaleY="0"
 />

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		alpha : Number Specifies the alpha transparency value to use for out-of-bounds displacements.	DisplacementMapFilter
		color : uint Specifies what color to use for out-of-bounds displacements.	DisplacementMapFilter
		componentX : uint Describes which color channel to use in the map image to displace the x result.	DisplacementMapFilter
		componentY : uint Describes which color channel to use in the map image to displace the y result.	DisplacementMapFilter
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		mapBitmap : BitmapData A BitmapData object containing the displacement map data.	DisplacementMapFilter
		mapPoint : Point A value that contains the offset of the upper-left corner of the target display object from the upper-left corner of the map image.	DisplacementMapFilter
		mode : String The mode for the filter.	DisplacementMapFilter
		scaleX : Number The multiplier to use to scale the x displacement result from the map calculation.	DisplacementMapFilter
		scaleY : Number The multiplier to use to scale the y displacement result from the map calculation.	DisplacementMapFilter

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		DisplacementMapFilter(mapBitmap:BitmapData = null, mapPoint:Point = null, componentX:uint = 0, componentY:uint = 0, scaleX:Number = 0.0, scaleY:Number = 0.0, mode:String = "wrap", color:uint = 0, alpha:Number = 0.0) Constructor.	DisplacementMapFilter
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		clone():BitmapFilter Returns a copy of this filter object.	DisplacementMapFilter
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		notifyFilterChanged():void Propagates a change event when the filter has changed.	BaseFilter
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	이벤트		요약	정의 주체
		activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
		deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher

공용 상수

상속되는 공용 상수 숨기기

상속되는 공용 상수 표시

	상수		정의 주체

속성 세부 정보

alpha

속성

alpha:Number

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Specifies the alpha transparency value to use for out-of-bounds displacements. It is specified as a normalized value from 0.0 to 1.0. For example, .25 sets a transparency value of 25%. The default value is 0. Use this property if the mode property is set to DisplacementMapFilterMode.COLOR.

기본값: 0.

구현
public function get alpha():Number
public function set alpha(value:Number):void

color

속성

color:uint

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Specifies what color to use for out-of-bounds displacements. The valid range of displacements is 0.0 to 1.0. Values are in hexadecimal format. The default value for color is 0. Use this property if the mode property is set to DisplacementMapFilterMode.COLOR.

기본값: 0x000000.

구현
public function get color():uint
public function set color(value:uint):void

componentX

속성

componentX:uint

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Describes which color channel to use in the map image to displace the x result. Possible values are BitmapDataChannel constants:

BitmapDataChannel.ALPHA
BitmapDataChannel.BLUE
BitmapDataChannel.GREEN
BitmapDataChannel.RED

기본값: 0, meaning no channel..

구현
public function get componentX():uint
public function set componentX(value:uint):void

componentY

속성

componentY:uint

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Describes which color channel to use in the map image to displace the y result. Possible values are BitmapDataChannel constants:

BitmapDataChannel.ALPHA
BitmapDataChannel.BLUE
BitmapDataChannel.GREEN
BitmapDataChannel.RED

기본값: 0, meaning no channel..

구현
public function get componentY():uint
public function set componentY(value:uint):void

mapBitmap

속성

mapBitmap:BitmapData

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

A BitmapData object containing the displacement map data.

기본값: null.

구현
public function get mapBitmap():BitmapData
public function set mapBitmap(value:BitmapData):void

mapPoint

속성

mapPoint:Point

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

A value that contains the offset of the upper-left corner of the target display object from the upper-left corner of the map image.

기본값: null.

구현
public function get mapPoint():Point
public function set mapPoint(value:Point):void

mode

속성

mode:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

The mode for the filter. Possible values are DisplacementMapFilterMode constants:

DisplacementMapFilterMode.WRAP - Wraps the displacement value to the other side of the source image.
DisplacementMapFilterMode.CLAMP - Clamps the displacement value to the edge of the source image.
DisplacementMapFilterMode.IGNORE - If the displacement value is out of range, ignores the displacement and uses the source pixel.
DisplacementMapFilterMode.COLOR - If the displacement value is outside the image, substitutes the values in the color and alpha properties.

기본값: DisplacementMapFilterMode.WRAP.

구현
public function get mode():String
public function set mode(value:String):void

scaleX

속성

scaleX:Number

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

The multiplier to use to scale the x displacement result from the map calculation.

기본값: 0.

구현
public function get scaleX():Number
public function set scaleX(value:Number):void

scaleY

속성

scaleY:Number

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

The multiplier to use to scale the y displacement result from the map calculation.

기본값: 0.

구현
public function get scaleY():Number
public function set scaleY(value:Number):void

생성자 세부 정보

()

생성자

public function DisplacementMapFilter(mapBitmap:BitmapData = null, mapPoint:Point = null, componentX:uint = 0, componentY:uint = 0, scaleX:Number = 0.0, scaleY:Number = 0.0, mode:String = "wrap", color:uint = 0, alpha:Number = 0.0)

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Constructor.

매개 변수

	`mapBitmap:BitmapData` (default = `null`) — A BitmapData object containing the displacement map data.

	`mapPoint:Point` (default = `null`) — A value that contains the offset of the upper-left corner of the target display object from the upper-left corner of the map image.

	`componentX:uint` (default = `0`) — Describes which color channel to use in the map image to displace the x result. Possible values are the BitmapDataChannel constants.

	`componentY:uint` (default = `0`) — Describes which color channel to use in the map image to displace the y result. Possible values are the BitmapDataChannel constants.

	`scaleX:Number` (default = `0.0`) — The multiplier to use to scale the x displacement result from the map calculation.

	`scaleY:Number` (default = `0.0`) — The multiplier to use to scale the y displacement result from the map calculation.

	`mode:String` (default = "`wrap`") — The mode of the filter. Possible values are the DisplacementMapFilterMode constants.

	`color:uint` (default = `0`) — Specifies the color to use for out-of-bounds displacements. The valid range of displacements is 0.0 to 1.0. Use this parameter if `mode` is set to `DisplacementMapFilterMode.COLOR`.

	`alpha:Number` (default = `0.0`) — Specifies what alpha value to use for out-of-bounds displacements. It is specified as a normalized value from 0.0 to 1.0. For example, .25 sets a transparency value of 25%. Use this parameter if `mode` is set to `DisplacementMapFilterMode.COLOR`.

clone

()

메서드

public function clone():BitmapFilter

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Returns a copy of this filter object.

반환값

BitmapFilter — A new DisplacementMapFilter instance with all the same properties as the original one.

법적 고지 사항 | 온라인 개인 정보 보호 정책

DisplacementMapFilter - AS3 Flex

클래스 x

alpha

color

componentX

componentY

mapBitmap

mapPoint

mode

scaleX

scaleY

DisplacementMapFilter

clone