Packagespark.filters
Classpublic class ColorMatrixFilter
InheritanceColorMatrixFilter Inheritance BaseFilter Inheritance flash.events.EventDispatcher
Implements IBitmapFilter

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

The ColorMatrixFilter class lets you apply a 4 x 5 matrix transformation on the RGBA color and alpha values of every pixel in the input image to produce a result with a new set of RGBA color and alpha values. It allows saturation changes, hue rotation, luminance to alpha, and various other effects. 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.

MXML SyntaxexpandedHide MXML Syntax

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

See also

flash.filters.ColorMatrixFilter


Public Properties
 PropertyDefined By
  matrix : Object
A comma delimited list of 20 doubles that comprise a 4x5 matrix applied to the rendered element.
ColorMatrixFilter
Public Methods
 MethodDefined By
  
ColorMatrixFilter(matrix:Array = null)
Constructor.
ColorMatrixFilter
  
clone():BitmapFilter
Returns a copy of this filter object.
ColorMatrixFilter
 Inherited
Propagates a change event when the filter has changed.
BaseFilter
Public Constants
 ConstantDefined By
 InheritedCHANGE : String = change
[static] The string "change".
BaseFilter
Property Detail
matrixproperty
matrix:Object

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

A comma delimited list of 20 doubles that comprise a 4x5 matrix applied to the rendered element. The matrix is in row major order -- that is, the first five elements are multipled by the vector [srcR,srcG,srcB,srcA,1] to determine the output red value, the second five determine the output green value, etc.

The value must either be an array or comma delimited string of 20 numbers.

The default value is [1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0].


Implementation
    public function get matrix():Object
    public function set matrix(value:Object):void
Constructor Detail
ColorMatrixFilter()Constructor
public function ColorMatrixFilter(matrix:Array = null)

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Constructor.

Parameters
matrix:Array (default = null) — An array of 20 items arranged as a 4 x 5 matrix.
Method Detail
clone()method
public function clone():BitmapFilter

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Returns a copy of this filter object.

Returns
BitmapFilter — A new ColorMatrixFilter instance with all of the same properties as the original one.