Packagecom.gestureworks.cml.filters
Classpublic class Glow
InheritanceGlow Inheritance Object

The Glow class lets you apply a glow effect to display objects. You have several options for the style of the glow, including inner or outer glow and knockout mode. The glow filter is similar to the drop shadow filter with the distance and angle properties of the drop shadow filter set to 0. You can apply the filter to any display object (that is, objects that inherit from the DisplayObject class), such as MovieClip, SimpleButton, TextField, and Video objects, as well as to BitmapData objects.

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

If you apply a filter to a display object, the cacheAsBitmap property of the display object 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 scaleX and scaleY are set to a value other than 1.0), the filter is not scaled. It is scaled only when the user zooms in on the Stage.

A filter is not applied if the resulting image exceeds the maximum dimensions. In AIR 1.5 and Flash Player 10, the maximum is 8,191 pixels in width or height, and the total number of pixels cannot exceed 16,777,215 pixels. (So, if an image is 8,191 pixels wide, it can only be 2,048 pixels high.) In Flash Player 9 and earlier and AIR 1.1 and earlier, the limitation is 2,880 pixels in height and 2,880 pixels in width. 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 maximum dimensions.


Public Properties
 PropertyDefined By
  _alpha : Number = 1
Glow
  alpha : Number
The alpha transparency value for the color.
Glow
  blurX : Number
The amount of horizontal blur.
Glow
  blurY : Number
The amount of vertical blur.
Glow
  color : uint
The color of the glow.
Glow
  inner : Boolean
Specifies whether the glow is an inner glow.
Glow
  knockout : Boolean
Specifies whether the object has a knockout effect.
Glow
  quality : int
The number of times to apply the filter.
Glow
  strength : Number
The strength of the imprint or spread.
Glow
Public Methods
 MethodDefined By
  
Glow(color:uint = 16711680, alpha:Number = 1, blurX:Number = 6, blurY:Number = 6, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Initializes a new Glow instance with the specified parameters.
Glow
  
getFilter():GlowFilter
Returns new glow filter
Glow
Property Detail
_alphaproperty
public var _alpha:Number = 1

alphaproperty 
alpha:Number

The alpha transparency value for the color. Valid values are 0 to 1. For example, .25 sets a transparency value of 25%. The default value is 1.


Implementation
    public function get alpha():Number
    public function set alpha(value:Number):void
blurXproperty 
blurX:Number

The amount of horizontal blur. Valid values are 0 to 255 (floating point). The default value is 6. Values that are a power of 2 (such as 2, 4, 8, 16, and 32) are optimized to render more quickly than other values.


Implementation
    public function get blurX():Number
    public function set blurX(value:Number):void
blurYproperty 
blurY:Number

The amount of vertical blur. Valid values are 0 to 255 (floating point). The default value is 6. Values that are a power of 2 (such as 2, 4, 8, 16, and 32) are optimized to render more quickly than other values.


Implementation
    public function get blurY():Number
    public function set blurY(value:Number):void
colorproperty 
color:uint

The color of the glow. Valid values are in the hexadecimal format 0xRRGGBB. The default value is 0xFF0000.


Implementation
    public function get color():uint
    public function set color(value:uint):void
innerproperty 
inner:Boolean

Specifies whether the glow is an inner glow. The value true indicates an inner glow. The default is false, an outer glow (a glow around the outer edges of the object).


Implementation
    public function get inner():Boolean
    public function set inner(value:Boolean):void
knockoutproperty 
knockout:Boolean

Specifies whether the object has a knockout effect. A value of true makes the object's fill transparent and reveals the background color of the document. The default value is false (no knockout effect).


Implementation
    public function get knockout():Boolean
    public function set knockout(value:Boolean):void
qualityproperty 
quality:int

The number of times to apply the filter. The default value is BitmapFilterQuality.LOW, which is equivalent to applying the filter once. The value BitmapFilterQuality.MEDIUM applies the filter twice; the value BitmapFilterQuality.HIGH applies it three times. Filters with lower values are rendered more quickly. For most applications, a quality value of low, medium, or high is sufficient. Although you can use additional numeric values up to 15 to achieve different effects, higher values are rendered more slowly. Instead of increasing the value of quality, you can often get a similar effect, and with faster rendering, by simply increasing the values of the blurX and blurY properties.


Implementation
    public function get quality():int
    public function set quality(value:int):void
strengthproperty 
strength:Number

The strength of the imprint or spread. The higher the value, the more color is imprinted and the stronger the contrast between the glow and the background. Valid values are 0 to 255. The default is 2.


Implementation
    public function get strength():Number
    public function set strength(value:Number):void
Constructor Detail
Glow()Constructor
public function Glow(color:uint = 16711680, alpha:Number = 1, blurX:Number = 6, blurY:Number = 6, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)

Initializes a new Glow instance with the specified parameters.

Parameters
color:uint (default = 16711680) — The color of the glow, in the hexadecimal format 0xRRGGBB. The default value is 0xFF0000.
 
alpha:Number (default = 1) — The alpha transparency value for the color. Valid values are 0 to 1. For example, .25 sets a transparency value of 25%.
 
blurX:Number (default = 6) — The amount of horizontal blur. Valid values are 0 to 255 (floating point). Values that are a power of 2 (such as 2, 4, 8, 16 and 32) are optimized to render more quickly than other values.
 
blurY:Number (default = 6) — The amount of vertical blur. Valid values are 0 to 255 (floating point). Values that are a power of 2 (such as 2, 4, 8, 16 and 32) are optimized to render more quickly than other values.
 
strength:Number (default = 2) — The strength of the imprint or spread. The higher the value, the more color is imprinted and the stronger the contrast between the glow and the background. Valid values are 0 to 255.
 
quality:int (default = 1) — The number of times to apply the filter. Use the BitmapFilterQuality constants: BitmapFilterQuality.LOWBitmapFilterQuality.MEDIUMBitmapFilterQuality.HIGHFor more information, see the description of the quality property.
 
inner:Boolean (default = false) — Specifies whether the glow is an inner glow. The value true specifies an inner glow. The value false specifies an outer glow (a glow around the outer edges of the object).
 
knockout:Boolean (default = false) — Specifies whether the object has a knockout effect. The value true makes the object's fill transparent and reveals the background color of the document.
Method Detail
getFilter()method
public function getFilter():GlowFilter

Returns new glow filter

Returns
GlowFilter




Tue Apr 16 2013, 03:24 PM -06:00