BitmapData 類別 (在 flash.display 套件中) 可以比喻為包含在已載入或動態建立的點陣圖影像中,像素的相片快照。此快照是由物件中的像素資料陣列所呈現。BitmapData 類別也包含一系列的內建方法,這些方法對於建立和操作像素資料非常有用。
若要初始化 BitmapData 物件,請使用下列程式碼:
var myBitmap:BitmapData = new BitmapData(width:Number, height:Number, transparent:Boolean, fillColor:uinit);
width
和
height
參數會指定點陣圖的大小。從 AIR 3 和 Flash Player 11 開始,已移除 BitmapData 物件的大小限制。點陣圖的大小上限取決於作業系統。
在 AIR 1.5 和 Flash Player 10 中,BitmapData 物件的大小上限為 8,191 像素寬度或高度,且像素總計不得超過 16,777,215 像素 (因此,如果 BitmapData 物件的寬度為 8,191 像素,則其高度上限為 2,048 像素)。若為 Flash Player 9 和 AIR 1.1 及其更早版本,高度和寬度的上限都是 2,880 像素。
transparent
參數會指定點陣圖資料是 (
true
) 否 (
false
) 包括 Alpha 色版。
fillColor
參數是 32 位元顏色值,它會指定背景顏色及透明度值 (如果已經設定為
true
)。下列範例會建立 BitmapData 物件,並設定具有 50% 透明度的橘色背景:
var myBitmap:BitmapData = new BitmapData(150, 150, true, 0x80FF3300);
若要在螢幕上顯示新建立的 BitmapData 物件,請將它指定給 Bitmap 實體,或將它包裝在 Bitmap 實體中。若要這麼做,您可以將 BitmapData 物件當做 Bitmap 物件之建構函式的參數來傳遞,或是可以將它指定給現有之 Bitmap 實體的
bitmapData
屬性。您也必須呼叫容納 Bitmap 實體之顯示物件容器的
addChild()
或
addChildAt()
方法,將 Bitmap 實體加入顯示清單。如需有關使用顯示清單的詳細資訊,請參閱
將顯示物件加入顯示清單
。
下列範例會建立 BitmapData 物件並以紅色做為填色,再將它顯示在 Bitmap 實體中:
var myBitmapDataObject:BitmapData = new BitmapData(150, 150, false, 0xFF0000);
var myImage:Bitmap = new Bitmap(myBitmapDataObject);
addChild(myImage);