Pacchetto | flash.geom |
Classe | public class ColorTransform |
Ereditarietà | ColorTransform Object |
Sottoclassi | Color |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Quando si applica un oggetto ColorTransform a un oggetto di visualizzazione, viene calcolato un nuovo valore per ciascun canale di colore, nel modo seguente:
- Nuovo valore rosso = (valore rosso precedente *
redMultiplier
) +redOffset
- Nuovo valore verde = (valore verde precedente *
greenMultiplier
) +greenOffset
- Nuovo valore blu = (valore blu precedente *
blueMultiplier
) +blueOffset
- Nuovo valore alfa = (valore alfa precedente *
alphaMultiplier
) +alphaOffset
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.
Potete utilizzare gli oggetti ColorTransform nei modi seguenti:
- Nel parametro
colorTransform
del metodocolorTransform()
della classe BitmapData. - Come proprietà
colorTransform
di un oggetto Transform (che può essere utilizzata come la proprietàtransform
di un oggetto di visualizzazione).
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.
Altri esempi
Elementi API correlati
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 | ||
constructor : 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 | ||
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 |
Metodo | Definito 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 | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Formatta e restituisce una stringa che descrive tutte le proprietà dell'oggetto ColorTransform. | ColorTransform | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
alphaMultiplier | proprietà |
public var alphaMultiplier:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Elementi API correlati
alphaOffset | proprietà |
public var alphaOffset:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
.
blueMultiplier | proprietà |
public var blueMultiplier:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un valore decimale che viene moltiplicato per il valore del canale blu.
blueOffset | proprietà |
public var blueOffset:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un numero da -255 a 255 che viene aggiunto al valore del canale blu dopo che questo è stato moltiplicato per il valore blueMultiplier
.
color | proprietà |
color:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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à, utilizzate 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
greenMultiplier | proprietà |
public var greenMultiplier:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un valore decimale che viene moltiplicato per il valore del canale verde.
greenOffset | proprietà |
public var greenOffset:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un numero da -255 a 255 che viene aggiunto al valore del canale verde dopo che questo è stato moltiplicato per il valore greenMultiplier
.
redMultiplier | proprietà |
public var redMultiplier:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un valore decimale che viene moltiplicato per il valore del canale rosso.
redOffset | proprietà |
public var redOffset:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un numero da -255 a 255 che viene aggiunto al valore del canale rosso dopo che questo è stato moltiplicato per il valore redMultiplier
.
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 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un oggetto ColorTransform per un oggetto di visualizzazione con i valori dei canali di colore e alfa specificati.
ParametriredMultiplier: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.
|
concat | () | metodo |
public function concat(second:flash.geom:ColorTransform):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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:flash.geom:ColorTransform — L'oggetto ColorTransform che deve essere combinato con quello corrente.
|
toString | () | metodo |
public function toString():String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Formatta e restituisce una stringa che descrive tutte le proprietà dell'oggetto ColorTransform.
RestituisceString — Una stringa che elenca tutte le proprietà dell'oggetto ColorTransform.
|
- La funzione di costruzione crea un nuovo oggetto sprite
target
. - La funzione di costruzione
CustomButton()
chiama il metododraw()
, che disegna un quadrato con gradiente nello sprite. - La funzione di costruzione
CustomButton()
aggiunge un listener di eventi click per lo sprite, che viene gestito dal metodoclickHandler()
. - Nel metodo
clickHandler()
, due proprietà sono impostate sulle proprietàredOffset
eblueOffset
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 metodoclickHandler()
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); } } }
Tue Jun 12 2018, 02:44 PM Z