Pacchettoflash.geom
Classepublic class ColorTransform
EreditarietàColorTransform Inheritance Object
Sottoclassi Color

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe ColorTransform consente di rettificare i valori di colore di un oggetto di visualizzazione. La rettifica del colore o trasformazione del colore può essere applicata a tutti e quattro i canali: rosso, verde, blu e trasparenza alfa.

Quando si applica un oggetto ColorTransform a un oggetto di visualizzazione, viene calcolato un nuovo valore per ciascun canale di colore, nel modo seguente:

I valori dei canali di colore che dopo il calcolo risultano maggiori di 255 vengono impostati su 255. I valori inferiori a 0 vengono impostati su 0.

Gli oggetti ColorTransform si possono utilizzare nei modi seguenti:

Per poter chiamare i metodi dell'oggetto ColorTransform, è necessario prima utilizzare la funzione di costruzione new ColorTransform() per creare un oggetto ColorTransform.

Le trasformazioni del colore non si applicano al colore di sfondo di un clip filmato (ad esempio, un oggetto SWF caricato), ma solo agli elementi grafici e ai simboli associati al clip filmato.

Vedere gli esempi

Vedere anche

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


Proprietà pubbliche
 ProprietàDefinito da
  alphaMultiplier: Number
Un valore decimale che viene moltiplicato per il valore del canale di trasparenza alfa.
ColorTransform
  alphaOffset: Number
Un numero da -255 a 255 che viene aggiunto al valore del canale di trasparenza alfa dopo che questo è stato moltiplicato per il valore alphaMultiplier.
ColorTransform
  blueMultiplier: Number
Un valore decimale che viene moltiplicato per il valore del canale blu.
ColorTransform
  blueOffset: Number
Un numero da -255 a 255 che viene aggiunto al valore del canale blu dopo che questo è stato moltiplicato per il valore blueMultiplier.
ColorTransform
  color: uint
Il valore di colore RGB per un oggetto ColorTransform.
ColorTransform
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  greenMultiplier: Number
Un valore decimale che viene moltiplicato per il valore del canale verde.
ColorTransform
  greenOffset: Number
Un numero da -255 a 255 che viene aggiunto al valore del canale verde dopo che questo è stato moltiplicato per il valore greenMultiplier.
ColorTransform
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  redMultiplier: Number
Un valore decimale che viene moltiplicato per il valore del canale rosso.
ColorTransform
  redOffset: Number
Un numero da -255 a 255 che viene aggiunto al valore del canale rosso dopo che questo è stato moltiplicato per il valore redMultiplier.
ColorTransform
Metodi pubblici
 MetodoDefinito da
  
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)
Crea un oggetto ColorTransform per un oggetto di visualizzazione con i valori dei canali di colore e alfa specificati.
ColorTransform
  
Concatena l'oggetto ColorTransform specificato dal parametro second con l'oggetto ColorTransform corrente e imposta l'oggetto corrente come risultato, eseguendo una combinazione additiva delle due trasformazioni di colore.
ColorTransform
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
Formatta e restituisce una stringa che descrive tutte le proprietà dell'oggetto ColorTransform.
ColorTransform
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà
alphaMultiplierproprietà
public var alphaMultiplier:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un valore decimale che viene moltiplicato per il valore del canale di trasparenza alfa.

Se si imposta direttamente il valore della trasparenza alfa di un oggetto di visualizzazione mediante la proprietà alpha dell'istanza DisplayObject, viene modificato il valore della proprietà alphaMultiplier della proprietà transform.colorTransform di quell'oggetto di visualizzazione.

Vedere anche

alphaOffsetproprietà 
public var alphaOffset:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un numero da -255 a 255 che viene aggiunto al valore del canale trasparenza di alfa dopo che questo è stato moltiplicato per il valore alphaMultiplier.

blueMultiplierproprietà 
public var blueMultiplier:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un valore decimale che viene moltiplicato per il valore del canale blu.

blueOffsetproprietà 
public var blueOffset:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un numero da -255 a 255 che viene aggiunto al valore del canale blu dopo che questo è stato moltiplicato per il valore blueMultiplier.

colorproprietà 
color:uint  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il valore di colore RGB per un oggetto ColorTransform.

Quando viene impostata, questa proprietà modifica di conseguenza i tre valori di offset del colore (redOffset, greenOffset e blueOffset) e imposta i tre valori dei moltiplicatori (redMultiplier, greenMultiplier e blueMultiplier) su 0. I valori del moltiplicatore e dell'offset della trasparenza alfa restano invariati.

Quando si passa un valore per questa proprietà, utilizzare il formato 0x RRGGBB. RR, GG e BB sono composti da due cifre esadecimali che specificano l'offset di ciascun componente di colore. 0x indica al compilatore ActionScript che il numero è un valore esadecimale.


Implementazione
    public function get color():uint
    public function set color(value:uint):void
greenMultiplierproprietà 
public var greenMultiplier:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un valore decimale che viene moltiplicato per il valore del canale verde.

greenOffsetproprietà 
public var greenOffset:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un numero da -255 a 255 che viene aggiunto al valore del canale verde dopo che questo è stato moltiplicato per il valore greenMultiplier.

redMultiplierproprietà 
public var redMultiplier:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un valore decimale che viene moltiplicato per il valore del canale rosso.

redOffsetproprietà 
public var redOffset:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un numero da -255 a 255 che viene aggiunto al valore del canale rosso dopo che questo è stato moltiplicato per il valore redMultiplier.

Descrizione della funzione di costruzione
ColorTransform()Funzione di costruzione
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)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un oggetto ColorTransform per un oggetto di visualizzazione con i valori dei canali di colore e alfa specificati.

Parametri
redMultiplier:Number (default = 1.0) — Il valore del moltiplicatore del canale rosso, compreso nell'intervallo 0-1.
 
greenMultiplier:Number (default = 1.0) — Il valore del moltiplicatore del canale verde, compreso nell'intervallo 0-1.
 
blueMultiplier:Number (default = 1.0) — Il valore del moltiplicatore del canale blu, compreso nell'intervallo 0-1.
 
alphaMultiplier:Number (default = 1.0) — Il valore del moltiplicatore della trasparenza alfa, compreso nell'intervallo 0-1.
 
redOffset:Number (default = 0) — Il valore di offset del canale rosso, compreso nell'intervallo da -255 a 255.
 
greenOffset:Number (default = 0) — Il valore di offset del canale verde, compreso nell'intervallo da -255 a 255.
 
blueOffset:Number (default = 0) — Il valore di offset del canale blu, compreso nell'intervallo da -255 a 255.
 
alphaOffset:Number (default = 0) — Il valore di offset del canale della trasparenza alfa, compreso nell'intervallo da -255 a 255.
Descrizione dei metodi
concat()metodo
public function concat(second:ColorTransform):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Concatena l'oggetto ColorTransform specificato dal parametro second con l'oggetto ColorTransform corrente e imposta l'oggetto corrente come risultato, eseguendo una combinazione additiva delle due trasformazioni di colore. Quando si applica l'oggetto ColorTransform concatenato, l'effetto è analogo all'applicazione della trasformazione di colore second dopo la trasformazione di colore originale.

Parametri

second:ColorTransform — L'oggetto ColorTransform che deve essere combinato con quello corrente.

toString()metodo 
public function toString():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Formatta e restituisce una stringa che descrive tutte le proprietà dell'oggetto ColorTransform.

Restituisce
String — Una stringa che elenca tutte le proprietà dell'oggetto ColorTransform.
Esempi Come utilizzare gli esempi
ColorTransformExample.as

Nell'esempio seguente viene utilizzata la classe TransformExample per creare un semplice sprite di forma quadrata con un riempimento con gradiente. Ogni volta che l'utente fa clic sul quadrato, l'applicazione trasforma i colori dello sprite quadrato, aumentando l'intensità del canale rosso e schiarendo il canale blu. Questa operazione viene eseguita mediante la procedura seguente:
  1. La funzione di costruzione crea un nuovo oggetto sprite target.
  2. La funzione di costruzione CustomButton() chiama il metodo draw(), che disegna un quadrato con gradiente nello sprite.
  3. La funzione di costruzione CustomButton() aggiunge un listener di eventi click per lo sprite, che viene gestito dal metodo clickHandler().
  4. Nel metodo clickHandler(), due proprietà sono impostate sulle proprietàredOffset e blueOffset della trasformazione di colore corrente. Ognuna viene rettificata di 25. La proprietà transform.colorTransform dello sprite quadrato viene quindi modificata in modo che utilizzi i nuovi valori di offset. Ogni volta che l'utente fa clic sul quadrato, la chiamata al metodo clickHandler() modifica il colore del quadrato aumentando il valore rosso e diminuendo il valore blu.
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);
        }
    }
}    




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/geom/ColorTransform.html