Packageflash.geom
Classepublic class ColorTransform
HéritageColorTransform Inheritance Object
Sous-classes Color

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

La classe ColorTransform vous permet de régler les valeurs de couleur d’un objet d’affichage. Le réglage des couleurs ou transformation de couleur peut être appliqué aux quatre canaux : rouge, vert, bleu et transparence alpha.

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 :

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 :

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.

Consulter les exemples

Voir aussi

flash.geom.Transform
flash.display.DisplayObject.transform
flash.display.BitmapData.colorTransform()


Propriétés publiques
 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
 Inheritedconstructor : 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
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  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éthodes publiques
 MéthodeDé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
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
  
Formate et renvoie une chaîne qui décrit l’ensemble des propriétés de l’objet ColorTransform.
ColorTransform
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails des propriétés
alphaMultiplierpropriété
public var alphaMultiplier:Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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.

Voir aussi

alphaOffsetpropriété 
public var alphaOffset:Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de transparence alpha après sa multiplication par la valeur alphaMultiplier.

blueMultiplierpropriété 
public var blueMultiplier:Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Valeur décimale multipliée par la valeur du canal de bleu.

blueOffsetpropriété 
public var blueOffset:Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de bleu après sa multiplication par la valeur blueMultiplier.

colorpropriété 
color:uint  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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
greenMultiplierpropriété 
public var greenMultiplier:Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Valeur décimale multipliée par la valeur du canal de vert.

greenOffsetpropriété 
public var greenOffset:Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de vert après sa multiplication par la valeur greenMultiplier.

redMultiplierpropriété 
public var redMultiplier:Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Valeur décimale multipliée par la valeur du canal de rouge.

redOffsetpropriété 
public var redOffset:Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Nombre, compris entre -255 et 255, qui est ajouté à la valeur du canal de rouge après sa multiplication par la valeur redMultiplier.

Détails du constructeur
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
Version du lecteur : Flash Player 9

Crée un objet ColorTransform pour un objet d’affichage avec les paramètres RVB et alpha spécifiés.

Paramètres
redMultiplier: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.
Détails des méthodes
concat()méthode
public function concat(second:ColorTransform):void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

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:ColorTransform — Objet ColorTransform devant être combiné à l'objet ColorTransform actuel.

toString()méthode 
public function toString():String

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Formate et renvoie une chaîne qui décrit l’ensemble des propriétés de l’objet ColorTransform.

Valeur renvoyée
String — Chaîne répertoriant toutes les propriétés de l'objet ColorTransform.
Exemples Utilisation des exemples
ColorTransformExample.as

L'exemple suivant utilise la classe TransformExample pour créer une icône animée (sprite) simple, de forme carrée et dont le remplissage est dégradé. Chaque fois que l'utilisateur clique sur le carré, l'application transforme les couleurs de l'icône animée par un ajout sur le canal de la couleur rouge et un éclaircissement sur le canal de la couleur bleue. Cette opération se déroule selon la procédure suivante :
  1. Le constructeur crée un nouvel objet Sprite target.
  2. Le constructeur CustomButton() appelle la méthode draw() qui dessine un carré dégradé dans l'icône animée (sprite).
  3. Le constructeur CustomButton() ajoute un écouteur d'événements clic pour le sprite ; il est géré par le biais de la méthode clickHandler().
  4. Dans la méthode clickHandler(), deux propriétés sont défnies sur les propriétés redOffset et blueOffset 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ée transform.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éthode clickHandler() 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);
        }
    }
}    




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/geom/ColorTransform.html