User Guide

500 Chapter 2: ActionScript Language Reference
If a matrixType property does not exist then the remaining parameters are all required; the
function fails if any of them are missing. This matrix scales, translates, rotates, and skews the
unit gradient, which is defined at (-1,-1) and (1,1).
• matrixType, x, y, w, h, r.
The properties indicate the following:
matrixType is the string "box", x is the horizontal
position relative to the registration point of the parent clip for the upper left corner of the
gradient,
y is the vertical position relative to the registration point of the parent clip for the
upper left corner of the gradient,
w is the width of the gradient, h is the height of the gradient,
and
r is the rotation in radians of the gradient.
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 = {matrixType:"box", x:100, y:100, w:200, h:200, r:(45/
180)*Math.PI};
beginGradientFill("linear", colors, alphas, ratios, matrix);
moveTo(100, 100);
lineTo(100, 300);
lineTo(300, 300);
lineTo(300, 100);
lineTo(100, 100);
endFill();
}
If a matrixType property exists then it must equal "box" and the remaining parameters are all
required. The function fails if any of these conditions are not met.