User Guide

632 ActionScript classes

The GradientGlowFilter class lets you apply a gradient glow effect to a variety of objects in

Flash. A gradient glow is a realistic-looking glow with a color gradient that you can control.

You can apply a gradient glow around the inner or outer edge of an object or on top of an

object.

The use of filters depends on the object to which you apply the filter:

■ To apply filters to movie clips, text fields, and buttons at runtime, use the filters

property. Setting the

filters property of an object does not modify the object, and you

can undo the filter by clearing the

filters property.

■ To a pp ly f ilt ers to Bit map Data instances, use the BitmapData.applyFilter() method.

Calling

applyFilter() on a BitmapData object takes the source BitmapData object and

the filter object and generates a filtered image as a result.

You can also apply filter effects to images and video during authoring. For more information,

see your authoring documentation.

If you apply a filter to a movie clip or button, the

cacheAsBitmap property of the movie clip

or button is set to

true. If you clear all filters, the original value of cacheAsBitmap is

restored.

This filter supports Stage scaling. However, it does not support general scaling, rotation, and

skewing; if the object itself is scaled (if

_xscale and _yscale are not 100%), the filter effect

is not scaled. It is scaled only when the Stage is zoomed.

A filter is not applied if the resulting image exceeds 2880 pixels in width or height. For

example, if you zoom in on a large movie clip with a filter applied, the filter is turned off if the

resulting image exceeds the limit of 2880 pixels.

Availability: ActionScript 1.0; Flash Player 8