MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE, Reference

Page: 501 / 1104

MovieClip.beginGradientFill() 501
Returns
Nothing.
Description
Method; indicates the beginning of a new drawing path. If the first parameter is
undefined,
or if
no parameters are passed, the path has no fill. If an open path exists (that is if the current drawing
position does not equal the previous position specified in a
MovieClip.moveTo()
method), and
it has a fill associated with it, that path is closed with a line and then filled. This is similar to what
happens when you call
MovieClip.endFill()
.
This method fails if any of the following conditions exist:
•
The number of items in the
colors
,
alphas
, and
ratios
parameters are not equal.
•
The
fillType
parameter is not
"linear"
or
"radial"
.
•
Any of the fields in the object for the
matrix
parameter are missing or invalid.
You can extend the methods and event handlers of the MovieClip class by creating a subclass. For
more information, see “Assigning a class to a movie clip symbol” in
Using ActionScript in Flash .
Example
The following code uses both methods to draw two stacked rectangles with a red-blue gradient fill
and a 5-pixel solid lime green stroke:
this.createEmptyMovieClip("gradient_mc", 1);
with (gradient_mc) {
colors = [0xFF0000, 0x0000FF];
alphas = [100, 100];
ratios = [0, 0xFF];
lineStyle(5, 0x00ff00);
matrix = {a:500, b:0, c:0, d:0, e:200, f:0, g:350, h:200, i:1};
beginGradientFill("linear", colors, alphas, ratios, matrix);
moveTo(100, 100);
lineTo(100, 300);
lineTo(600, 300);
lineTo(600, 100);
lineTo(100, 100);
endFill();
matrix = {matrixType:"box", x:100, y:310, w:500, h:200, r:(0/180)*Math.PI};
beginGradientFill("linear", colors, alphas, ratios, matrix);
moveTo(100, 310);
lineTo(100, 510);
lineTo(600, 510);
lineTo(600, 310);
lineTo(100, 310);