Packagejp.naggg.geom
Classpublic dynamic class ColorMatrix
InheritanceColorMatrix Inheritance Object

ColorMatrixFilter で扱う 5 x 4 の行列を表現するクラスです. Array を拡張しており、0~19までのインデックスに行列の各要素を代入し計算します. なお、本クラス作成には多大なる資料を参考にしています(いいとこどり). TODO transformColor の精度

See also

http://www.tweenpix.net/blog/index.php?2005/09/21/532-colormatrixfilter
http://msdn.microsoft.com/msdnmag/issues/05/01/NETMatters/
http://www.codeproject.com/vb/net/colormatrix.asp
http://caseyrayl.wordpress.com/2007/04/11/more-than-meets-the-eye/
http://www.reflektions.com/miniml/template_permalink.asp?id=379
http://casualplay.net/blog/2005/11/_2_colormatrixfilter.html
http://casualplay.net/blog/2005/11/_colortransform.html
http://boostranking.net/flash_actionscript/Find-Edges-Filter-in-Flash-AS-3_-16972.aspx
http://www.gskinner.com/blog/archives/2005/09/flash_8_source.html
http://www.adobe.com/devnet/flash/articles/matrix_transformations_04.html


Public Methods
 MethodDefined By
  
ColorMatrix(... args)
ColorMatrix
  
adjustBrightness(value:Number = 0):void
輝度を調整します.-255 ~ +255 で指定します. 効果としては、現状の色データにその数値を加算・減算します. 対象が何であれ必ず、-255 では黒に +255 では白になります.
ColorMatrix
  
adjustContrast(value:Number):void
コントラストを調整します.-1.0 ~ +1.0 と%で指定します.
ColorMatrix
  
adjustHue(value:Number):void
色相を調整します.-180°~ +180°と変位を度数単位で指定します.
ColorMatrix
  
adjustLuminance(value:Number = 0):void
明度を調整します.-1.0 ~ +1.0 と%で指定し、 -1.0 では全体が均一に黒くなり、+1.0 では均一に白くなります.
ColorMatrix
  
adjustSaturation(value:Number):void
彩度を調整します.-1.0 ~ +1.0 と%で指定します. -1.0 は彩度がない状態でグレースケールとなります.
ColorMatrix
  
インスタンスを複製します.
ColorMatrix
  
colorize(rgb:uint, amount:Number = 1):void
特定色で着色します.
ColorMatrix
  
concat(matrix:ColorMatrix):void
行列と行列を結合します. 引数で渡された ColorMatrix インスタンスと自身とを結合します. 数学的に言えば、行列の積を行い、対象を右からかけることと一致します.
ColorMatrix
  
identity():void
各行列プロパティを null 変換になる値に設定します.
ColorMatrix
  
invert():void
色を反転させる行列にします.
ColorMatrix
  
sepiatone():void
セピア調にします.特定の色のセピア調にしたい場合は、colorizeメソッドを併用します.
ColorMatrix
  
setAlpha(value:Number = 1.0):void
透明度を設定します.0~1.0 と%で指定します.
ColorMatrix
  
toFilter():ColorMatrixFilter
ColorMatrixFilter へ変換します.
ColorMatrix
  
toString():String
文字列化します.20個の数値をすべて表示します.
ColorMatrix
  
transformColor(color:uint, transparent:Boolean = true):uint
ColorMatrix で表現される色相変換を、指定された色に適用します. 内部的には色を24ビットで扱うため、透明度が含まれない場合、transparent を false に設定します. その場合、内部的にはアルファチャンネルが 0xFF として扱います.
ColorMatrix
Constructor Detail
ColorMatrix()Constructor
public function ColorMatrix(... args)

Parameters
... args — 初期化で渡したい要素を引数で渡します(最大20個).
Method Detail
adjustBrightness()method
public function adjustBrightness(value:Number = 0):void

輝度を調整します.-255 ~ +255 で指定します. 効果としては、現状の色データにその数値を加算・減算します. 対象が何であれ必ず、-255 では黒に +255 では白になります.

Parameters

value:Number (default = 0) — 輝度 -255 ~ +255

adjustContrast()method 
public function adjustContrast(value:Number):void

コントラストを調整します.-1.0 ~ +1.0 と%で指定します.

Parameters

value:Number — コントラスト -1.0 ~ +1.0

adjustHue()method 
public function adjustHue(value:Number):void

色相を調整します.-180°~ +180°と変位を度数単位で指定します.

Parameters

value:Number — ズらす色相の量 -180°~ +180°

adjustLuminance()method 
public function adjustLuminance(value:Number = 0):void

明度を調整します.-1.0 ~ +1.0 と%で指定し、 -1.0 では全体が均一に黒くなり、+1.0 では均一に白くなります.

Parameters

value:Number (default = 0) — 明度 -1.0 ~ +1.0

adjustSaturation()method 
public function adjustSaturation(value:Number):void

彩度を調整します.-1.0 ~ +1.0 と%で指定します. -1.0 は彩度がない状態でグレースケールとなります.

Parameters

value:Number — 彩度 -1.0 ~ +1.0

clone()method 
public function clone():ColorMatrix

インスタンスを複製します.

Returns
ColorMatrix — 複製されたインスタンス
colorize()method 
public function colorize(rgb:uint, amount:Number = 1):void

特定色で着色します.

Parameters

rgb:uint — 色の値
 
amount:Number (default = 1) — 適用量、0~1.0 と%で指定

concat()method 
public function concat(matrix:ColorMatrix):void

行列と行列を結合します. 引数で渡された ColorMatrix インスタンスと自身とを結合します. 数学的に言えば、行列の積を行い、対象を右からかけることと一致します.

Parameters

matrix:ColorMatrix

identity()method 
public function identity():void

各行列プロパティを null 変換になる値に設定します.

invert()method 
public function invert():void

色を反転させる行列にします.

sepiatone()method 
public function sepiatone():void

セピア調にします.特定の色のセピア調にしたい場合は、colorizeメソッドを併用します.

setAlpha()method 
public function setAlpha(value:Number = 1.0):void

透明度を設定します.0~1.0 と%で指定します.

Parameters

value:Number (default = 1.0) — 0~1.0

toFilter()method 
public function toFilter():ColorMatrixFilter

ColorMatrixFilter へ変換します.

Returns
ColorMatrixFilter — インスタンスのパラメータから生成される ColorMatrixFilter.
toString()method 
public function toString():String

文字列化します.20個の数値をすべて表示します.

Returns
String
transformColor()method 
public function transformColor(color:uint, transparent:Boolean = true):uint

ColorMatrix で表現される色相変換を、指定された色に適用します. 内部的には色を24ビットで扱うため、透明度が含まれない場合、transparent を false に設定します. その場合、内部的にはアルファチャンネルが 0xFF として扱います.

Parameters

color:uint — 16進数で24ビット or 16ビット、16ビットなら transparent を指定します.
 
transparent:Boolean (default = true) — 上記の色に透明が含まれるかどうか、デフォルトは true.

Returns
uint — 変換された色、color で渡されたビット数で返します.