RectangularDropShadow

(Preview)

Package	mx.graphics
Class	public class RectangularDropShadow
Inheritance	RectangularDropShadow Object

Language Version:

ActionScript 3.0

Product Version:

Flex 3

Runtime Versions:

Flash Player 9, AIR 1.1

Drop shadows are typically created using the DropShadowFilter class. However, the DropShadowFilter, like all bitmap filters, can be computationally expensive. If the DropShadowFilter is applied to a DisplayObject, then the drop shadow is recalculated whenever the appearance of the object changes. If the DisplayObject is animated (using a Resize effect, for example), then the presence of drop shadows hurts the animation refresh rate.

This class optimizes drop shadows for a common case. If you are applying a drop shadow to a rectangularly-shaped object whose edges fall on pixel boundaries, then this class should be used instead of using the DropShadowFilter directly.

This class accepts the first four parameters that are passed to DropShadowFilter: alpha, angle, color, and distance. In addition, this class accepts the corner radii for each of the four corners of the rectangularly-shaped object that is casting a shadow.

Once those 8 values have been set, this class pre-computes the drop shadow in an offscreen Bitmap. When the drawShadow() method is called, pieces of the precomputed drop shadow are copied onto the passed-in Graphics object.

Related API Elements

flash.filters.DropShadowFilter
flash.display.DisplayObject

Public Properties

Hide Inherited Public Properties

Show Inherited Public Properties

	Property		Defined By
		alpha : Number The alpha transparency value for the shadow color.	RectangularDropShadow
		angle : Number The angle of the shadow.	RectangularDropShadow
		blRadius : Number The corner radius of the bottom left corner of the rounded rectangle that is casting the shadow.	RectangularDropShadow
		blurX : Number The amount of horizontal blur.	RectangularDropShadow
		blurY : Number The amount of vertical blur.	RectangularDropShadow
		brRadius : Number The corner radius of the bottom right corner of the rounded rectangle that is casting the shadow.	RectangularDropShadow
		color : int The color of the shadow.	RectangularDropShadow
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		distance : Number The offset distance for the shadow, in pixels.	RectangularDropShadow
		tlRadius : Number The corner radius of the top left corner of the rounded rectangle that is casting the shadow.	RectangularDropShadow
		trRadius : Number The corner radius of the top right corner of the rounded rectangle that is casting the shadow.	RectangularDropShadow

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		RectangularDropShadow() Constructor.	RectangularDropShadow
		drawShadow(g:Graphics, x:Number, y:Number, width:Number, height:Number):void Renders the shadow on the screen.	RectangularDropShadow
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		valueOf():Object Returns the primitive value of the specified object.	Object

Property Detail

Constructor Detail

Method Detail

[an error occurred while processing this directive]

Legal Notices | Online Privacy Policy

	`g:Graphics` — The Graphics object on which to draw the shadow.

	`x:Number` — The horizontal offset of the drop shadow, based on the Graphics object's position.

	`y:Number` — The vertical offset of the drop shadow, based on the Graphics object's position.

	`width:Number` — The width of the shadow, in pixels.

	`height:Number` — The height of the shadow, in pixels.

RectangularDropShadow - AS3 Flex

Packagesx

Language Elements

Appendixes

Package mx.graphics

alpha

angle

blRadius

blurX

blurY

brRadius

color

distance

tlRadius

trRadius

drawShadow