User Guide

MovieClip.beginGradientFill() 499
MovieClip.beginGradientFill()
Availability
Flash Player 6.
Usage
my_mc.beginGradientFill(fillType:String, colors:Array, alphas:Array,
ratios:Array, matrix:Object) : Void
Parameter
fillType
Either the string "linear" or the string "radial".
colors An array of RGB hex color values to be used in the gradient (for example, red is
0xFF0000, blue is 0x0000FF, and so on).
alphas An array of alpha values for the corresponding colors in the colors array; valid values
are 0–100. If the value is less than 0, Flash uses 0. If the value is greater than 100, Flash uses 100.
ratios An array of color distribution ratios; valid values are 0–255. This value defines the
percentage of the width where the color is sampled at 100 percent.
matrix A transformation matrix that is an object with either of the following two sets of
properties.
• a, b, c, d, e, f, g, h, i, which can be used to describe a 3 x 3 matrix of the following form:
a b c
d e f
g h i
The following example uses a beginGradientFill() method with a matrix parameter that is
an object with these properties.
this.createEmptyMovieClip("gradient_mc", 1);
with (gradient_mc) {
colors = [0xFF0000, 0x0000FF];
alphas = [100, 100];
ratios = [0, 0xFF];
matrix = {a:200, b:0, c:0, d:0, e:200, f:0, g:200, h:200, i:1};
beginGradientFill("linear", colors, alphas, ratios, matrix);
moveTo(100, 100);
lineTo(100, 300);
lineTo(300, 300);
lineTo(300, 100);
lineTo(100, 100);
endFill();
}