User Guide

MovieClip.setMask() 615
Description
Property; the rotation of the movie clip, in degrees, from its original orientation. Values from
0 to 180 represent clockwise rotation; values from 0 to -180 represent counterclockwise rotation.
Values outside this range are added to or subtracted from 360 to obtain a value within the range.
For example, the statement
my_mc._rotation = 450 is the same as my_mc._rotation = 90.
Example
The following example creates a movie clip instance dynamically, rotates, and loads an image into
the instance.
this.createEmptyMovieClip("image_mc", 1);
image_mc._rotation = 15;
image_mc.loadMovie("http://www.macromedia.com/devnet/mx/blueprint/articles/
nielsen/spotlight_jnielsen.jpg");
See also
TextField._rotation
MovieClip.setMask()
Availability
Flash Player 6.
Usage
my_mc.setMask(mask_mc:Object) : Void
Parameters
my_mc
The instance name of a movie clip to be masked.
mask_mc The instance name of a movie clip to be a mask.
Returns
Nothing.
Description
Method; makes the movie clip in the parameter mask_mc a mask that reveals the movie clip
specified by the
my_mc parameter.
This method allows multiple-frame movie clips with complex, multilayered content to act as
masks. You can shut masks on and off at runtime. However, you can’t use the same mask for
multiple masks (which is possible by using mask layers). If you have device fonts in a masked
movie clip, they are drawn but not masked. You can’t set a movie clip to be its own mask—for
example,
my_mc.setMask(my_mc).
If you create a mask layer that contains a movie clip, and then apply the
setMask() method to it,
the
setMask() call takes priority and this is not reversible. For example, you could have a movie
clip in a mask layer called
UIMask that masks another layer containing another movie clip called
UIMaskee. If, as the SWF file plays, you call UIMask.setMask(UIMaskee), from that point on,
UIMask is masked by UIMaskee.