bitmapInstance.getBits()

#### Availability

Flash MX 2004.

#### Usage

bitmapInstance.getBits()

#### Parameters

None.

#### Returns

An object that contains width, height, depth, bits, and, if the bitmap has a color table, cTab properties. The bits element is an array of bytes. The cTab element is an array of color values of the form "\#RRGGBB". The length of the array is the length of the color table.
The byte array is meaningful only when referenced by a DLL or shared library. You typically use it only when creating an extensible tool or effect. For information on creating DLLs for use with Animate JavaScript, see "C-Level Extensibility (../C-Level_Extensibility/About_extensibility.md)"

#### Description

Method; lets you create bitmap effects by getting the bits out of the bitmap, manipulating them, and then returning them to Animate.

#### Example

The following code creates a reference to the currently selected object; tests whether the object is a bitmap; and traces the height, width, and bit depth of the bitmap:

javascript

var isBitmap = fl.getDocumentDOM().selection[0].instanceType;

if(isBitmap == "bitmap"){

var bits = fl.getDocumentDOM().selection[0].getBits();

fl.trace("height = " + bits.height);

fl.trace("width = " + bits.width);

fl.trace("depth = " + bits.depth);

}

bitmapInstance.setBits() (../BitmapInstance_object/bitmapInstanc2.md)