BitmapData コンストラクタ

public BitmapData(width: Number , height: Number , [transparent: Boolean ], [fillColor: Number ])

指定された幅と高さで BitmapData オブジェクトを作成します。fillColor パラメータに値を指定した場合、ビットマップのすべてのピクセルにその色が設定されます。

transparent パラメータに false を渡さない限り、デフォルトではビットマップが透明として作成されます。不透明のビットマップを作成した後、それを透明のビットマップに変更することはできません。不透明のビットマップに含まれるすべてのピクセルは、24 ビットのカラーチャンネル情報だけを使用します。ビットマップを transparent と定義した場合、すべてのピクセルは、アルファ透明チャンネルを含む 32 ビットのカラーチャンネル情報を使用します。

BitmapData オブジェクトの最大の幅と高さは 2880 ピクセルです。width または height に 2880 よりも大きい値を指定すると、新しいインスタンスは作成されません。

パラメータ

width:Number - ビットマップイメージの幅 (ピクセル単位) です。

height:Number - ビットマップイメージの高さ (ピクセル単位) です。

transparent:Boolean (オプション) - ビットマップイメージがピクセル単位の透明度をサポートするかどうかを定義します。デフォルト値は true です (透明)。完全に透明なビットマップを作成するには、transparent パラメータの値を true に、fillColor パラメータの値を 0x00000000 (または 0) に設定します。

fillColor:Number (オプション) - ビットマップイメージ領域を塗りつぶすのに使用する 32 ビット ARGB カラー値です。デフォルト値は 0xFFFFFFFF (白) です。

例

次の例では、新しい BitmapData オブジェクトを作成します。この例で使用する値は、transparent パラメータと fillColor パラメータのデフォルト値です。こうしたパラメータがなくても、コンストラクタを呼び出して、同じ結果を得ることができます。

import flash.display.BitmapData;

var width:Number = 100;
var height:Number = 80;
var transparent:Boolean = true;
var fillColor:Number = 0xFFFFFFFF;

var bitmap_1:BitmapData = new BitmapData(width, height, transparent, fillColor);

trace(bitmap_1.width); // 100
trace(bitmap_1.height); // 80
trace(bitmap_1.transparent); // true

var bitmap_2:BitmapData = new BitmapData(width, height);

trace(bitmap_2.width); // 100
trace(bitmap_2.height); // 80
trace(bitmap_2.transparent); // true