Package | flash.geom |
Classe | public class ColorTransform |
Héritage | ColorTransform Object |
Sous-classes | Color |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Lorsqu’un objet ColorTransform est appliqué à un objet d’affichage, une nouvelle valeur est calculée de la manière suivante pour chaque canal de couleur :
- Nouvelle valeur de rouge = (ancienne valeur de rouge *
redMultiplier
) +redOffset
- Nouvelle valeur de vert = (ancienne valeur de vert *
greenMultiplier
) +greenOffset
- Nouvelle valeur de bleu = (ancienne valeur de bleu *
blueMultiplier
) +blueOffset
- Nouvelle valeur alpha = (ancienne valeur alpha *
alphaMultiplier
) +alphaOffset
Toute valeur de canal de couleur supérieure à 255 après le calcul est ramenée à 255. Si elle est inférieure à 0, elle est réglée sur 0.
Vous pouvez utiliser les objets ColorTransform comme suit :
- Dans le paramètre
colorTransform
de la méthodecolorTransform()
de la classe BitmapData. - En tant que propriété
colorTransform
d’un objet Transform (utilisable comme propriététransform
d’un objet d’affichage).
Vous devez utiliser le constructeur new ColorTransform()
pour créer un objet ColorTransform avant de pouvoir appeler les méthodes de l’objet ColorTransform.
Les transformations de couleurs ne s’appliquent pas à la couleur d’arrière-plan d’un clip (tel qu’un objet SWF chargé). Elles s’appliquent uniquement aux graphiques et symboles associés au clip.
Plus d’exemples
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
alphaMultiplier : Number
Valeur décimale multipliée par la valeur du canal de transparence alpha. | ColorTransform | ||
alphaOffset : Number
Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de transparence alpha après sa multiplication par la valeur alphaMultiplier. | ColorTransform | ||
blueMultiplier : Number
Valeur décimale multipliée par la valeur du canal de bleu. | ColorTransform | ||
blueOffset : Number
Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de bleu après sa multiplication par la valeur blueMultiplier. | ColorTransform | ||
color : uint
Valeur de couleur RVB d’un objet ColorTransform. | ColorTransform | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
greenMultiplier : Number
Valeur décimale multipliée par la valeur du canal de vert. | ColorTransform | ||
greenOffset : Number
Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de vert après sa multiplication par la valeur greenMultiplier. | ColorTransform | ||
redMultiplier : Number
Valeur décimale multipliée par la valeur du canal de rouge. | ColorTransform | ||
redOffset : Number
Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de rouge après sa multiplication par la valeur redMultiplier. | ColorTransform |
Méthode | Défini par | ||
---|---|---|---|
ColorTransform(redMultiplier:Number = 1.0, greenMultiplier:Number = 1.0, blueMultiplier:Number = 1.0, alphaMultiplier:Number = 1.0, redOffset:Number = 0, greenOffset:Number = 0, blueOffset:Number = 0, alphaOffset:Number = 0)
Crée un objet ColorTransform pour un objet d’affichage avec les paramètres RVB et alpha spécifiés. | ColorTransform | ||
Concatène l’objet ColorTranform, spécifié par le paramètre second, et l’objet ColorTransform actuel en définissant ce dernier comme résultat, ce qui se traduit par l’addition des deux transformations de couleur. | ColorTransform | ||
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 | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
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 | ||
Formate et renvoie une chaîne qui décrit l’ensemble des propriétés de l’objet ColorTransform. | ColorTransform | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
alphaMultiplier | propriété |
public var alphaMultiplier:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Valeur décimale multipliée par la valeur du canal de transparence alpha.
Définir directement la valeur de transparence alpha d’un objet d’affichage à l’aide de la propriété alpha
de l’occurrence de DisplayObject a une incidence sur la valeur de la propriété alphaMultiplier
de la propriété transform.colorTransform
de l’objet d’affichage.
Eléments de l’API associés
alphaOffset | propriété |
public var alphaOffset:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de transparence alpha après sa multiplication par la valeur alphaMultiplier
.
blueMultiplier | propriété |
public var blueMultiplier:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Valeur décimale multipliée par la valeur du canal de bleu.
blueOffset | propriété |
public var blueOffset:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de bleu après sa multiplication par la valeur blueMultiplier
.
color | propriété |
color:uint
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Valeur de couleur RVB d’un objet ColorTransform.
La définition de cette propriété entraîne la modification des trois valeurs de décalage de couleur (redOffset
, greenOffset
et blueOffset
) et le réglage sur zéro des trois valeurs de multiplicateur de couleur (redMultiplier
, greenMultiplier
et blueMultiplier
). Les valeurs de multiplicateur et de décalage de la transparence alpha ne changent pas.
Lorsque vous définissez la valeur de cette propriété, utilisez le format 0xRRGGBB. Les valeurs RR, GG et BB se composent chacune de deux chiffres hexadécimaux qui spécifient le décalage de chaque composant de couleur. La valeur 0x indique au compilateur ActionScript que le nombre est une valeur hexadécimale.
Implémentation
public function get color():uint
public function set color(value:uint):void
greenMultiplier | propriété |
public var greenMultiplier:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Valeur décimale multipliée par la valeur du canal de vert.
greenOffset | propriété |
public var greenOffset:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de vert après sa multiplication par la valeur greenMultiplier
.
redMultiplier | propriété |
public var redMultiplier:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Valeur décimale multipliée par la valeur du canal de rouge.
redOffset | propriété |
public var redOffset:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de rouge après sa multiplication par la valeur redMultiplier
.
ColorTransform | () | Constructeur |
public function ColorTransform(redMultiplier:Number = 1.0, greenMultiplier:Number = 1.0, blueMultiplier:Number = 1.0, alphaMultiplier:Number = 1.0, redOffset:Number = 0, greenOffset:Number = 0, blueOffset:Number = 0, alphaOffset:Number = 0)
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crée un objet ColorTransform pour un objet d’affichage avec les paramètres RVB et alpha spécifiés.
ParamètresredMultiplier:Number (default = 1.0 ) — Valeur du multiplicateur de rouge, comprise entre 0 et 1.
| |
greenMultiplier:Number (default = 1.0 ) — Valeur du multiplicateur de vert, comprise entre 0 et 1.
| |
blueMultiplier:Number (default = 1.0 ) — Valeur du multiplicateur de bleu, comprise entre 0 et 1.
| |
alphaMultiplier:Number (default = 1.0 ) — Valeur du multiplicateur de transparence alpha, comprise entre 0 et 1.
| |
redOffset:Number (default = 0 ) — Valeur du décalage appliqué au canal de couleur rouge, comprise entre -255 et 255.
| |
greenOffset:Number (default = 0 ) — Valeur du décalage appliqué au canal de couleur vert, comprise entre -255 et 255.
| |
blueOffset:Number (default = 0 ) — Valeur du décalage appliqué au canal de couleur bleu, comprise entre -255 et 255.
| |
alphaOffset:Number (default = 0 ) — Valeur du décalage appliqué au canal de transparence alpha, comprise entre -255 et 255.
|
concat | () | méthode |
public function concat(second:flash.geom:ColorTransform):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Concatène l’objet ColorTranform, spécifié par le paramètre second
, et l’objet ColorTransform actuel en définissant ce dernier comme résultat, ce qui se traduit par l’addition des deux transformations de couleur. L’application de l’objet ColorTransform concaténé revient à appliquer la second
transformation de couleur, puis la seconde (original).
Paramètres
second:flash.geom:ColorTransform — Objet ColorTransform devant être combiné à l’objet ColorTransform actuel.
|
toString | () | méthode |
public function toString():String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Formate et renvoie une chaîne qui décrit l’ensemble des propriétés de l’objet ColorTransform.
Valeur renvoyéeString — Chaîne répertoriant toutes les propriétés de l’objet ColorTransform.
|
- Le constructeur crée un nouvel objet Sprite
target
. - Le constructeur
CustomButton()
appelle la méthodedraw()
qui dessine un carré dégradé dans l’icône animée (sprite). - Le constructeur
CustomButton()
ajoute un écouteur d’événement clic pour le sprite ; il est géré par le biais de la méthodeclickHandler()
. - Dans la méthode
clickHandler()
, deux propriétés sont défnies sur les propriétésredOffset
etblueOffset
de la transformation de couleur actuelle. Chacune d’elles est réglée sur 25. La propriété de l’icône animée carréetransform.colorTransform
est ensuite modifiée pour utiliser les nouvelles valeurs de décalage. Chaque fois que l’utilisateur clique sur le carré, l’appel de la méthodeclickHandler()
modifie la couleur du carré en augmentant sa valeur de couleur rouge et en diminuant celle de couleur bleue.
package { import flash.display.Sprite; import flash.display.GradientType; import flash.geom.ColorTransform; import flash.events.MouseEvent; public class ColorTransformExample extends Sprite { public function ColorTransformExample() { var target:Sprite = new Sprite(); draw(target); addChild(target); target.useHandCursor = true; target.buttonMode = true; target.addEventListener(MouseEvent.CLICK, clickHandler) } public function draw(sprite:Sprite):void { var red:uint = 0xFF0000; var green:uint = 0x00FF00; var blue:uint = 0x0000FF; var size:Number = 100; sprite.graphics.beginGradientFill(GradientType.LINEAR, [red, blue, green], [1, 0.5, 1], [0, 200, 255]); sprite.graphics.drawRect(0, 0, 100, 100); } public function clickHandler(event:MouseEvent):void { var rOffset:Number = transform.colorTransform.redOffset + 25; var bOffset:Number = transform.colorTransform.redOffset - 25; this.transform.colorTransform = new ColorTransform(1, 1, 1, 1, rOffset, 0, bOffset, 0); } } }
Tue Jun 12 2018, 09:30 AM Z