| Pacchetto | spark.filters |
| Classe | public class DisplacementMapFilter |
| Ereditarietà | DisplacementMapFilter  BaseFilter EventDispatcher Object |
| Implementa | IBitmapFilter |
| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
The use of filters depends on the object to which you apply the filter:
- To apply filters to a display object, use the
filtersproperty of the display object. Setting thefiltersproperty of an object does not modify the object, and you can remove the filter by clearing thefiltersproperty. - To apply filters to BitmapData objects, use the
BitmapData.applyFilter()method. CallingapplyFilter()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.
Mostra sintassi MXML
Nascondi sintassi MXMLThe <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" />
Elementi API correlati
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
| Proprietà | Definito da | ||
|---|---|---|---|
| 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
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | 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 | ||
| Metodo | Definito da | ||
|---|---|---|---|
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
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
Returns a copy of this filter object. | DisplacementMapFilter | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Propagates a change event when the filter has changed. | BaseFilter | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
alpha | proprietà |
alpha:Number| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | 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.
Il valore predefinito è 0.
Implementazione
public function get alpha():Number public function set alpha(value:Number):voidcolor | proprietà |
color:uint| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | 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.
Il valore predefinito è 0x000000.
Implementazione
public function get color():uint public function set color(value:uint):voidcomponentX | proprietà |
componentX:uint| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | 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.ALPHABitmapDataChannel.BLUEBitmapDataChannel.GREENBitmapDataChannel.RED
Il valore predefinito è 0, meaning no channel..
Implementazione
public function get componentX():uint public function set componentX(value:uint):voidElementi API correlati
componentY | proprietà |
componentY:uint| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | 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.ALPHABitmapDataChannel.BLUEBitmapDataChannel.GREENBitmapDataChannel.RED
Il valore predefinito è 0, meaning no channel..
Implementazione
public function get componentY():uint public function set componentY(value:uint):voidmapBitmap | proprietà |
mapBitmap:BitmapData| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
A BitmapData object containing the displacement map data.
Il valore predefinito è null.
Implementazione
public function get mapBitmap():BitmapData public function set mapBitmap(value:BitmapData):voidmapPoint | proprietà |
mapPoint:Point| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | 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.
Il valore predefinito è null.
Implementazione
public function get mapPoint():Point public function set mapPoint(value:Point):voidmode | proprietà |
mode:String| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | 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.
Il valore predefinito è DisplacementMapFilterMode.WRAP.
Implementazione
public function get mode():String public function set mode(value:String):voidscaleX | proprietà |
scaleX:Number| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
The multiplier to use to scale the x displacement result from the map calculation.
Il valore predefinito è 0.
Implementazione
public function get scaleX():Number public function set scaleX(value:Number):voidscaleY | proprietà |
scaleY:Number| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
The multiplier to use to scale the y displacement result from the map calculation.
Il valore predefinito è 0.
Implementazione
public function get scaleY():Number public function set scaleY(value:Number):voidDisplacementMapFilter | () | Funzione di costruzione |
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)| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Constructor.
ParametrimapBitmap:BitmapData (default = null) | |
mapPoint:Point (default = null) | |
componentX:uint (default = 0) | |
componentY:uint (default = 0) | |
scaleX:Number (default = 0.0) | |
scaleY:Number (default = 0.0) | |
mode:String (default = "wrap") | |
color:uint (default = 0)mode is set to DisplacementMapFilterMode.COLOR.
| |
alpha:Number (default = 0.0)mode is set to DisplacementMapFilterMode.COLOR.
|
Elementi API correlati
clone | () | metodo |
public function clone():BitmapFilter| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flex 4 |
| Versioni runtime: | Flash Player 10, AIR 1.5 |
Returns a copy of this filter object.
RestituisceBitmapFilter — A new DisplacementMapFilter instance with all the same properties as the
original one.
|
Tue Jun 12 2018, 02:44 PM Z