Flash 8 Documentation

ActionScript 2.0 Language Reference > ActionScript classes > GradientBevelFilter (flash.filters.GradientBevelFilter)

GradientBevelFilter (flash.filters.GradientBevelFilter)


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

public class GradientBevelFilter
extends BitmapFilter

The GradientBevelFilter class lets you apply a gradient bevel effect to various objects in Flash. A gradient bevel is a beveled edge, enhanced with gradient color, on the outside, inside, or top of an object. Beveled edges make objects look three-dimensional.

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 apply filters to BitmapData 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

Property summary

Modifiers	Property	Description
	alphas`:Array`	An array of alpha transparency values for the corresponding colors in the `colors` array.
	angle`:Number`	The angle, in degrees.
	blurX`:Number`	The amount of horizontal blur.
	blurY`:Number`	The amount of vertical blur.
	colors`:Array`	An array of RGB hexadecimal color values to use in the gradient.
	distance`:Number`	The offset distance.
	knockout`:Boolean`	Specifies whether the object has a knockout effect.
	quality`:Number`	The number of times to apply the filter.
	ratios`:Array`	An array of color distribution ratios for the corresponding colors in the `colors` array.
	strength`:Number`	The strength of the imprint or spread.
	type`:String`	The placement of the bevel effect.

Properties inherited from class Object

constructor, __proto__, prototype, __resolve

Constructor summary

Signature	Description
GradientBevelFilter`([distance:Number], [angle:Number], [colors:Array], [alphas:Array], [ratios:Array], [blurX:Number], [blurY:Number], [strength:Number], [quality:Number], [type:String], [knockout:Boolean])`	Initializes the filter with the specified parameters.

Method summary

Modifiers	Signature	Description
	clone`() : GradientBevelFilter`	Returns a copy of this filter object.

Methods inherited from class BitmapFilter

clone

Methods inherited from class Object

addProperty, hasOwnProperty, isPropertyEnumerable, isPrototypeOf, registerClass, toString, unwatch, valueOf, watch

Version 8

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

Current page: http://livedocs.adobe.com/flash/8/main/00002248.html

GradientBevelFilter (flash.filters.GradientBevelFilter)

See also

Property summary

Constructor summary

Method summary