ConvolutionFilter

包	spark.filters
类	public class ConvolutionFilter
继承	ConvolutionFilter BaseFilter EventDispatcher Object
实现	IBitmapFilter

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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 像素。）例如，如果在放大某大型影片剪辑时应用了滤镜，则所得图像超过最大尺寸时，将关闭该滤镜。

MXML 语法

隐藏 MXML 语法

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"
 />

查看示例

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		alpha : Number 颜色的 Alpha 透明度值。	ConvolutionFilter
		bias : Number 要添加到矩阵转换结果中的偏差量。	ConvolutionFilter
		clamp : Boolean 表示是否应锁定图像。	ConvolutionFilter
		color : uint 光晕颜色。	ConvolutionFilter
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		divisor : Number 矩阵转换中使用的除数。	ConvolutionFilter
		matrix : Array 水平模糊量。	ConvolutionFilter
		matrixX : Number 矩阵的 x 维度（矩阵中的行数）。	ConvolutionFilter
		matrixY : Number 矩阵的 y 维度（矩阵中的列数）。	ConvolutionFilter
		preserveAlpha : Boolean 表示是否已保留 Alpha 通道并且不使用滤镜效果，或是否对 Alpha 通道以及颜色通道应用卷积滤镜。	ConvolutionFilter

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		ConvolutionFilter(matrixX:Number = 0, matrixY:Number = 0, matrix:Array = null, divisor:Number = 1.0, bias:Number = 0.0, preserveAlpha:Boolean = true, clamp:Boolean = true, color:uint = 0, alpha:Number = 0.0) 构造函数。	ConvolutionFilter
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		clone():BitmapFilter 返回此滤镜对象的副本。	ConvolutionFilter
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		notifyFilterChanged():void 过滤器更改后传播更改事件。	BaseFilter
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	事件		摘要	由以下参数定义
		activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
		deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义

属性详细信息

alpha

属性

alpha:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

颜色的 Alpha 透明度值。有效值为 0 到 1。例如，0.25 设置透明度值为 25%。

默认值为 1。

实现
public function get alpha():Number
public function set alpha(value:Number):void

bias

属性

bias:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

要添加到矩阵转换结果中的偏差量。偏差可增加每个通道的颜色值，以便暗色变得较明亮。

默认值为 0。

实现
public function get bias():Number
public function set bias(value:Number):void

clamp

属性

clamp:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

表示是否应锁定图像。对于源图像之外的像素，如果值为 true，则表明通过复制输入图像每个相应的边缘处的颜色值，沿着输入图像的每个边框按需要扩展输入图像。如果值为 false，则表明应按照 color 和 alpha 属性中的指定使用其它颜色。

默认值为 true。

实现
public function get clamp():Boolean
public function set clamp(value:Boolean):void

color

属性

color:uint

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

光晕颜色。有效值采用十六进制格式 0xRRGGBB。

默认值为 0xFF0000。

实现
public function get color():uint
public function set color(value:uint):void

divisor

属性

divisor:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

矩阵转换中使用的除数。默认值为 1。如果除数是所有矩阵值的总和，则可调平结果的总体色彩强度。忽略 0 值，此时使用默认值。

默认值为 1.0。

实现
public function get divisor():Number
public function set divisor(value:Number):void

matrix

属性

matrix:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

默认值为 []。

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

matrixX

属性

matrixX:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

矩阵的 x 维度（矩阵中的行数）。

默认值为 0。

实现
public function get matrixX():Number
public function set matrixX(value:Number):void

matrixY

属性

matrixY:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

矩阵的 y 维度（矩阵中的列数）。

默认值为 0。

实现
public function get matrixY():Number
public function set matrixY(value:Number):void

preserveAlpha

属性

preserveAlpha:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

表示是否已保留 Alpha 通道并且不使用滤镜效果，或是否对 Alpha 通道以及颜色通道应用卷积滤镜。值为 false 表示卷积应用于所有通道，包括 Alpha 通道。值为 true 表示只对颜色通道应用卷积。

默认值为 true。

实现
public function get preserveAlpha():Boolean
public function set preserveAlpha(value:Boolean):void

构造函数详细信息

()

构造函数

public function ConvolutionFilter(matrixX:Number = 0, matrixY:Number = 0, matrix:Array = null, divisor:Number = 1.0, bias:Number = 0.0, preserveAlpha:Boolean = true, clamp:Boolean = true, color:uint = 0, alpha:Number = 0.0)

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

参数

	`matrixX:Number` (default = `0`) — 矩阵的 x 维度（矩阵中列的数目）。默认值为 0。

	`matrixY:Number` (default = `0`) — 矩阵的 y 维度（矩阵中行的数目）。默认值为 0。

	`matrix:Array` (default = `null`) — 用于矩阵转换的值的数组。数组中的项数必须等于 `matrixX * matrixY`。

	`divisor:Number` (default = `1.0`) — 矩阵转换中使用的除数。默认值为 1。如果除数是所有矩阵值的总和，则可调平结果的总体色彩强度。忽略 0 值，此时使用默认值。

	`bias:Number` (default = `0.0`) — 要添加到矩阵转换结果的偏差。默认值为 0。

	`preserveAlpha:Boolean` (default = `true`) — `false` 值表示未保留 Alpha 值，并且卷积适用于所有通道（包括 Alpha 通道）。值为 `true` 表示只对颜色通道应用卷积。默认值为 `true`。

	`clamp:Boolean` (default = `true`) — 对于源图像之外的像素，如果值为 `true`，则表明通过复制输入图像给定边缘处的颜色值，沿着输入图像的每个边框按需要扩展输入图像。如果值为 `false`，则表明应按照 `color` 和 `alpha` 属性中的指定使用其他颜色。默认值为 `true`。

	`color:uint` (default = `0`) — 要替换源图像之外的像素的十六进制颜色。

	`alpha:Number` (default = `0.0`) — 替换颜色的 Alpha。

方法详细信息

clone

()

方法

public function clone():BitmapFilter

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

返回此滤镜对象的副本。

BitmapFilter — BitmapFilter，与原始 ConvolutionMatrixFilter 实例具有完全相同的属性的新 ConvolutionFilter 实例。

示例如何使用本示例

ConvolutionFilterExample.mxml

<?xml version="1.0"?>
<!-- filters/examples/ConvolutionGlowFilterExample .mxml -->
<s:Application 
    xmlns:fx="http://ns.adobe.com/mxml/2009" 
    xmlns:mx="library://ns.adobe.com/flex/mx" 
    xmlns:s="library://ns.adobe.com/flex/spark" 
    creationComplete="createFilters()">
    
  <fx:Script><![CDATA[ 
     import spark.filters.*;
     import flash.filters.BitmapFilterQuality;
     import flash.filters.BitmapFilterType;
  
     private var myOutlineConvolutionFilter:ConvolutionFilter;  
     private var mySharpnessConvolutionFilter:ConvolutionFilter;  
     private var myBrightnessConvolutionFilter:ConvolutionFilter;  

     private var outlineMatrix:Array = [    -30, 30, 0,
                                                          -30, 30, 0,
                                                          -30, 30, 0 ];

     private var sharpnessMatrix:Array = [0, -1, 0,
                                                          -1, 20, -1,
                                                          0, -1, 0];

     private var brightnessMatrix:Array = [2, 2, 2,
                                                          2, 0, 2, 
                                                          2, 2, 2];
             
     public function createFilters():void {        
        myOutlineConvolutionFilter = new ConvolutionFilter(3, 3, outlineMatrix, 9, 0, true, true, 0x00CC99, 0);
        mySharpnessConvolutionFilter = new ConvolutionFilter(3, 3, sharpnessMatrix, 9, 0, true, true, 0x00CC99, 0);
        myBrightnessConvolutionFilter = new ConvolutionFilter(3, 3, brightnessMatrix, 3, 0, true, true, 0x00CC99, 0);

        outlineImage.filters = [myOutlineConvolutionFilter];
        sharpnessImage.filters = [mySharpnessConvolutionFilter];
        brightnessImage.filters = [myBrightnessConvolutionFilter];
     }
  
  ]]></fx:Script>

    <s:VGroup>
        <s:VGroup>
            <s:Label text="Original Image"/>
            <mx:Image id="originalImage" source="@Embed(source='assets/Nokia_6630.png')"/>
        </s:VGroup>        

        <s:VGroup>
            <s:Label text="Outline Matrix Image"/>
            <mx:Image id="outlineImage" source="@Embed(source='assets/Nokia_6630.png')"/>
        </s:VGroup>        

        <s:VGroup>
            <s:Label text="Sharpness Matrix Image"/>
            <mx:Image id="sharpnessImage" source="@Embed(source='assets/Nokia_6630.png')"/>
        </s:VGroup>        

        <s:VGroup>
            <s:Label text="Brightness Matrix Image"/>
            <mx:Image id="brightnessImage" source="@Embed(source='assets/Nokia_6630.png')"/>
        </s:VGroup>        
    </s:VGroup>        
</s:Application>

法律声明 | 在线隐私策略

ConvolutionFilter - AS3 Flex

类 x

alpha

bias

clamp

color

divisor

matrix

matrixX

matrixY

preserveAlpha

ConvolutionFilter

clone