User Guide

DropShadowFilter (flash.filters.DropShadowFilter) 529

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 can be

undone 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 at authoring time. 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, general scaling, rotation, and skewing are not

supported. 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 in.

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