パッケージflash.geom
public class ColorTransform
継承ColorTransform Inheritance Object

ColorTransform クラスを使用すると、表示オブジェクトのカラー値を調整することができます。カラー調整、つまり "カラー変換" は、赤、緑、青、アルファ透明度の 4 つのチャネルすべてに適用できます。

ColorTransform オブジェクトを表示オブジェクトに適用するときに、各カラーチャネルの新しい値を算出する方法は次のとおりです。

算出後、カラーチャネル値が 255 よりも大きい場合は 255 に設定されます。0 より小さい場合は 0 に設定されます。

ColorTransform オブジェクトは次のように使用できます。

ColorTransform オブジェクトのメソッドを呼び出すには、コンストラクタ new ColorTransform() を使用して ColorTransform オブジェクトを作成する必要があります。

カラー変換は、ムービークリップ (ロードした SWF オブジェクトなど) の背景色には適用されません。ムービークリップに割り当てられているグラフィックとシンボルにのみ適用されます。

関連項目

flash.geom.Transform
flash.display.DisplayObject.transform
flash.display.BitmapData.colorTransform()


パブリックプロパティ
 プロパティ定義
  alphaMultiplier : Number
アルファ透明度チャネル値に乗算する 10 進数値です。
ColorTransform
  alphaOffset : Number
アルファ透明度チャネル値に alphaMultiplier 値を乗算した後に加算する数値です。数値の範囲は -255 ~ 255 です。
ColorTransform
  blueMultiplier : Number
青チャネル値に乗算する 10 進数値です。
ColorTransform
  blueOffset : Number
青チャネル値に blueMultiplier 値を乗算した後に加算する数値です。数値の範囲は -255 ~ 255 です。
ColorTransform
  color : uint
ColorTransform オブジェクトの RGB カラー値です。
ColorTransform
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  greenMultiplier : Number
緑チャネル値に乗算する 10 進数値です。
ColorTransform
  greenOffset : Number
緑チャネル値に greenMultiplier 値を乗算した後に加算する数値です。数値の範囲は -255 ~ 255 です。
ColorTransform
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  redMultiplier : Number
赤チャネル値に乗算する 10 進数値です。
ColorTransform
  redOffset : Number
赤チャネル値に redMultiplier 値を乗算した後に加算する数値です。数値の範囲は -255 ~ 255 です。
ColorTransform
パブリック Methods
 メソッド定義
  
ColorTransform(redMultiplier:Number = 1.0, greenMultiplier:Number = 1.0, blueMultiplier:Number = 1.0, alphaMultiplier:Number = 1.0, redOffset:Number = 0, greenOffset:Number = 0, blueOffset:Number = 0, alphaOffset:Number = 0)
指定されたカラーチャネル値とアルファ値を持つ ColorTransform オブジェクトを作成します。
ColorTransform
  
second パラメータで指定された ColorTranform オブジェクトと現在の ColorTransform オブジェクトを連結し、2 つのカラー変換を加算的に組み合わせた結果を現在のオブジェクトに設定します。
ColorTransform
 Inherited
指定されたプロパティがオブジェクトに定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
ColorTransform オブジェクトのすべてのプロパティが列挙されたストリングを書式設定して返します。
ColorTransform
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
プロパティの詳細
alphaMultiplierプロパティ
public var alphaMultiplier:Number

アルファ透明度チャネル値に乗算する 10 進数値です。

DisplayObject インスタンスの alpha プロパティを使用して表示オブジェクトのアルファ透明度の値を直接設定すると、その表示オブジェクトの transform.colorTransform プロパティの alphaMultiplier プロパティ値に影響します。

関連項目

alphaOffsetプロパティ 
public var alphaOffset:Number

アルファ透明度チャネル値に alphaMultiplier 値を乗算した後に加算する数値です。数値の範囲は -255 ~ 255 です。

blueMultiplierプロパティ 
public var blueMultiplier:Number

青チャネル値に乗算する 10 進数値です。

blueOffsetプロパティ 
public var blueOffset:Number

青チャネル値に blueMultiplier 値を乗算した後に加算する数値です。数値の範囲は -255 ~ 255 です。

colorプロパティ 
color:uint  [read-write]

ColorTransform オブジェクトの RGB カラー値です。

このプロパティを設定すると、それに応じて 3 つのカラーオフセット値 (redOffsetgreenOffsetblueOffset) が設定され、3 つのカラー乗数値 (redMultipliergreenMultiplierblueMultiplier) が 0 に設定されます。アルファ透明度の乗数値とオフセット値は変わりません。

このプロパティに値を渡す場合は、書式 0xRRGGBB を使用します。RRGG、および BB はそれぞれ、各カラー成分のオフセットを指定する 2 桁の 16 進数で構成されます。0x は、数値が 16 進数であることを ActionScript コンパイラに伝えるものです。

実装
    public function get color():uint
    public function set color(value:uint):void
greenMultiplierプロパティ 
public var greenMultiplier:Number

緑チャネル値に乗算する 10 進数値です。

greenOffsetプロパティ 
public var greenOffset:Number

緑チャネル値に greenMultiplier 値を乗算した後に加算する数値です。数値の範囲は -255 ~ 255 です。

redMultiplierプロパティ 
public var redMultiplier:Number

赤チャネル値に乗算する 10 進数値です。

redOffsetプロパティ 
public var redOffset:Number

赤チャネル値に redMultiplier 値を乗算した後に加算する数値です。数値の範囲は -255 ~ 255 です。

コンストラクタの詳細
ColorTransform()コンストラクタ
public 関数 ColorTransform(redMultiplier:Number = 1.0, greenMultiplier:Number = 1.0, blueMultiplier:Number = 1.0, alphaMultiplier:Number = 1.0, redOffset:Number = 0, greenOffset:Number = 0, blueOffset:Number = 0, alphaOffset:Number = 0)

指定されたカラーチャネル値とアルファ値を持つ ColorTransform オブジェクトを作成します。

パラメータ
redMultiplier:Number (default = 1.0) — 赤の乗数の値 (0 ~ 1) です。
 
greenMultiplier:Number (default = 1.0) — 緑の乗数の値 (0 ~ 1) です。
 
blueMultiplier:Number (default = 1.0) — 青の乗数の値 (0 ~ 1) です。
 
alphaMultiplier:Number (default = 1.0) — アルファ透明度の乗数の値 (0 ~ 1) です。
 
redOffset:Number (default = 0) — 赤のカラーチャネルのオフセット値 (-255 ~ 255) です。
 
greenOffset:Number (default = 0) — 緑のカラーチャネルのオフセット値 (-255 ~ 255) です。
 
blueOffset:Number (default = 0) — 青のカラーチャネルのオフセット値 (-255 ~ 255) です。
 
alphaOffset:Number (default = 0) — アルファ透明度のチャネル値のオフセット (-255 ~ 255) です。
メソッドの詳細
concat()メソッド
public function concat(second:ColorTransform):void

second パラメータで指定された ColorTranform オブジェクトと現在の ColorTransform オブジェクトを連結し、2 つのカラー変換を加算的に組み合わせた結果を現在のオブジェクトに設定します。連結された ColorTransform オブジェクトを適用する場合、その効果は second のカラー変換を元のカラー変換の後に適用した場合と同じです。

パラメータ
second:ColorTransform — 現在の ColorTransform オブジェクトと結合する ColorTransform オブジェクトです。
toString()メソッド 
public function toString():String

ColorTransform オブジェクトのすべてのプロパティが列挙されたストリングを書式設定して返します。

戻り値
String — ColorTransform オブジェクトのすべてのプロパティを列挙するストリングです。