Flash 8 Documentation

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

BevelFilter (flash.filters.BevelFilter)


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

public class BevelFilter
extends BitmapFilter

The BevelFilter class lets you add a bevel effect to a variety of objects in Flash. A bevel effect gives objects such as buttons a three-dimensional look. You can customize the look of the bevel with different highlight and shadow colors, the amount of blur on the bevel, the angle of the bevel, the placement of the bevel, and a knockout effect.

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 setting 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.

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, it does not support general scaling, rotation, and skewing. If the object itself is scaled (if _xscale and _yscale are not 100%), the filter is not scaled. It is scaled only when you zoom in on the Stage.

A filter is not applied if the resulting image exceeds 2880 pixels in width or height. If, for example, 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
	angle`:Number`	The angle of the bevel.
	blurX`:Number`	The amount of horizontal blur in pixels.
	blurY`:Number`	The amount of vertical blur in pixels.
	distance`:Number`	The offset distance of the bevel.
	highlightAlpha`:Number`	The alpha transparency value of the highlight color.
	highlightColor`:Number`	The highlight color of the bevel.
	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.
	shadowAlpha`:Number`	The alpha transparency value of the shadow color.
	shadowColor`:Number`	The shadow color of the bevel.
	strength`:Number`	The strength of the imprint or spread.
	type`:String`	The type of bevel.

Properties inherited from class Object

constructor, __proto__, prototype, __resolve

Constructor summary

Signature	Description
BevelFilter`([distance:Number], [angle:Number], [highlightColor:Number], [highlightAlpha:Number], [shadowColor:Number], [shadowAlpha:Number], [blurX:Number], [blurY:Number], [strength:Number], [quality:Number], [type:String], [knockout:Boolean])`	Initializes a new BevelFilter instance with the specified parameters.

Method summary

Modifiers	Signature	Description
	clone`() : BevelFilter`	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/00001927.html

BevelFilter (flash.filters.BevelFilter)

See also

Property summary

Constructor summary

Method summary