| Paket | spark.filters |
| Klasse | public class DisplacementMapFilter |
| Vererbung | DisplacementMapFilter  BaseFilter EventDispatcher Object |
| Implementiert | IBitmapFilter |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Verwendung von Filtern hängt davon ab, auf welches Objekt sie jeweils angewendet werden:
- Um Filter auf ein Anzeigeobjekt anzuwenden, verwenden Sie die
filters-Eigenschaft des Anzeigeobjekts. Durch die Einstellung derfilters-Eigenschaft wird das betroffene Objekt selbst nicht verändert, und Sie können den Filter wieder entfernen, indem Sie diefilters-Eigenschaft löschen. - Um Filter auf BitmapData-Objekte anzuwenden, verwenden Sie die
BitmapData.applyFilter()-Methode. Beim Aufrufen vonapplyFilter()für ein BitmapData-Objekt wird das gefilterte Bild aus dem BitmapData-Quellobjekt und dem Filterobjekt kombiniert.
Wenn Sie einen Filter auf ein Anzeigeobjekt anwenden, wird der Wert der cacheAsBitmap-Eigenschaft des Anzeigeobjekts auf true gesetzt. Wenn Sie alle Filter entfernen, wird der ursprüngliche Wert von cacheAsBitmap wiederhergestellt.
Der Filter verwendet die folgende Formel:
dstPixel[x, y] = srcPixel[x + ((componentX(x, y) - 128) * scaleX) / 256, y + ((componentY(x, y) - 128) *scaleY) / 256)
Dabei erhält componentX(x, y) den componentX-Farbwert der mapBitmap-Eigenschaft an der Position (x - mapPoint.x ,y - mapPoint.y).
Das mit dem Filter verwendete Matrixbild wird so skaliert, dass es an die Größe der Bühne angepasst wird. Wenn das Objekt selbst skaliert wird, wird das Matrixbild nicht skaliert.
Dieser Filter unterstützt Bühnenskalierung. Allgemeine Skalierung, Drehung und Neigung werden jedoch nicht unterstützt. Wenn das Objekt selbst skaliert wird (also die Eigenschaften scaleX und scaleY ungleich 1,0 sind), wird der Filtereffekt nicht skaliert. Er wird nur dann skaliert, wenn die Bühne vergrößert dargestellt wird.
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <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" />
Verwandte API-Elemente
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| alpha : Number
Gibt an, welcher Alphatransparenzwert für Verschiebungen außerhalb des gültigen Bereichs verwendet werden soll. | DisplacementMapFilter | ||
| color : uint
Gibt an, welche Farbe für Verschiebungen außerhalb des gültigen Bereichs verwendet werden soll. | DisplacementMapFilter | ||
| componentX : uint
Gibt den Farbkanal im Matrixbild an, mit dem das x-Ergebnis verschoben wird. | DisplacementMapFilter | ||
| componentY : uint
Gibt den Farbkanal im Matrixbild an, mit dem das y-Ergebnis verschoben wird. | DisplacementMapFilter | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| mapBitmap : BitmapData
Ein BitmapData-Objekt mit den Daten der Verschiebungsmatrix. | DisplacementMapFilter | ||
| mapPoint : Point
Ein Wert mit dem Offset der linken oberen Ecke des Zielanzeigeobjekts zur linken oberen Ecke des Matrixbilds. | DisplacementMapFilter | ||
| mode : String
Der Filtermodus. | DisplacementMapFilter | ||
| scaleX : Number
Der Multiplikator, anhand dessen das auf der Matrixberechnung beruhende Ergebnis der x-Verschiebung skaliert wird. | DisplacementMapFilter | ||
| scaleY : Number
Der Multiplikator, anhand dessen das auf der Matrixberechnung beruhende Ergebnis der y-Verschiebung skaliert wird. | DisplacementMapFilter | ||
| Methode | Definiert von | ||
|---|---|---|---|
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)
Konstruktor. | DisplacementMapFilter | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
Gibt eine Kopie dieses Filterobjekts zurück. | DisplacementMapFilter | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Propagiert ein Change-Ereignis, wenn sich der Filter geändert hat. | BaseFilter | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
alpha | Eigenschaft |
alpha:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt an, welcher Alphatransparenzwert für Verschiebungen außerhalb des gültigen Bereichs verwendet werden soll. Wird als normalisierter Wert zwischen 0,0 und 1,0 angegeben. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt. Der Standardwert ist 0. Verwenden Sie diese Eigenschaft, wenn die Eigenschaft mode auf DisplacementMapFilterMode.COLOR gesetzt wurde.
Der Standardwert ist 0.
Implementierung
public function get alpha():Number public function set alpha(value:Number):voidcolor | Eigenschaft |
color:uint| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt an, welche Farbe für Verschiebungen außerhalb des gültigen Bereichs verwendet werden soll. Der zulässige Bereich für Verschiebungen liegt zwischen 0,0 und 1,0. Die Werte liegen im hexadezimalen Format vor. Der Standardwert für color lautet 0. Verwenden Sie diese Eigenschaft, wenn die Eigenschaft mode auf DisplacementMapFilterMode.COLOR gesetzt wurde.
Der Standardwert ist 0x000000.
Implementierung
public function get color():uint public function set color(value:uint):voidcomponentX | Eigenschaft |
componentX:uint| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt den Farbkanal im Matrixbild an, mit dem das x-Ergebnis verschoben wird. Zulässige Werte sind die BitmapDataChannel-Konstanten:
BitmapDataChannel.ALPHABitmapDataChannel.BLUEBitmapDataChannel.GREENBitmapDataChannel.RED
Der Standardwert ist 0, meaning no channel..
Implementierung
public function get componentX():uint public function set componentX(value:uint):voidVerwandte API-Elemente
componentY | Eigenschaft |
componentY:uint| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt den Farbkanal im Matrixbild an, mit dem das y-Ergebnis verschoben wird. Zulässige Werte sind die BitmapDataChannel-Konstanten:
BitmapDataChannel.ALPHABitmapDataChannel.BLUEBitmapDataChannel.GREENBitmapDataChannel.RED
Der Standardwert ist 0, meaning no channel..
Implementierung
public function get componentY():uint public function set componentY(value:uint):voidmapBitmap | Eigenschaft |
mapBitmap:BitmapData| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ein BitmapData-Objekt mit den Daten der Verschiebungsmatrix.
Der Standardwert ist null.
Implementierung
public function get mapBitmap():BitmapData public function set mapBitmap(value:BitmapData):voidmapPoint | Eigenschaft |
mapPoint:Point| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ein Wert mit dem Offset der linken oberen Ecke des Zielanzeigeobjekts zur linken oberen Ecke des Matrixbilds.
Der Standardwert ist null.
Implementierung
public function get mapPoint():Point public function set mapPoint(value:Point):voidmode | Eigenschaft |
mode:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Filtermodus. Zulässige Werte sind die DisplacementMapFilterMode-Konstanten:
DisplacementMapFilterMode.WRAP- Verlegt den Verschiebungswert auf die andere Seite des Quellbilds.DisplacementMapFilterMode.CLAMP- Setzt den Verschiebungswert auf die Kante des Quellbilds.DisplacementMapFilterMode.IGNORE- Liegt der Verschiebungswert außerhalb des gültigen Bereichs, wird die Verschiebung ignoriert, und es werden die Quellpixel verwendet.DisplacementMapFilterMode.COLOR- Liegt der Verschiebungswert außerhalb des Bildes, werden die Werte der color- und alpha-Eigenschaften ersetzt.
Der Standardwert ist DisplacementMapFilterMode.WRAP.
Implementierung
public function get mode():String public function set mode(value:String):voidscaleX | Eigenschaft |
scaleX:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Multiplikator, anhand dessen das auf der Matrixberechnung beruhende Ergebnis der x-Verschiebung skaliert wird.
Der Standardwert ist 0.
Implementierung
public function get scaleX():Number public function set scaleX(value:Number):voidscaleY | Eigenschaft |
scaleY:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Multiplikator, anhand dessen das auf der Matrixberechnung beruhende Ergebnis der y-Verschiebung skaliert wird.
Der Standardwert ist 0.
Implementierung
public function get scaleY():Number public function set scaleY(value:Number):voidDisplacementMapFilter | () | Konstruktor |
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)| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor.
ParametermapBitmap: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 auf DisplacementMapFilterMode.COLOR gesetzt wurde.
| |
alpha:Number (default = 0.0)mode auf DisplacementMapFilterMode.COLOR gesetzt wurde.
|
Verwandte API-Elemente
clone | () | Methode |
public function clone():BitmapFilter| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt eine Kopie dieses Filterobjekts zurück.
RückgabewerteBitmapFilter — Eine neue DisplacementMapFilter-Instanz mit allen Eigenschaften der ursprünglichen Instanz.
|
Tue Jun 12 2018, 10:04 AM Z