PackageTop Level
Classpublic class Color
InheritanceColor Inheritance Object
Deprecated since Flash Player 8 — The Color class has been deprecated in favor of the flash.geom.ColorTransform class.

Player version: Flash Player 5

The Color class lets you set the RGB color value and color transform of movie clips and retrieve those values once they have been set.

You must use the constructor new Color() to create a Color object before calling its methods.



Public Methods
 Method
  
Color(target:Object)
Deprecated. Creates a Color object for the movie clip specified by the target_mc parameter.
  
Deprecated. Returns the R+G+B combination currently in use by the color object.
  
Deprecated. Returns the transform value set by the last Color.setTransform() call.
  
setRGB(offset:Number):Void
Deprecated. Specifies an RGB color for a Color object.
  
setTransform(transformObject:Object):Void
Deprecated. Sets color transform information for a Color object.
 Methods inherited from class Object
 addProperty, hasOwnProperty, isPropertyEnumerable, isPrototypeOf, registerClass, toString, unwatch, valueOf, watch
Constructor detail
Color()constructor
public function Color(target:Object)

Player version: Flash Player 5

Deprecated. The Color class is deprecated since Flash Player 8.

Creates a Color object for the movie clip specified by the target_mc parameter. You can then use the methods of that Color object to change the color of the entire target movie clip.

Parameters
target:Object — The instance name of a movie clip.

Example
The following example creates a Color object called my_color for the movie clip my_mc and sets its RGB value to orange:
var my_color:Color = new Color(my_mc);
my_color.setRGB(0xff9933);

Method detail
getRGB()method
public function getRGB():NumberDeprecated. The Color class is deprecated since Flash Player 8.

Returns the R+G+B combination currently in use by the color object.

Player version: Flash Player 5

Returns
Number — A number that represents the RGB numeric value for the color specified.

See also


Example
The following code retrieves the RGB value for the Color object my_color, converts the value to a hexadecimal string, and assigns it to the myValue variable. To see this code work, add a movie clip instance to the Stage, and give it the instance name my_mc:
var my_color:Color = new Color(my_mc);
// set the color
my_color.setRGB(0xff9933);
var myValue:String = my_color.getRGB().toString(16);
// trace the color value
trace(myValue);  // traces ff9933

getTransform()method 
public function getTransform():ObjectDeprecated. The Color class is deprecated since Flash Player 8.

Returns the transform value set by the last Color.setTransform() call.

Player version: Flash Player 5

Returns
Object — An object whose properties contain the current offset and percentage values for the specified color.

See also


Example
The following example gets the transform object, and then sets new percentages for colors and alpha of my_mc relative to their current values. To see this code work, place a multicolored movie clip on the Stage with the instance name my_mc. Then place the following code on Frame 1 in the main Timeline and select Control > Test Movie:
var my_color:Color = new Color(my_mc);
var myTransform:Object = my_color.getTransform();
myTransform = { ra: 50, ba: 50, aa: 30};
my_color.setTransform(myTransform);

For descriptions of the parameters for a color transform object, see Color.setTransform().

setRGB()method 
public function setRGB(offset:Number):VoidDeprecated. The Color class is deprecated since Flash Player 8.

Specifies an RGB color for a Color object. Calling this method overrides any previous Color.setTransform() settings.

Player version: Flash Player 5

Parameters
offset:Number0xRRGGBB The hexadecimal or RGB color to be set. RR, GG, and BB each consist of two hexadecimal digits that specify the offset of each color component. The 0x tells the ActionScript compiler that the number is a hexadecimal value.

See also


Example
This example sets the RGB color value for the movie clip my_mc. To see this code work, place a movie clip on the Stage with the instance name my_mc. Then place the following code on Frame 1 in the main Timeline and select Control > Test Movie:
var my_color:Color = new Color(my_mc);
my_color.setRGB(0xFF0000); // my_mc turns red

setTransform()method 
public function setTransform(transformObject:Object):VoidDeprecated. The Color class is deprecated since Flash Player 8.

Sets color transform information for a Color object. The colorTransformObject parameter is a generic object that you create from the new Object constructor. It has parameters specifying the percentage and offset values for the red, green, blue, and alpha (transparency) components of a color, entered in the format 0xRRGGBBAA.

The parameters for a color transform object correspond to the settings in the Advanced Effect dialog box and are defined as follows:

You create a colorTransformObject parameter as follows:

var myColorTransform:Object = 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;

You can also use the following syntax to create a colorTransformObject parameter:

var myColorTransform:Object = { ra: 50, rb: 244, ga: 40, gb: 112, ba: 12, bb: 90, aa: 40, ab: 70}

Player version: Flash Player 5

Parameters
transformObject:Object — An object created with the new Object constructor. This instance of the Object class must have the following properties that specify color transform values: ra, rb, ga, gb, ba, bb, aa, ab. These properties are explained in the above summary for the setTransform() method.

See also


Example
This example creates a new Color object for a target SWF file, creates a generic object called myColorTransform with the properties defined above, and uses the setTransform() method to pass the colorTransformObject to a Color object. To use this code in a Flash (FLA) document, place it on Frame 1 on the main Timeline and place a movie clip on the Stage with the instance name my_mc, as in the following code:
// Create a color object called my_color for the target my_mc
var my_color:Color = new Color(my_mc);
// Create a color transform object called myColorTransform using
// Set the values for myColorTransform
var myColorTransform:Object = { ra: 50, rb: 244, ga: 40, gb: 112, ba: 12, bb: 90, aa: 40, ab: 70};
// Associate the color transform object with the Color object
// created for my_mc
my_color.setTransform(myColorTransform);