Color.setTransform

A-C > Color.setTransform

Color.setTransform

color.settransform, settransform, color

Availability

Flash Player 5.

Usage

myColor.setTransform(colorTransformObject);

Parameters

colorTransformObject An object created with the new Object constructor. This instance of the Object object must have the following properties that specify color transform values: ra, rb, ga, gb, ba, bb, aa, ab. These properties are explained below.

Returns

Nothing.

Description

Method; sets color transform information for an instance of the 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:

	`ra` is the percentage for the red component (-100 to 100).
	`rb` is the offset for the red component (-255 to 255).
	`ga` is the percentage for the green component (-100 to 100).
	`gb` is the offset for the green component (-255 to 255).
	`ba` is the percentage for the blue component (-100 to 100).
	`bb` is the offset for the blue component (-255 to 255).
	`aa` is the percentage for alpha (-100 to 100).
	`ab` is the offset for alpha (-255 to 255).

You create a colorTransformObject parameter as follows:

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;

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

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

Example

This example creates a new instance of the Color object for a target movie, 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 myMovie, as in the following code:

// Create a color object called myColor for the target myMovie
myColor = new Color(myMovie);
// Create a color transform object called myColorTransfrom using
// the generic Object object
myColorTransform = new Object();
// Set the values for myColorTransform
myColorTransform = { 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 myMovie
myColor.setTransform(myColorTransform);