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

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

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

另请参见

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

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

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

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

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

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

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

另请参见

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

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

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

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

另请参见

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

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

colors、alphas 和 ratios 属性是相关的。 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);
 

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

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

请记住，颜色在渐变中的散布基于 blurX、blurY、strength 和 quality 属性的值以及 ratios 值。

另请参见

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

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

• BitmapFilterType.OUTER -- 对象外缘上的发光
• BitmapFilterType.INNER -- 对象内缘上的发光；默认值。
• BitmapFilterType.FULL -- 对象顶部的发光

用指定参数初始化滤镜。

返回此滤镜对象的副本。

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();
        }
    }
}