BITMAP

typedef struct tagBITMAP { /* bm */

LONG bmType;

LONG bmWidth;

LONG bmHeight;

LONG bmWidthBytes;

WORD bmPlanes;

WORD bmBitsPixel;

LPVOID bmBits;

} BITMAP;

The BITMAP structure defines the type, width, height, color format, and bit values of a bitmap.

Members

bmType

Specifies the bitmap type. This member must be zero.

bmWidth

Specifies the width (in pixels) of the bitmap. The width must be greater than zero.

bmHeight

Specifies the height (in pixels) of the bitmap. The height must be greater than zero.

bmWidthBytes

Specifies the number of bytes in each scan line. This value must be divisible by four since Windows assumes that the bit values of a bitmap form an array that is dword aligned.

bmPlanes

Specifies the count of color planes.

bmBitsPixel

Specifies the number of bits required to indicate the color of a pixel.

bmBits

Points to the location of the bit values for the bitmap. The bmBits member must be a long pointer to an array of character (one-byte) values.

Comments

The currently used bitmap formats are monochrome and color. The monochrome bitmap uses a one-bit, one-plane format. Each scan is a multiple of 32 bits.

Scans are organized as follows for a monochrome bitmap of height n:

Scan 0

Scan 1

.

.

.

Scan n-2

Scan n-1

The pixels on a monochrome device are either black or white. If the corresponding bit in the bitmap is 1, the pixel is set to the foreground color.; if the corresponding bit in the bitmap is zero, the pixel is set to the background color.

All devices that have the RC_BITBLT bit set in the device capabilities support bitmaps.

Each device has its own unique color format. In order to transfer a bitmap from one device to another, use GetDIBits and SetDIBits.

See Also

CreateBitmapIndirect, GetDIBits, GetObject, SetDIBits