spark.filtersGradientBevelFilter 使用 GradientBevelFilter 类可以对显示对象应用渐变斜角效果。The <s:GradientBevelFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientBevelFilter/>
  
]]>
mx.filters:IBitmapFilterspark.filters:GradientFilter 使用 GradientBevelFilter 类可以对显示对象应用渐变斜角效果。渐变斜角是位于对象外部、内部或顶部的使用渐变色增强的有斜面的边缘。有斜面的边缘使对象具有三维外观。您可以将滤镜应用于任何显示对象(即,从 DisplayObject 类继承的对象),例如 MovieClip、SimpleButton、TextField 和 Video 对象,以及 BitmapData 对象。

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

  • 要对显示对象应用滤镜,请使用 filters 属性。设置对象的 filters 属性不会修改相应的对象,而清除 filters 属性可以删除相应的滤镜。
  • 要对 BitmapData 对象应用滤镜,请使用 BitmapData.applyFilter() 方法。对 BitmapData 对象调用 applyFilter() 会取得源 BitmapData 对象和滤镜对象,并最终生成一个过滤图像。

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

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

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

spark.filters.BevelFilterflash.filters.GradientBevelFilterGradientBevelFilter.ratiosflash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapGradientBevelFilter 构造函数。distance4.0偏移距离。有效值为 0 到 8。 angle45角度,以度为单位。有效值为 0 到 360。 colorsnull渐变中使用的 RGB 十六进制颜色值数组。例如,红色为 0xFF0000,蓝色为 0x0000FF 等等。 alphasnullcolors 数组中对应颜色的 Alpha 透明度值的数组。数组中每个元素的有效值为 0 到 1。例如,0.25 设置透明度值为 25%。 ratiosnull颜色分布比例的数组;有效值为 0 到 255。 blurX4.0水平模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。默认值为 4。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈示速度比其它值更快。 blurY4.0垂直模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈示速度比其它值更快。 strength1印记或跨页的强度。该值越高,压印的颜色越深,而且斜角与背景之间的对比度也越强。有效值为 0 到 255。值为 0 表示未应用滤镜。 quality1滤镜的品质。使用 BitmapFilterQuality 常量:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

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

typeinner斜角效果的放置。可能的值为 BitmapFilterType 常量:
  • BitmapFilterType.OUTER -- 对象外缘上的斜角
  • BitmapFilterType.INNER -- 对象内缘上的斜角
  • BitmapFilterType.FULL -- 对象顶部的斜角
knockoutfalse指定是否应用挖空效果。值为 true 将使对象的填充变为透明,并显示文档的背景颜色。
构造函数。
clone 返回此滤镜对象的副本。与原始 GradientBevelFilter 实例具有完全相同的属性的新 GradientBevelFilter 实例。 返回此滤镜对象的副本。
DropShadowFilter 可使用 DropShadowFilter 类向显示对象添加投影。The <s:DropShadowFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:DropShadowFilter 
    Properties
    alpha="1"
    angle="45"
    color="0xFF0000"
    distance="4"
    hideObject="false"
    inner="false"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter 可使用 DropShadowFilter 类向显示对象添加投影。阴影算法基于模糊滤镜使用的同一个框型滤镜。投影样式有多个选项,包括内侧或外侧阴影和挖空模式。您可以将滤镜应用于任何显示对象(即,从 DisplayObject 类继承的对象),例如 MovieClip、SimpleButton、TextField 和 Video 对象,以及 BitmapData 对象。

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

  • 要对显示对象应用滤镜,请使用 filters 属性(继承自 DisplayObject)。设置对象的 filters 属性不会修改相应的对象,而清除 filters 属性可以删除相应的滤镜。
  • 要对 BitmapData 对象应用滤镜,请使用 BitmapData.applyFilter() 方法。对 BitmapData 对象调用 applyFilter() 会取得源 BitmapData 对象和滤镜对象,并最终生成一个过滤图像。

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

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

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

flash.filters.DropShadowFilterDropShadowFilter 构造函数。distance4.0阴影的偏移距离,以像素为单位。 angle45阴影的角度,0 到 360 度(浮点)。 color0阴影颜色,采用十六进制格式 0xRRGGBB。默认值为 0x000000。 alpha1.0阴影颜色的 Alpha 透明度值。有效值为 0.0 到 1.0。例如,0.25 设置透明度值为 25%。 blurX4.0水平模糊量。有效值为 0 到 255.0(浮点)。 blurY4.0垂直模糊量。有效值为 0 到 255.0(浮点)。 strength1.0印记或跨页的强度。该值越高,压印的颜色越深,而且阴影与背景之间的对比度也越强。有效值为 0 到 255.0。 quality1应用滤镜的次数。使用 BitmapFilterQuality 常量:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

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

innerfalse表示阴影是否为内侧阴影。值 true 指定内侧阴影。值 false 指定外侧阴影(对象外缘周围的阴影)。 knockoutfalse应用挖空效果 (true),这将有效地使对象的填色变为透明,并显示文档的背景颜色。 hideObjectfalse表示是否隐藏对象。如果值为 true,则表示没有绘制对象本身,只有阴影是可见的。
构造函数。
flash.filters.BitmapFilterQuality
clone 返回此滤镜对象的副本。具有原始 DropShadowFilter 实例的所有属性的新 DropShadowFilter 实例。 返回此滤镜对象的副本。 alpha 颜色的 Alpha 透明度值。1 颜色的 Alpha 透明度值。有效值为 0 到 1。例如,0.25 设置透明度值为 25%。 angle 斜角的角度。45 斜角的角度。有效值为 0 到 360 度。角度值表示理论上的光源落在对象上的角度,它决定了效果相对于该对象的位置。如果 distance 属性设置为 0,则效果相对于对象没有偏移,因此 angle 属性不起作用。 color 光晕颜色。0xFF0000 光晕颜色。有效值采用十六进制格式 0xRRGGBB。 distance 斜角的偏移距离。4 斜角的偏移距离。有效值以像素为单位(浮点)。 hideObject 表示是否隐藏对象。false 表示是否隐藏对象。如果值为 true,则表示没有绘制对象本身,只有阴影是可见的。默认值为 false,这意味着会显示对象。 inner 指定发光是否为内侧发光。false 指定发光是否为内侧发光。值 true 表示内侧发光。默认值为 false,即创建外侧发光(对象外缘周围的发光)。
ConvolutionFilter ConvolutionFilter 类应用矩阵盘绕滤镜效果。The <s:ConvolutionFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

 <s:ConvolutionFilter 
   Properties
   alpha="1"
   clamp="true"
   color="0xFF0000"
   divisor="1.0"
   matrix="[]"
   matrixX="0"
   matrixY="0"
   preserveAlpha="true"
 />
 
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter ConvolutionFilter 类应用矩阵盘绕滤镜效果。卷积将输入图像的像素与相邻的像素合并以生成图像。通过卷积,可以实现大量的图像效果,包括模糊、边缘检测、锐化、浮雕和斜角。您可以将滤镜应用于任何显示对象(即,从 DisplayObject 类继承的对象),例如 MovieClip、SimpleButton、TextField 和 Video 对象,以及 BitmapData 对象。

要创建卷积滤镜,请使用语法 new ConvolutionFilter()。滤镜的具体使用取决于要应用滤镜的对象:

  • 要对影片剪辑、文本字段、按钮和视频应用滤镜,请使用 filters 属性(继承自 DisplayObject)。设置对象的 filters 属性不会修改相应的对象,而清除 filters 属性可以删除相应的滤镜。
  • 要对 BitmapData 对象应用滤镜,请使用 BitmapData.applyFilter() 方法。对 BitmapData 对象调用 applyFilter() 会取得源 BitmapData 对象和滤镜对象,并最终生成一个过滤图像。

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

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

ConvolutionFilter 构造函数。matrixX0矩阵的 x 维度(矩阵中列的数目)。默认值为 0。 matrixY0矩阵的 y 维度(矩阵中行的数目)。默认值为 0。 matrixnull用于矩阵转换的值的数组。数组中的项数必须等于 matrixX * matrixYdivisor1.0矩阵转换中使用的除数。默认值为 1。如果除数是所有矩阵值的总和,则可调平结果的总体色彩强度。忽略 0 值,此时使用默认值。 bias0.0要添加到矩阵转换结果的偏差。默认值为 0。 preserveAlphatruefalse 值表示未保留 Alpha 值,并且卷积适用于所有通道(包括 Alpha 通道)。值为 true 表示只对颜色通道应用卷积。默认值为 trueclamptrue对于源图像之外的像素,如果值为 true,则表明通过复制输入图像给定边缘处的颜色值,沿着输入图像的每个边框按需要扩展输入图像。如果值为 false,则表明应按照 coloralpha 属性中的指定使用其他颜色。默认值为 truecolor0要替换源图像之外的像素的十六进制颜色。 alpha0.0替换颜色的 Alpha。 构造函数。 clone 返回此滤镜对象的副本。BitmapFilter,与原始 ConvolutionMatrixFilter 实例具有完全相同的属性的新 ConvolutionFilter 实例。 返回此滤镜对象的副本。 alpha 颜色的 Alpha 透明度值。1 颜色的 Alpha 透明度值。有效值为 0 到 1。例如,0.25 设置透明度值为 25%。 bias 要添加到矩阵转换结果中的偏差量。0 要添加到矩阵转换结果中的偏差量。偏差可增加每个通道的颜色值,以便暗色变得较明亮。 clamp 表示是否应锁定图像。true 表示是否应锁定图像。对于源图像之外的像素,如果值为 true,则表明通过复制输入图像每个相应的边缘处的颜色值,沿着输入图像的每个边框按需要扩展输入图像。如果值为 false,则表明应按照 color 和 alpha 属性中的指定使用其它颜色。 color 光晕颜色。0xFF0000 光晕颜色。有效值采用十六进制格式 0xRRGGBB。 divisor 矩阵转换中使用的除数。1.0 矩阵转换中使用的除数。默认值为 1。如果除数是所有矩阵值的总和,则可调平结果的总体色彩强度。忽略 0 值,此时使用默认值。 matrixX 矩阵的 x 维度(矩阵中的行数)。0 矩阵的 x 维度(矩阵中的行数)。 matrixY 矩阵的 y 维度(矩阵中的列数)。0 矩阵的 y 维度(矩阵中的列数)。 matrix 水平模糊量。[] 水平模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。默认值为 4。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈现速度比其他值更快。 preserveAlpha 表示是否已保留 Alpha 通道并且不使用滤镜效果,或是否对 Alpha 通道以及颜色通道应用卷积滤镜。true 表示是否已保留 Alpha 通道并且不使用滤镜效果,或是否对 Alpha 通道以及颜色通道应用卷积滤镜。值为 false 表示卷积应用于所有通道,包括 Alpha 通道。值为 true 表示只对颜色通道应用卷积。
BlurFilter 可使用 BlurFilter 类将模糊视觉效果应用于显示对象。The <s:BlurFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:BlurFilter
    Properties
    blurX="4.0"
    blurY="4.0"
    quality="low"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter 可使用 BlurFilter 类将模糊视觉效果应用于显示对象。模糊效果可以柔化图像的细节。您可以生成一些模糊效果,范围从创建一个柔化的、未聚焦的外观到高斯模糊(就像通过半透明玻璃查看图像一样的朦胧的外观)。当此滤镜的 quality 属性设置为低时,结果为柔化的、未聚焦的外观。当 quality 属性设置为高时,该属性接近高斯模糊滤镜。您可以将滤镜应用于任何显示对象(即,从 DisplayObject 类继承的对象),例如 MovieClip、SimpleButton、TextField 和 Video 对象,以及 BitmapData 对象。

要创建新的滤镜,请使用构造函数 new BlurFilter()。滤镜的具体使用取决于要应用滤镜的对象:

  • 要对影片剪辑、文本字段、按钮和视频应用滤镜,请使用 filters 属性(继承自 DisplayObject)。设置对象的 filters 属性不会修改相应的对象,而清除 filters 属性可以删除相应的滤镜。
  • 要对 BitmapData 对象应用滤镜,请使用 BitmapData.applyFilter() 方法。对 BitmapData 对象调用 applyFilter() 会取得源 BitmapData 对象和滤镜对象,并最终生成一个过滤图像。

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

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

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

flash.filters.BlurFilterflash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.BitmapData.applyFilter()BlurFilter 构造函数。blurX4.0水平模糊量。有效值为 0 到 255.0(浮点值)。 blurY4.0垂直模糊量。有效值为 0 到 255.0(浮点值)。 quality1应用滤镜的次数。可以使用 flash.filters.BitmapFilterQuality 常量来指定品质:
  • flash.filters.BitmapFilterQuality.LOW
  • flash.filters.BitmapFilterQuality.MEDIUM
  • flash.filters.BitmapFilterQuality.HIGH

高品质接近高斯模糊。对于大多数应用,这三个值已足够了。虽然您可以使用不超过 15 的其它数值来达到不同的效果,但是请注意,值越高,呈现速度越慢。

初始化滤镜。
构造函数。默认值会创建一个柔化的、未聚焦的图像。
clone 返回此滤镜对象的副本。具有与原始 BlurFilter 实例相同的所有属性的新 BlurFilter 实例。 返回此滤镜对象的副本。 blurX 水平模糊量。4.0 水平模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。默认值为 4。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈现速度比其他值更快。 blurY 垂直模糊量。4.0 垂直模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。默认值为 4。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈现速度比其他值更快。 quality 应用滤镜的次数。"low" 应用滤镜的次数。默认值为 BitmapFilterQuality.LOW,与应用一次滤镜等效。值 BitmapFilterQuality.MEDIUM 两次应用滤镜;值 BitmapFilterQuality.HIGH 三次应用滤镜。滤镜的值越小,呈示速度越快。

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

ColorMatrixFilter 使用 ColorMatrixFilter 类可以将 4 x 5 矩阵转换应用于输入图像上的每个像素的 RGBA 颜色和 Alpha 值,以生成具有一组新的 RGBA 颜色和 Alpha 值的结果。The <s:ColorMatrixFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ColorMatrixFilter
    Properties
    matrix="[1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0]"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter 使用 ColorMatrixFilter 类可以将 4 x 5 矩阵转换应用于输入图像上的每个像素的 RGBA 颜色和 Alpha 值,以生成具有一组新的 RGBA 颜色和 Alpha 值的结果。该类允许饱和度更改、色相旋转、亮度为 Alpha 以及各种其他效果。您可以将滤镜应用于任何显示对象(即,从 DisplayObject 类继承的对象),例如 MovieClip、SimpleButton、TextField 和 Video 对象,以及 BitmapData 对象。 flash.filters.ColorMatrixFilterColorMatrixFilter 构造函数。matrixnull由 20 个项目(排列成 4 x 5 矩阵)组成的数组。 初始化新 ColorMatrixFilter 实例。 构造函数。 clone 返回此滤镜对象的副本。与原始实例具有完全相同的属性的新 ColorMatrixFilter 实例。 返回此滤镜对象的副本。 matrix 构成应用于所呈示的元素的一个 4x5 矩阵的、以逗号分隔的 20 个双精度数的列表。[1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0] 构成应用于所呈示的元素的一个 4x5 矩阵的、以逗号分隔的 20 个双精度数的列表。矩阵以行作为主要顺序,即用第一行五个元素乘以矢量 [srcR,srcG,srcB,srcA,1] 以确定输出的红色值,用第二行的五个元素确定输出的绿色值,等等。

该值必须为 20 个数字组成的数组或以逗号分隔的字符串。

GradientFilter 提供渐变视觉效果的滤镜的基类。The <s:GradientFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GradientFilter
    Properties
    angle="45"
    distance="4.0"
    entries="[]"
    type="inner"
  />
  
]]>
mx.filters:BaseDimensionFilter 提供渐变视觉效果的滤镜的基类。 spark.filters.GradientGlowFilterspark.filters.GradientBevelFilterGradientFilter 构造函数。colorsnull渐变中使用的 RGB 十六进制颜色值数组。例如,红色为 0xFF0000,蓝色为 0x0000FF 等等。 alphasnullcolors 数组中对应颜色的 Alpha 透明度值的数组。数组中每个元素的有效值为 0 到 1。例如,0.25 设置透明度值为 25%。 ratiosnull颜色分布比例的数组;有效值为 0 到 255。 构造函数。 angle 角度,以度为单位。45 角度,以度为单位。有效值为 0 到 360。角度值表示理论上的光源落在对象上的角度,它决定了效果相对于该对象的位置。如果将 distance 设置为 0,则效果相对于对象没有偏移,因此 angle 属性不起作用。 distance 光晕的偏移距离。4.0 光晕的偏移距离。 entries GradientEntry 对象 Array,用于定义渐变填充的填充模式。[] GradientEntry 对象 Array,用于定义渐变填充的填充模式。 type 滤镜效果的放置。BitmapFilterType.INNER 滤镜效果的放置。可能的值是 flash.filters.BitmapFilterType 常量:
  • BitmapFilterType.OUTER - 对象外缘上的发光。
  • BitmapFilterType.INNER - 对象内缘上的发光。
  • BitmapFilterType.FULL - 对象顶部的发光。
flash.filters.BitmapFilterType
BevelFilter 可使用 BevelFilter 类对显示对象添加斜角效果。The <s:BevelFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:BevelFilter 
    Properties
    angle="45"
    distance="4"
    highlightAlpha="1"
    highlightColor="0xFFFFFF"
    shadowAlpha="1"
    shadowColor="0x000000"
    type="inner"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter 可使用 BevelFilter 类对显示对象添加斜角效果。斜角效果使对象(如按钮)具有三维外观。您可以利用不同的加亮颜色和阴影颜色、斜角上的模糊量、斜角的角度、斜角的位置和挖空效果来自定义斜角的外观。您可以将滤镜应用于任何显示对象(即,从 DisplayObject 类继承的对象),例如 MovieClip、SimpleButton、TextField 和 Video 对象,以及 BitmapData 对象。

要创建新滤镜,请使用构造函数 new BevelFilter()。滤镜的具体使用取决于要应用滤镜的对象:

  • 要对影片剪辑、文本字段、按钮和视频应用滤镜,请使用 filters 属性(继承自 DisplayObject)。设置对象的 filters 属性不会修改相应的对象,而清除 filters 属性可以删除相应的滤镜。
  • 要对 BitmapData 对象应用滤镜,请使用 BitmapData.applyFilter() 方法。对 BitmapData 对象调用 applyFilter() 会取得源 BitmapData 对象和滤镜对象,并最终生成一个过滤图像。

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

此滤镜支持舞台缩放。但是,它不支持常规缩放、旋转和倾斜。如果对象本身进行了缩放(如果 scaleXscaleY 属性未被设置为 100%),则滤镜不进行缩放。只有用户在舞台上进行放大时它才会缩放。

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

flash.filters.BevelFilterflash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.BitmapData.applyFilter()BevelFilter 构造函数。distance4.0斜角的偏移距离,以像素为单位(浮点)。 angle45斜角的角度,0 至 360 度。 highlightColor0xFFFFFF斜角的加亮颜色,0xRRGGBBhighlightAlpha1.0加亮颜色的 Alpha 透明度值。有效值为 0.0 到 1.0。例如,0.25 设置透明度值为 25%。 shadowColor0x000000斜角的阴影颜色,0xRRGGBBshadowAlpha1.0阴影颜色的 Alpha 透明度值。有效值为 0.0 到 1.0。例如,0.25 设置透明度值为 25%。 blurX4.0水平模糊量,以像素为单位。有效值为 0 到 255.0(浮点)。 blurY4.0垂直模糊量,以像素为单位。有效值为 0 到 255.0(浮点)。 strength1印记或跨页的强度。该值越高,压印的颜色越深,而且斜角与背景之间的对比度也越强。有效值为 0 到 255.0。 quality1斜角的品质。有效值为 0 至 15,但是对于大多数应用情形,可以使用 flash.filters.BitmapFilterQuality 常量:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

这些值越低,滤镜的呈现速度就越快。可以使用其它可用的数值来实现不同的效果。

typeinner斜角类型。有效值为 flash.filters.BitmapFilterType 常量:BitmapFilterType.INNERBitmapFilterType.OUTERBitmapFilterType.FULLknockoutfalse应用挖空效果 (true),这将有效地使对象的填色变为透明,并显示文档的背景颜色。
构造函数。
flash.filters.BitmapFilterQualityflash.filters.BitmapFilterType
clone 返回此滤镜对象的副本。具有与原始 BevelFilter 实例相同的所有属性的新 BevelFilter 实例。 返回此滤镜对象的副本。 angle 斜角的角度(以度为单位)。45 斜角的角度(以度为单位)。有效值为 0 到 360。角度值表示理论上的光源落在对象上的角度,它决定了效果相对于该对象的位置。如果 distance 属性设置为 0,则效果相对于对象没有偏移,因此 angle 属性不起作用。 distance 斜角的偏移距离。4 斜角的偏移距离。有效值以像素为单位(浮点)。 highlightAlpha 加亮颜色的 Alpha 透明度值。1 加亮颜色的 Alpha 透明度值。该值被指定为 0 到 1 之间的标准值。例如,0.25 设置透明度值为 25%。 highlightColor 斜角的加亮颜色。0xFFFFFF 斜角的加亮颜色。有效值采用十六进制格式,0xRRGGBB。 shadowAlpha 阴影颜色的 Alpha 透明度值。1 阴影颜色的 Alpha 透明度值。该值被指定为 0 到 1 之间的标准值。例如,0.25 设置透明度值为 25%。 shadowColor 斜角的阴影颜色。0x000000 斜角的阴影颜色。有效值采用十六进制格式,0xRRGGBB。 type 滤镜效果的放置。BitmapFilterType.INNER 滤镜效果的放置。可能的值是 flash.filters.BitmapFilterType 常量:
  • BitmapFilterType.OUTER - 对象外缘上的发光。
  • BitmapFilterType.INNER - 对象内缘上的发光;默认值。
  • BitmapFilterType.FULL - 对象顶部的发光。
flash.filters.BitmapFilterType
GradientGlowFilter 可使用 GradientGlowFilter 类对显示对象应用渐变发光效果。The <s:GradientGlowFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

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

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

  • 要对显示对象应用滤镜,请使用 filters 属性。设置对象的 filters 属性不会修改相应的对象,而清除 filters 属性可以删除相应的滤镜。
  • 要对 BitmapData 对象应用滤镜,请使用 BitmapData.applyFilter() 方法。对 BitmapData 对象调用 applyFilter() 会取得源 BitmapData 对象和滤镜对象,并最终生成一个过滤图像。

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

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

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

spark.filters.GlowFilterflash.filters.GradientGlowFilterflash.display.BitmapData.applyFilter()flash.display.DisplayObject.cacheAsBitmapflash.display.DisplayObject.filtersGradientGlowFilter 构造函数。distance4.0光晕的偏移距离。 angle45角度,以度为单位。有效值为 0 到 360。 colorsnull定义渐变的颜色数组。例如,红色为 0xFF0000,蓝色为 0x0000FF 等等。 alphasnullcolors 数组中对应颜色的 Alpha 透明度值的数组。数组中每个元素的有效值为 0 到 1。例如,值 0.25 将 Alpha 透明度值设置为 25%。 ratiosnull颜色分布比例的数组。有效值为 0 到 255。该值定义颜色采样率为 100% 之处的宽度百分比。 blurX4.0水平模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈示速度比其它值更快。 blurY4.0垂直模糊量。有效值为 0 到 255。如果模糊量小于或等于 1,则表明原始图像是按原样复制的。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈示速度比其它值更快。 strength1印记或跨页的强度。该值越高,压印的颜色越深,而且发光与背景之间的对比度也越强。有效值为 0 到 255。值越大,压印越强。值为 0 意味着未应用滤镜。 quality1应用滤镜的次数。使用 flash.filters.BitmapFilterQuality 常量:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

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

typeouter滤镜效果的放置。可能的值是 flash.filters.BitmapFilterType 常量:
  • BitmapFilterType.OUTER - 对象外缘上的发光;默认值。
  • BitmapFilterType.INNER - 对象内缘上的发光
  • BitmapFilterType.FULL -- 对象顶部的发光
knockoutfalse指定对象是否具有挖空效果。应用挖空效果将使对象的填充变为透明,并显示文档的背景颜色。值为 true 将指定应用挖空效果;默认值为 false,即不应用挖空效果。
构造函数。
clone 返回此滤镜对象的副本。与原始 GradientGlowFilter 实例具有完全相同的属性的新 GradientGlowFilter 实例。 返回此滤镜对象的副本。
DisplacementMapFilter DisplacementMapFilter 类使用指定的 BitmapData 对象(称为置换图图像)的像素值执行对象置换。The <s:DisplacementMapFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

 <s:DisplacementMapFilter 
   Properties
   alpha="0"
   color="0x000000"
   componentX="0"
   componentY="0"
   mapBitmap="null"
   mapPoint="null"
   mode="wrap"
   scaleX="0"
   scaleY="0"
 />
 
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter DisplacementMapFilter 类使用指定的 BitmapData 对象(称为置换图图像)的像素值执行对象置换。您可以使用此滤镜将扭曲或斑点效果应用于从 DisplayObject 类中继承的任何对象,例如 MovieClip、SimpleButton、TextField 和 Video 对象,以及 BitmapData 对象。

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

  • 要将滤镜应用于显示对象,请使用显示对象的 filters 属性。设置对象的 filters 属性不会修改相应的对象,而清除 filters 属性可以删除相应的滤镜。
  • 要对 BitmapData 对象应用滤镜,请使用 BitmapData.applyFilter() 方法。对 BitmapData 对象调用 applyFilter() 会取得源 BitmapData 对象和滤镜对象,并生成一个过滤后的图像。

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

此滤镜使用以下公式:

dstPixel[x, y] = srcPixel[x + ((componentX(x, y) - 128) ~~ scaleX) / 256, y + ((componentY(x, y) - 128) ~~scaleY) / 256)

其中,componentX(x, y)mapBitmap 属性获得 (x - mapPoint.x ,y - mapPoint.y) 处的 componentX 属性颜色值。

滤镜使用的映射图像会进行缩放,以匹配舞台缩放比例。当对象自身呈一定的比例时,它不会进行缩放。

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

flash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapDisplacementMapFilter 构造函数。mapBitmapnull包含置换映射数据的 BitmapData 对象。 mapPointnull一个值,它包含目标显示对象的左上角相对于映射图像左上角的偏移量。 componentX0说明在映射图像中使用哪个颜色通道来置换 x 结果。可能的值为 BitmapDataChannel 常量。 componentY0说明在映射图像中使用哪个颜色通道来置换 y 结果。可能的值为 BitmapDataChannel 常量。 scaleX0.0用于缩放映射计算的 x 置换结果的乘数。 scaleY0.0用于缩放映射计算的 y 置换结果的乘数。 modewrap滤镜模式。可能的值为 DisplacementMapFilterMode 常量。 color0指定对于超出范围的替换应用什么颜色。置换的有效范围是 0.0 到 1.0。如果 mode 设置为 DisplacementMapFilterMode.COLOR,则使用此参数。 alpha0.0指定对于超出范围的替换应用什么 Alpha 值。它被指定为 0.0 到 1.0 之间的标准值。例如,0.25 设置透明度值为 25%。如果 mode 设置为 DisplacementMapFilterMode.COLOR,则使用此参数。 构造函数。 flash.display.BitmapDataChannelflash.filters.DisplacementMapFilterModeclone 返回此滤镜对象的副本。具有与原始实例相同的所有属性的新 DisplacementMapFilter 实例。 返回此滤镜对象的副本。 alpha 指定对于超出范围的替换应用的 Alpha 透明度值。0 指定对于超出范围的替换应用的 Alpha 透明度值。它被指定为 0.0 到 1.0 之间的标准值。例如,0.25 设置透明度值为 25%。默认值为 0。如果 mode 属性设置为 DisplacementMapFilterMode.COLOR,则使用此属性。 color 指定对于超出范围的替换应用什么颜色。0x000000 指定对于超出范围的替换应用什么颜色。置换的有效范围是 0.0 到 1.0。值采用十六进制格式。color 的默认值为 0。如果 mode 属性设置为 DisplacementMapFilterMode.COLOR,则使用此属性。 componentX 说明在映射图像中使用哪个颜色通道来置换 x 结果。0, meaning no channel. 说明在映射图像中使用哪个颜色通道来置换 x 结果。可能的值为 BitmapDataChannel 常量:
  • BitmapDataChannel.ALPHA
  • BitmapDataChannel.BLUE
  • BitmapDataChannel.GREEN
  • BitmapDataChannel.RED
flash.display.BitmapDataChannel
componentY 说明在映射图像中使用哪个颜色通道来置换 y 结果。0, meaning no channel. 说明在映射图像中使用哪个颜色通道来置换 y 结果。可能的值为 BitmapDataChannel 常量:
  • BitmapDataChannel.ALPHA
  • BitmapDataChannel.BLUE
  • BitmapDataChannel.GREEN
  • BitmapDataChannel.RED
mapBitmap 包含置换映射数据的 BitmapData 对象。null 包含置换映射数据的 BitmapData 对象。 mapPoint 一个值,它包含目标显示对象的左上角相对于映射图像左上角的偏移量。null 一个值,它包含目标显示对象的左上角相对于映射图像左上角的偏移量。 mode 滤镜模式。DisplacementMapFilterMode.WRAP 滤镜模式。可能的值为 DisplacementMapFilterMode 常量:
  • DisplacementMapFilterMode.WRAP - 将置换值折返到源图像的另一侧。
  • DisplacementMapFilterMode.CLAMP - 将置换值锁定在源图像的边缘。
  • DisplacementMapFilterMode.IGNORE - 如果置换值超出了范围,则忽略置换并使用源像素。
  • DisplacementMapFilterMode.COLOR - 如果置换值在图像之外,则替换 color 和 alpha 属性中的值。
scaleX 用于缩放映射计算的 x 置换结果的乘数。0 用于缩放映射计算的 x 置换结果的乘数。 scaleY 用于缩放映射计算的 y 置换结果的乘数。0 用于缩放映射计算的 y 置换结果的乘数。
ShaderFilter Flex ShaderFilter 类可提取出大量细节,这些细节是关于如何使用 Flash ShaderFilter、Shader 和 ShaderData 类将 Pixel Bender 着色器应用为滤镜的。The <s:ShaderFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ShaderFilter
    Properties
    bottomExtension="0"
    leftExtension="0"
    precisionHint="full"
    rightExtension="0"
    shader="[]"
    topExtension="0"
  />
  
]]>
mx.filters:IBitmapFilterflash.events:IEventDispatcherflash.utils:Proxy Flex ShaderFilter 类可提取出大量细节,这些细节是关于如何使用 Flash ShaderFilter、Shader 和 ShaderData 类将 Pixel Bender 着色器应用为滤镜的。

ShaderFilter 类必须使用 Shader 对象的实例或者 Shader 的 Class 代理(例如来自 Embed)来初始化。这样,ShaderFilter 类就会充当基础 Shader 的代理,提供一种方便的机制,将标量和多维着色器输入参数都作为简单命名的属性直接访问。

要设置简单标量着色器输入参数(例如类型为 FLOAT 或 INT 的此类参数),可以直接引用属性,如 myFilter.radius

要设置多维着色器输入参数(如 FLOAT2)的各个组件或设置其动画,可以使用属性后缀约定直接访问各个值。以下代码显示设置 FLOAT2 属性 center 的第一个和第二个组件的两种方式:

     // 'center' is an input parameter of type FLOAT2.
     shader.center = [10,20];
 
     // Use property suffix convention to access the first and second component of 'center'. 
     shader.center_x = 10;
     shader.center_y = 20;
 

可以使用的支持的属性后缀的全集如下所示:

  • 对于类型为 BOOL2、BOOL3、BOOL4、FLOAT2、FLOAT3、FLOAT4、INT2、INT3 或 INT4 的着色器输入参数,可以使用“r g b a”、“x y z w”或“s t p q”分别访问第一个、第二个、第三个和第四个组件。
  • 对于类型为 MATRIX2x2、MATRIX3x3 或 MATRIX4x4 的着色器输入参数,可以使用“a b c d e f g h i j k l m n o p”分别访问给定矩阵的第 1 个至第 16 个组件。

随着 ShaderFilter 上属性的更改(例如在动画过程中),ShaderFilter 会自动将其自身重新应用于它所应用的可视组件的滤镜数组。

简单 ShaderFilter 示例: <?xml version="1.0"?> <s:Application xmlns:s="library://ns.adobe.com/flex/spark" xmlns:fx="http://ns.adobe.com/mxml/2009"> <!-- The hypothetical 'spherize' shader applied below has two input parameters, 'center' and 'radius' with the following attributes: parameter 'center' ==< type: float2 minValue: float2(-200,-200) maxValue: float2(800,500) defaultValue: float2(400,250) description: "displacement center" parameter 'radius' ==< type: float minValue: float(.1) maxValue: float(400) defaultValue: float(200) description: "radius" --> <s:Label text="ABCDEF"> <s:filters> <s:ShaderFilter shader="@Embed(source='shaders/spherize.pbj')" radius="25" center_x="50" center_y="15" /> </s:filters> </s:Label> </s:Application>
spark.effects.AnimateFilterShaderFilter 构造函数。shadernull完全实现的 flash.display.Shader 实例,或者代表 Shader 的 Class(例如来自 Embed)。 构造函数。 bottomExtension 0 leftExtension 0 precisionHint 基础着色器所执行的数学运算的精度。ShaderPrecision.FULL 基础着色器所执行的数学运算的精度。precisionHint 属性的可能值集是由 ShaderPrecision 类中的常量定义的。 flash.display.Shaderflash.display.ShaderPrecisionrightExtension 0 shader 一个 flash.display.Shader 实例。 一个 flash.display.Shader 实例。 flash.display.ShadertopExtension 0
GlowFilter 使用 GlowFilter 类可以对显示对象应用发光效果。The <s:GlowFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GlowFilter
    Properties
    alpha="1"
    color="0xFF0000"
    inner="false"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter 使用 GlowFilter 类可以对显示对象应用发光效果。有多个用于发光样式的选项,包括内侧发光或外侧发光以及挖空模式。在投影滤镜的 distanceangle 属性设置为 0 时,发光滤镜与投影滤镜极为相似。您可以将滤镜应用于任何显示对象(即,从 DisplayObject 类继承的对象),例如 MovieClip、SimpleButton、TextField 和 Video 对象,以及 BitmapData 对象。

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

  • 要对显示对象应用滤镜,请使用 filters 属性(继承自 DisplayObject)。设置对象的 filters 属性不会修改相应的对象,而清除 filters 属性可以删除相应的滤镜。
  • 要对 BitmapData 对象应用滤镜,请使用 BitmapData.applyFilter() 方法。对 BitmapData 对象调用 applyFilter() 会取得源 BitmapData 对象和滤镜对象,并最终生成一个过滤图像。

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

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

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

flash.filters.GlowFilterflash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.DisplayObject.scaleXflash.display.DisplayObject.scaleYflash.filters.DropShadowFilter.distanceflash.filters.DropShadowFilter.angleGlowFilter 构造函数。color0xFF0000光晕颜色,采用十六进制格式 0xRRGGBB。默认值为 0xFF0000。 alpha1.0颜色的 Alpha 透明度值。有效值为 0 到 1。例如,0.25 设置透明度值为 25%。 blurX4.0水平模糊量。有效值为 0 到 255(浮点)。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈示速度比其它值更快。 blurY4.0垂直模糊量。有效值为 0 到 255(浮点)。2 的乘方值(如 2、4、8、16 和 32)经过优化,呈示速度比其它值更快。 strength1印记或跨页的强度。该值越高,压印的颜色越深,而且发光与背景之间的对比度也越强。有效值为 0 到 255。 quality1应用滤镜的次数。使用 BitmapFilterQuality 常量:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

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

innerfalse指定发光是否为内侧发光。值 true 指定发光是内侧发光。值 false 指定发光是外侧发光(对象外缘周围的发光)。 knockoutfalse指定对象是否具有挖空效果。值为 true 将使对象的填充变为透明,并显示文档的背景颜色。
构造函数。
BitmapFilterQuality
clone 返回此滤镜对象的副本。具有原始 GlowFilter 实例的所有属性的新 GlowFilter 实例。 返回此滤镜对象的副本。 alpha 颜色的 Alpha 透明度值。1 颜色的 Alpha 透明度值。有效值为 0 到 1。例如,0.25 设置透明度值为 25%。 color 光晕颜色。0xFF0000 光晕颜色。有效值采用十六进制格式 0xRRGGBB。 inner 指定发光是否为内侧发光。false 指定发光是否为内侧发光。值 true 表示内侧发光。默认值为 false,即外侧发光(对象外缘周围的发光)。