Flash CS3 Documentation 
ActionScript 2.0 Language Reference > ActionScript classes > DropShadowFilter (flash.filters.DropShadowFilter)

DropShadowFilter (flash.filters.DropShadowFilter)


Object
    |
    +-BitmapFilter
        |
        +-flash.filters.DropShadowFilter

public class DropShadowFilter
extends BitmapFilter

The DropShadowFilter class lets you add a drop shadow to a variety of objects in Flash. You have several options for the style of the drop shadow, including inner or outer shadow and knockout mode.

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

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

See also

filters (MovieClip.filters property), cacheAsBitmap (MovieClip.cacheAsBitmap property), filters (Button.filters property), cacheAsBitmap (Button.cacheAsBitmap property), filters (TextField.filters property), applyFilter (BitmapData.applyFilter method)

Property summary

Modifiers

Property

Description

 

alpha:Number

The alpha transparency value for the shadow color.

 

angle:Number

The angle of the shadow.

 

blurX:Number

The amount of horizontal blur.

 

blurY:Number

The amount of vertical blur.

 

color:Number

The color of the shadow.

 

distance:Number

The offset distance for the shadow, in pixels.

 

hideObject:Boolean

Indicates whether or not the object is hidden.

 

inner:Boolean

Indicates whether or not the shadow is an inner shadow.

 

knockout:Boolean

Applies a knockout effect (true), which effectively makes the object's fill transparent and reveals the background color of the document.

 

quality:Number

The number of times to apply the filter.

 

strength:Number

The strength of the imprint or spread.

Properties inherited from class Object

constructor (Object.constructor property), __proto__ (Object.__proto__ property), prototype (Object.prototype property), __resolve (Object.__resolve property)


Constructor summary

Signature

Description

DropShadowFilter([distance:Number], [angle:Number], [color:Number], [alpha:Number], [blurX:Number], [blurY:Number], [strength:Number], [quality:Number], [inner:Boolean], [knockout:Boolean], [hideObject:Boolean])

Creates a new DropShadowFilter instance with the specified parameters.

Method summary

Modifiers

Signature

Description

 

clone() : DropShadowFilter

Returns a copy of this filter object.

Methods inherited from class BitmapFilter

clone (BitmapFilter.clone method)


Methods inherited from class Object

addProperty (Object.addProperty method), hasOwnProperty (Object.hasOwnProperty method), isPropertyEnumerable (Object.isPropertyEnumerable method), isPrototypeOf (Object.isPrototypeOf method), registerClass (Object.registerClass method), toString (Object.toString method), unwatch (Object.unwatch method), valueOf (Object.valueOf method), watch (Object.watch method)


Flash CS3


 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/9.0/main/00001633.html