Color.setTransform()
Disponibilità
Flash Player 5.
Uso
my_color.setTransform(colorTransformObject)
Parametri
colorTransformObject Un oggetto creato con la funzione di creazione new Object. Questa istanza di Object (classe) deve disporre delle seguenti proprietà che consentono di specificare i valori di trasformazione colore: ra, rb, ga, gb, ba, bb, aa, ab. Tali proprietà vengono descritte di seguito.
Valori restituiti
Nessuno.
Descrizione
Metodo: imposta la trasformazione dei colori per un oggetto Color. Il parametro colorTransformObject si riferisce a un oggetto generico creato mediante la funzione di creazione new Object. Dispone di parametri che specificano la percentuale e i valori di offset dei componenti rosso, verde, blu e alpha (trasparenza) di un colore, immessa nel formato 0xRRGGBBAA.
I parametri per un oggetto di trasformazione del colore corrispondono alle impostazioni visualizzate nella finestra di dialogo Effetto avanzato e sono definite come indicato di seguito:
ra è la percentuale del componente rosso (da -100 a 100).
rb è l'offset del componente rosso (da -255 a 255).
ga è la percentuale del componente verde (da -100 a 100).
gb è l'offset del componente verde (da -255 a 255).
ba è la percentuale del componente blu (da -100 a 100).
bb è l'offset del componente blu (da -255 a 255).
aa è la percentuale di alfa (da -100 a 100).
ab è l'offset di alfa (da -255 a 255).
Per creare un parametro colorTransformObject, attenersi alla procedura indicata di seguito:
myColorTransform = new Object();
myColorTransform.ra = 50;
myColorTransform.rb = 244;
myColorTransform.ga = 40;
myColorTransform.gb = 112;
myColorTransform.ba = 12;
myColorTransform.bb = 90;
myColorTransform.aa = 40;
myColorTransform.ab = 70;
È inoltre possibile usare la seguente sintassi per creare un parametro colorTransformObject:
myColorTransform = { ra: ‘50', rb: ‘244', ga: ‘40', gb: ‘112', ba: ‘12', bb: ‘90', aa: ‘40', ab: ‘70'}
Esempio
Nell'esempio seguente, viene creato un nuovo oggetto Color per un file SWF di destinazione e un oggetto generico, chiamato myColorTransform, avente le proprietà definite in precedenza. Si utilizza il metodo setTransform() per passare colorTransformObject a un oggetto Color. Per utilizzare questo codice in un documento Flash (FLA), posizionarlo sul fotogramma 1 della linea temporale principale e posizionare il clip filmato sullo stage con il nome istanza my_mc, come riportato nel codice seguente:
// Crea un oggetto Color denominato my_color per my_mc target
my_color = new Color(my_mc);
// Crea un oggetto di trasformazione del colore chiamato myColorTransform usando
// l'oggetto Object generico
myColorTransform = new Object();
// Imposta i valori per myColorTransform
myColorTransform = { ra: ‘50', rb: ‘244', ga: ‘40', gb: ‘112', ba: ‘12', bb: ‘90', aa: ‘40', ab: ‘70'};
// Associa l'oggetto di trasformazione del colore all'oggetto Color
// creato per my_mc
my_color.setTransform(myColorTransform);