MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 834 / 1378

834 ActionScript classes
Availability: ActionScript 1.0; Flash Player 6 - Additional parameters spreadMethod,
interpolationMethod, and focalPointRatio added in Flash Player 8.
Parameters
fillType :String
- Valid values are the string "
linear
" and the string "
radial
".
colors :Array
- An array of RGB hexadecimal color values you can use in the gradient; for
example; red is 0xFF0000, blue is 0x0000FF. You can specify up to 15 colors. For each color,
ensure to specify a corresponding value in the
alphas
and
ratios
parameters.
alphas :Array
- An array of alpha values for the corresponding colors in the
colors
array;
valid values are 0 to 100. If the value is less than 0, Flash uses 0. If the value is greater than
100, Flash uses 100.
ratios :Array
- An array of color distribution ratios; valid values are 0 to 255. This value
defines the percentage of the width where the color is sampled at 100%. Specify a value for
each value in the
colors
parameter.
For example, for a linear gradient that includes two colors, blue and green, the following
figure illustrates the placement of the colors in the gradient based on different values in the
ratios
array:
The values in the array must increase sequentially; for example,
[0, 63, 127, 190, 255]
.
matrix :Object
- A transformation matrix that can be in any one of three forms:
■
A matrix object (supported by Flash Player 8 and later only), as defined by the
flash.geom.Matrix class. The flash.geom.Matrix class includes a
createGradientBox()
method, which lets you conveniently set up the matrix for use with the
beginGradientFill()
method of MovieClip class. Macromedia recommends that you
use this form of matrix for Flash Player 8 and later.
The following example uses the
beginGradientFill()
method with a
matrix
parameter
of this type:
import flash.geom.*
this.createEmptyMovieClip("gradient_mc",
this.getNextHighestDepth());
ratios
Gradient
[0, 127]
[0, 255]
[127, 255]