flash.display paketi içindeki BitmapData sınıfı yüklenen veya dinamik olarak oluşturulan bir bitmap görüntüsü içerisindeki piksellerin fotografik anlık görüntüsüne benzetilebilir. Bu anlık görüntü, nesne içindeki piksel verilerinin dizisi ile ifade edilir. BitmapData sınıfı ayrıca piksel verisi oluşturma ve düzenleme için yardımcı olan bir dizi dahili yöntem içerir.
Bir BitmapData nesnesi oluşturmak için aşağıdaki kodu kullanın:
var myBitmap:BitmapData = new BitmapData(width:Number, height:Number, transparent:Boolean, fillColor:uinit);
Width
ve
height
parametreleri bitmap'in boyutunu belirler. AIR 3 ve Flash Player 11'den başlamak üzere, BitmapData nesnesine yönelik boyut sınırları kaldırıldı. Maksimum bitmap boyutu işletim sistemine bağlıdır.
AIR 1.5 ve Flash Player 10'da, bir BitmapData nesnesi için maksimum boyut genişlikte ve yükseklikte 8.191 pikseldir ve toplam piksel sayısı 16.777.215'i geçemez. (Bu nedenle, bir BitmapData nesnesi 8.191 piksel genişliğindeyse en fazla 2.048 piksel yüksekliğinde olabilir.) Flash Player 9 ve önceki sürümleri ile AIR 1.1 ve önceki sürümlerinde, sınırlama yükseklikte 2.880 piksel ve genişlikte 2.880 pikseldir.
transparent
parametresi, bitmap verisinin bir alfa kanalı içerip (
true
) içermeyeceğini (
false
) belirler.
fillColor
parametresi arka plan rengini ve saydamlık değerini (
true
değeri verilmişse) belirleyen 32-bit renk değeridir. Aşağıdaki örnek yüzde 50 oranında saydam turuncu arka plana sahip bir BitmapData nesnesi oluşturur:
var myBitmap:BitmapData = new BitmapData(150, 150, true, 0x80FF3300);
Yeni oluşturulan bir BitmapData nesnesini ekranda işlemek için, bir Bitmap örneğine atayın veya sarın. Bunu yapmak için, BitmapData nesnesini Bitmap nesnesinin yapıcısının bir parametresi olarak iletebilir veya varolan bir Bitmap örneğinin
bitmapData
özelliğine atayabilirsiniz. Ayrıca görüntüleme nesnesi kabının Bitmap örneği içeren
addChild()
veya
addChildAt()
yöntemlerini çağırarak görüntüleme listesine Bitmap örneğini de eklemeniz gerekir. Görüntüleme listesi ile çalışma hakkında daha fazla bilgi için,
Görüntüleme listesine görüntüleme nesneleri ekleme
bölümünü inceleyin.
Aşağıdaki örnek kırmızı dolgulu bir BitmapData nesnesi oluşturur ve bir Bitmap örneği içerisinde görüntüler.
var myBitmapDataObject:BitmapData = new BitmapData(150, 150, false, 0xFF0000);
var myImage:Bitmap = new Bitmap(myBitmapDataObject);
addChild(myImage);