flash.filters
public final class GradientGlowFilter
继承GradientGlowFilter Inheritance BitmapFilter Inheritance Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

可使用 GradientGlowFilter 类对显示对象应用渐变发光效果。渐变发光是一种非常逼真的发光效果,您可以控制颜色渐变。可以在对象的内缘或外缘的周围或者对象的顶部应用渐变发光。您可以将滤镜应用于任何显示对象(即,从 DisplayObject 类继承的对象),例如 MovieClip、SimpleButton、TextField 和 Video 对象,以及 BitmapData 对象。

滤镜的具体使用取决于要应用滤镜的对象:

如果对显示对象应用滤镜,显示对象的 cacheAsBitmap 属性将设置为 true。如果清除所有滤镜,将恢复 cacheAsBitmap 的原始值。

此滤镜支持舞台缩放。但是,它不支持常规缩放、旋转和倾斜;如果对象本身进行了缩放(如果将 scaleXscaleY 设置为除 1.0 以外的其它值),滤镜效果将不进行缩放。只有用户在舞台上进行放大时它才会缩放。

如果所得图像超过最大尺寸,则不应用滤镜。在 AIR 1.5 和 Flash Player 10 中,最大宽度或高度为 8,192 像素,并且像素总数不能超过 16,777,216 像素。(因此,如果图像的宽度为 8,192 像素,则其高度只能为 2,048 像素。)在 Flash Player 9 及早期版本和 AIR 1.1 及早期版本中,高度最大为 2,880 像素,宽度最大为 2,880 像素。 例如,如果在放大某大型影片剪辑时应用了滤镜,则所得图像超过最大尺寸时,将关闭该滤镜。

查看示例

另请参见

GradientGlowFilter.ratios
flash.display.BitmapData.applyFilter()
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.filters
GlowFilter 类
Using filters in Flex


公共属性
 属性定义方
  alphas : Array
colors 数组中对应颜色的 Alpha 透明度值的数组。
GradientGlowFilter
  angle : Number
角度,以度为单位。
GradientGlowFilter
  blurX : Number
水平模糊量。
GradientGlowFilter
  blurY : Number
垂直模糊量。
GradientGlowFilter
  colors : Array
定义渐变的颜色数组。
GradientGlowFilter
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  distance : Number
光晕的偏移距离。
GradientGlowFilter
  knockout : Boolean
指定对象是否具有挖空效果。
GradientGlowFilter
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  quality : int
应用滤镜的次数。
GradientGlowFilter
  ratios : Array
对应于 colors 数组中颜色的一组颜色分布比率。
GradientGlowFilter
  strength : Number
印记或跨页的强度。
GradientGlowFilter
  type : String
滤镜效果的放置。
GradientGlowFilter
公共方法
 方法定义方
  
GradientGlowFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
用指定参数初始化滤镜。
GradientGlowFilter
  
返回此滤镜对象的副本。
GradientGlowFilter
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信息
alphas属性
alphas:Array  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

colors 数组中对应颜色的 Alpha 透明度值的数组。数组中每个元素的有效值为 0 到 1。例如,.25 将 Alpha 透明度值设置为 25%。

alphas 属性不能通过直接修改它的值来进行更改。相反,必须获得对 alphas 的引用,对该引用进行更改,然后将 alphas 设置为该引用。

colorsalphasratios 属性是相关的。colors 数组中的第一个元素对应于 alphas 数组中的第一个元素以及 ratios 数组中的第一个元素,依此类推。



实现
    public function get alphas():Array
    public function set alphas(value:Array):void

引发
TypeError — 设置时 Array 为 null

另请参见

angle属性 
angle:Number  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

角度,以度为单位。有效值为 0 到 360。默认值为 45。

角度值表示理论上的光源落在对象上的角度,它决定了效果相对于该对象的位置。如果 distance 设置为 0,则效果相对于对象没有偏移,因此 angle 属性不起作用。



实现
    public function get angle():Number
    public function set angle(value:Number):void
blurX属性 
blurX:Number  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

水平模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。默认值为 4。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈现速度比其它值更快。



实现
    public function get blurX():Number
    public function set blurX(value:Number):void
blurY属性 
blurY:Number  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

垂直模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。默认值为 4。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈现速度比其它值更快。



实现
    public function get blurY():Number
    public function set blurY(value:Number):void
colors属性 
colors:Array  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

定义渐变的颜色数组。例如,红色为 0xFF0000,蓝色为 0x0000FF 等等。

colors 属性不能通过直接修改它的值来进行更改。相反,必须获得对 colors 的引用,对该引用进行更改,然后将 colors 设置为该引用。

colorsalphasratios 属性是相关的。colors 数组中的第一个元素对应于 alphas 数组中的第一个元素以及 ratios 数组中的第一个元素,依此类推。



实现
    public function get colors():Array
    public function set colors(value:Array):void

引发
TypeError — 设置时 Array 为 null

另请参见

distance属性 
distance:Number  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

光晕的偏移距离。默认值为 4。



实现
    public function get distance():Number
    public function set distance(value:Number):void
knockout属性 
knockout:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

指定对象是否具有挖空效果。应用挖空效果将使对象的填充变为透明,并显示文档的背景颜色。值为 true 将指定应用挖空效果;默认值为 false,即不应用挖空效果。



实现
    public function get knockout():Boolean
    public function set knockout(value:Boolean):void
quality属性 
quality:int  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

应用滤镜的次数。默认值为 BitmapFilterQuality.LOW,与应用一次滤镜等效。值 BitmapFilterQuality.MEDIUM 两次应用滤镜;值 BitmapFilterQuality.HIGH 三次应用滤镜。滤镜的值越小,呈现速度越快。

对于大多数应用,quality 的值为低、中或高就足够了。您可以使用其它数值(最高为 15)来达到不同的效果,但是值越高,呈现速度越慢。除了增加 quality 的值,仅增加 blurXblurY 属性的值通常也可以获得类似的效果,而且呈现速度更快。



实现
    public function get quality():int
    public function set quality(value:int):void

另请参见

ratios属性 
ratios:Array  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

对应于 colors 数组中颜色的一组颜色分布比率。有效值为 0 到 255。

ratios 属性不能通过直接修改它的值来进行更改。相反,必须获得对 ratios 的引用,对该引用进行更改,然后将 ratios 设置为该引用。

colorsalphasratios 属性是相关的。colors 数组中的第一个元素对应于 alphas 数组中的第一个元素以及 ratios 数组中的第一个元素,依此类推。

如果 distance 值设置为 0,则将渐变发光滤镜看作从对象中心发出的具有渐变(即相互混合的颜色条纹)的发光。colors 数组中的第一种颜色是光晕最外面的颜色。最后一种颜色是光晕最里面的颜色。

ratios 数组中的每个值设置颜色在渐变的半径上的位置,其中 0 表示渐变最外面的点,255 表示渐变最里面的点。比例值范围是从 0 到 255 像素,它们的值依次增加;例如 [0, 64, 128, 200, 255]。从 0 到 128 的值出现在光晕的外缘上。从 129 到 255 的值出现在光晕的内侧区域中。根据颜色的比例值和滤镜的 type 值,滤镜颜色可能会被应用滤镜的对象遮住。

在下面的代码和图像中,将滤镜应用于黑色的圆影片剪辑,并将类型设置为 "full"。基于教学目的,colors 数组中的第一种颜色(粉色)的 alpha 值为 1,以便与白色文档背景形成鲜明对比。(实际上,您可能不希望这样显示第一种颜色。) 数组中的最后一种颜色(黄色)遮住了应用滤镜的黑色圆盘:

var colors:Array = [0xFFCCFF, 0x0000FF, 0x9900FF, 0xFF0000, 0xFFFF00];
 var alphas:Array = [1, 1, 1, 1, 1];
 var ratios:Array = [0, 32, 64, 128, 225];
 var myGGF:GradientGlowFilter = new GradientGlowFilter(0, 0, colors, alphas, ratios, 50, 50, 1, 2, "full", false);

ratios 数组为 0, 32, 64, 128, 225 的渐变发光滤镜。

要在将 type 值设置为 "outer""full" 时实现与文档背景的无缝效果,请将数组中的第一种颜色设置为与文档背景相同的颜色,或将第一种颜色的 Alpha 值设置为 0;或者使用技巧将滤镜与背景混合在一起。

如果在代码中进行两处小的更改,发光效果可能会大不相同,即使采用相同的 ratioscolors 数组。将数组中第一种颜色的 Alpha 值设置为 0,以便滤镜和文档的白色背景混合在一起;并将 type 属性设置为 "outer""inner"。观察结果,如下面的图像所示。

外发光内发光

请记住,颜色在渐变中的散布基于 blurXblurYstrengthquality 属性的值以及 ratios 值。



实现
    public function get ratios():Array
    public function set ratios(value:Array):void

引发
TypeError — 设置时 Array 为 null

另请参见

strength属性 
strength:Number  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

印记或跨页的强度。该值越高,压印的颜色越深,而且发光与背景之间的对比度也越强。有效值为 0 到 255。值为 0 表示未应用滤镜。默认值为 1。



实现
    public function get strength():Number
    public function set strength(value:Number):void
type属性 
type:String  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

滤镜效果的放置。可能的值是 flash.filters.BitmapFilterType 常数:



实现
    public function get type():String
    public function set type(value:String):void

引发
TypeError — 设置时 String 为 null
构造函数详细信息
GradientGlowFilter()构造函数
public function GradientGlowFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

用指定参数初始化滤镜。

参数
distance:Number (default = 4.0) — 光晕的偏移距离。
 
angle:Number (default = 45) — 角度,以度为单位。有效值为 0 到 360。
 
colors:Array (default = null) — 定义渐变的颜色数组。例如,红色为 0xFF0000,蓝色为 0x0000FF 等等。
 
alphas:Array (default = null)colors 数组中对应颜色的 Alpha 透明度值的数组。数组中每个元素的有效值为 0 到 1。例如,值 .25 将 Alpha 透明度值设置为 25%。
 
ratios:Array (default = null) — 颜色分布比例的数组。有效值为 0 到 255。该值定义颜色采样率为 100% 之处的宽度百分比。
 
blurX:Number (default = 4.0) — 水平模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈现速度比其它值更快。
 
blurY:Number (default = 4.0) — 垂直模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈现速度比其它值更快。
 
strength:Number (default = 1) — 印记或跨页的强度。该值越高,压印的颜色越深,而且发光与背景之间的对比度也越强。有效值为 0 到 255。值越大,压印越强。值为 0 意味着未应用滤镜。
 
quality:int (default = 1) — 应用滤镜的次数。使用 BitmapFilterQuality 常数:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

有关详细信息,请参阅 quality 属性的说明。

 
type:String (default = "inner") — 滤镜效果的放置。可能的值是 flash.filters.BitmapFilterType 常数:
  • BitmapFilterType.OUTER -- 对象外缘上的发光
  • BitmapFilterType.INNER -- 对象内缘上的发光;默认值。
  • BitmapFilterType.FULL -- 对象顶部的发光
 
knockout:Boolean (default = false) — 指定对象是否具有挖空效果。应用挖空效果将使对象的填充变为透明,并显示文档的背景颜色。值为 true 将指定应用挖空效果;默认值为 false,即不应用挖空效果。
方法详细信息
clone()方法
override public function clone():BitmapFilter

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

返回此滤镜对象的副本。

返回
BitmapFilter — 与原始 GradientGlowFilter 实例具有完全相同的属性的新 GradientGlowFilter 实例。
示例 如何使用示例
GradientGlowFilterExample.as

以下示例将绘制一个正方形,并对它应用渐变发光滤镜。该示例的一般工作流程如下:
  1. 导入所需的类。
  2. 声明用于定义正方形和滤镜的全局变量。
  3. 创建构造函数,该函数执行以下操作:
    • 调用 draw() 方法,该方法使用 Graphics 类的方法(通过 Sprite 的 graphics 属性访问)绘制一个正方形。
    • 创建名为 filter 的 BitmapFilter 对象,并将对 getBitmapFilter()(用于创建滤镜)的调用的返回值赋予它。
    • 创建一个名为 myFilters 的新数组,并将 filter 添加到该数组。
    • myFilters 分配给 GradientGlowFilterExample 对象的 filters 属性。这将应用 myFilters 中包含的所有滤镜,在本例中仅为 filter
package {
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.BitmapFilterType;
    import flash.filters.GradientGlowFilter;
    import flash.display.Sprite;

    public class GradientGlowFilterExample extends Sprite {
        private var bgColor:uint = 0xCCCCCC;
        private var size:uint    = 80;
        private var offset:uint  = 50;

        private var distance:Number  = 0;
        private var angleInDegrees:Number = 45;
        private var colors:Array     = [0xFFFFFF, 0xFF0000, 0xFFFF00, 0x00CCFF];
        private var alphas:Array     = [0, 1, 1, 1];
        private var ratios:Array     = [0, 63, 126, 255];
        private var blurX:Number     = 50;
        private var blurY:Number     = 50;
        private var strength:Number  = 2.5;
        private var quality:Number   = BitmapFilterQuality.HIGH;
        private var type:String      = BitmapFilterType.OUTER;
        private var knockout:Boolean = false;

        public function GradientGlowFilterExample() {
            draw();
            var filter:BitmapFilter = getBitmapFilter();
            var myFilters:Array = new Array();
            myFilters.push(filter);
            filters = myFilters;
        }

        private function getBitmapFilter():BitmapFilter {
            return new GradientGlowFilter(distance,
                                          angleInDegrees,
                                          colors,
                                          alphas,
                                          ratios,
                                          blurX,
                                          blurY,
                                          strength,
                                          quality,
                                          type,
                                          knockout);
        }

        private function draw():void {
            graphics.beginFill(bgColor);
            graphics.drawRect(offset, offset, size, size);
            graphics.endFill();
        }
    }
}