Package | spark.filters |
Classe | public class DisplacementMapFilter |
Héritage | DisplacementMapFilter BaseFilter EventDispatcher Object |
Implémente | IBitmapFilter |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
L’utilisation de filtres dépend de l’objet auquel vous appliquez le filtre.
- Pour appliquer des filtres à un objet d’affichage, utilisez la propriété
filters
de cet objet. Lorsque vous définissez la propriétéfilters
d’un objet, celui-ci n’est pas modifié. En outre, vous pouvez supprimer la propriétéfilters
pour enlever le filtre. - Pour appliquer des filtres aux objets BitmapData, utilisez la méthode
BitmapData.applyFilter()
. L’appel deapplyFilter()
pour un objet BitmapData génère une image filtrée à partir de l’objet BitmapData source et de l’objet filtre.
Si vous appliquez un filtre à un objet d’affichage, la valeur de la propriété cacheAsBitmap
de cet objet est définie sur true
. Si vous supprimez tous les filtres, la valeur d’origine de cacheAsBitmap
est restaurée.
Le filtre utilise la formule suivante :
dstPixel[x, y] = srcPixel[x + ((componentX(x, y) - 128) * scaleX) / 256, y + ((componentY(x, y) - 128) *scaleY) / 256)
où componentX(x, y)
extrait la valeur de couleur de la propriété componentX
de la propriété mapBitmap
, à (x - mapPoint.x ,y - mapPoint.y)
.
L’image de mappage utilisée par le filtre est redimensionnée en fonction de l’échelle de la scène. Elle n’est en aucun cas redimensionnée lorsque l’objet l’est.
Ce filtre prend en charge le redimensionnement de la scène. Mais le redimensionnement général, la rotation et l’inclinaison ne sont pas gérés. Si l’objet lui-même est redimensionné (si les propriétés scaleX
et scaleY
ne correspondent pas à 1,0), l’effet du filtre n’est pas redimensionné. Le redimensionnement est effectué uniquement en cas de zoom avant sur la scène.
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" />
Eléments de l’API associés
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
Propriété | Défini par | ||
---|---|---|---|
alpha : Number
Spécifie la transparence alpha à utiliser pour les déplacements en dehors des limites. | DisplacementMapFilter | ||
color : uint
Spécifie la couleur à utiliser pour les déplacements en dehors des limites. | DisplacementMapFilter | ||
componentX : uint
Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat x. | DisplacementMapFilter | ||
componentY : uint
Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat y. | DisplacementMapFilter | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
mapBitmap : BitmapData
Objet BitmapData contenant les données de mappage du déplacement. | DisplacementMapFilter | ||
mapPoint : Point
Valeur contenant le décalage du coin supérieur gauche de l’objet d’affichage cible par rapport au coin supérieur gauche de l’image de mappage. | DisplacementMapFilter | ||
mode : String
Mode du filtre. | DisplacementMapFilter | ||
scaleX : Number
Multiplicateur à utiliser pour redimensionner le résultat du déplacement x à partir du calcul de mappage. | DisplacementMapFilter | ||
scaleY : Number
Multiplicateur à utiliser pour redimensionner le résultat du déplacement y à partir du calcul de mappage. | DisplacementMapFilter |
Méthode | Défini par | ||
---|---|---|---|
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)
Constructeur. | DisplacementMapFilter | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | ||
Renvoie une copie de cet objet filtre. | DisplacementMapFilter | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Propage un événement change lorsque le filtre a été modifié. | BaseFilter | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher |
alpha | propriété |
alpha:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie la transparence alpha à utiliser pour les déplacements en dehors des limites. Elle est spécifiée en tant que valeur normalisée comprise entre 0,0 et 1,0. Par exemple, 0,25 définit une valeur de transparence de 25 %. La valeur par défaut est 0. Utilisez cette propriété si la propriété mode est réglée sur DisplacementMapFilterMode.COLOR.
La valeur par défaut est 0.
Implémentation
public function get alpha():Number
public function set alpha(value:Number):void
color | propriété |
color:uint
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie la couleur à utiliser pour les déplacements en dehors des limites. La plage valide est comprise entre 0.0 et 1.0. Les valeurs sont au format hexadécimal. La valeur par défaut pour color est 0. Utilisez cette propriété si la propriété mode est réglée sur DisplacementMapFilterMode.COLOR.
La valeur par défaut est 0x000000.
Implémentation
public function get color():uint
public function set color(value:uint):void
componentX | propriété |
componentX:uint
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat x. Les valeurs possibles sont les constantes BitmapDataChannel :
BitmapDataChannel.ALPHA
BitmapDataChannel.BLUE
BitmapDataChannel.GREEN
BitmapDataChannel.RED
La valeur par défaut est 0, meaning no channel..
Implémentation
public function get componentX():uint
public function set componentX(value:uint):void
Eléments de l’API associés
componentY | propriété |
componentY:uint
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat y. Les valeurs possibles sont les constantes BitmapDataChannel :
BitmapDataChannel.ALPHA
BitmapDataChannel.BLUE
BitmapDataChannel.GREEN
BitmapDataChannel.RED
La valeur par défaut est 0, meaning no channel..
Implémentation
public function get componentY():uint
public function set componentY(value:uint):void
mapBitmap | propriété |
mapBitmap:BitmapData
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Objet BitmapData contenant les données de mappage du déplacement.
La valeur par défaut est null.
Implémentation
public function get mapBitmap():BitmapData
public function set mapBitmap(value:BitmapData):void
mapPoint | propriété |
mapPoint:Point
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Valeur contenant le décalage du coin supérieur gauche de l’objet d’affichage cible par rapport au coin supérieur gauche de l’image de mappage.
La valeur par défaut est null.
Implémentation
public function get mapPoint():Point
public function set mapPoint(value:Point):void
mode | propriété |
mode:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Mode du filtre. Les valeurs possibles sont les constantes DisplacementMapFilterMode :
DisplacementMapFilterMode.WRAP
— Ramène la valeur de déplacement à l’autre côté de l’image source.DisplacementMapFilterMode.CLAMP
— Corrige la valeur de déplacement en fonction du bord de l’image source.DisplacementMapFilterMode.IGNORE
— Si la valeur de déplacement est hors limites, ignore le déplacement et utilise le pixel source.DisplacementMapFilterMode.COLOR
— Si la valeur de déplacement est en dehors de l’image, remplace les valeurs des propriétés color et alpha.
La valeur par défaut est DisplacementMapFilterMode.WRAP.
Implémentation
public function get mode():String
public function set mode(value:String):void
scaleX | propriété |
scaleX:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Multiplicateur à utiliser pour redimensionner le résultat du déplacement x à partir du calcul de mappage.
La valeur par défaut est 0.
Implémentation
public function get scaleX():Number
public function set scaleX(value:Number):void
scaleY | propriété |
scaleY:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Multiplicateur à utiliser pour redimensionner le résultat du déplacement y à partir du calcul de mappage.
La valeur par défaut est 0.
Implémentation
public function get scaleY():Number
public function set scaleY(value:Number):void
DisplacementMapFilter | () | Constructeur |
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)
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur.
ParamètresmapBitmap:BitmapData (default = null ) — Objet BitmapData contenant les données de mappage du déplacement.
| |
mapPoint:Point (default = null ) — Valeur contenant le décalage du coin supérieur gauche de l’objet d’affichage cible par rapport au coin supérieur gauche de l’image de mappage.
| |
componentX:uint (default = 0 ) — Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat x. Les valeurs possibles sont les constantes BitmapDataChannel.
| |
componentY:uint (default = 0 ) — Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat y. Les valeurs possibles sont les constantes BitmapDataChannel.
| |
scaleX:Number (default = 0.0 ) — Multiplicateur à utiliser pour redimensionner le résultat du déplacement x à partir du calcul de mappage.
| |
scaleY:Number (default = 0.0 ) — Multiplicateur à utiliser pour redimensionner le résultat du déplacement y à partir du calcul de mappage.
| |
mode:String (default = "wrap ") — Mode du filtre. Les valeurs possibles sont les constantes DisplacementMapFilterMode.
| |
color:uint (default = 0 ) — Spécifie la couleur à utiliser pour les déplacements en dehors des limites. La plage valide est comprise entre 0.0 et 1.0. Utilisez ce paramètre si la propriété mode est réglée sur DisplacementMapFilterMode.COLOR .
| |
alpha:Number (default = 0.0 ) — Spécifie la valeur alpha à utiliser pour les déplacements en dehors des limites. Elle est spécifiée en tant que valeur normalisée comprise entre 0,0 et 1,0. Par exemple, 0,25 définit une valeur de transparence de 25 %. Utilisez ce paramètre si la propriété mode est réglée sur DisplacementMapFilterMode.COLOR .
|
Eléments de l’API associés
clone | () | méthode |
public function clone():BitmapFilter
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie une copie de cet objet filtre.
Valeur renvoyéeBitmapFilter — Nouvelle occurrence de DisplacementMapFilter dont les propriétés sont toutes identiques à celles de l’occurrence d’origine.
|
Tue Jun 12 2018, 09:30 AM Z