MACROMEDIA FLASH 8-EXTENDING FLASH, Manual

Page: 43 / 554

BitmapInstance object 43
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 Flash JavaScript, see
Chapter 3, “C-Level Extensibility.”
Description
Method; lets you create bitmap effects by getting the bits out of the bitmap, manipulating
them, and then returning them to Flash. See also
bitmapInstance.setBits()
.
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:
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);
}
See also
bitmapInstance.setBits()
bitmapInstance.hPixels
Availability
Flash MX 2004.
Usage
bitmapInstance.hPixels
Description
Read-only property; an integer that represents the width of the bitmap—that is, the number
of pixels in the horizontal dimension.