BITMAP Structure

The latest version of this topic can be found at BITMAP Structure.

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

Syntax

typedef struct tagBITMAP {  /* bm */  
    int bmType;  
    int bmWidth;  
    int bmHeight;  
    int bmWidthBytes;  
    BYTE bmPlanes;  
    BYTE bmBitsPixel;  
    LPVOID bmBits;  
} BITMAP;  

Parameters

bmType
Specifies the bitmap type. For logical bitmaps, this member must be 0.

bmWidth
Specifies the width of the bitmap in pixels. The width must be greater than 0.

bmHeight
Specifies the height of the bitmap in raster lines. The height must be greater than 0.

bmWidthBytes
Specifies the number of bytes in each raster line. This value must be an even number since the graphics device interface (GDI) assumes that the bit values of a bitmap form an array of integer (2-byte) values. In other words, bmWidthBytes * 8 must be the next multiple of 16 greater than or equal to the value obtained when the bmWidth member is multiplied by the bmBitsPixel member.

bmPlanes
Specifies the number of color planes in the bitmap.

bmBitsPixel
Specifies the number of adjacent color bits on each plane needed to define 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 1-byte values.

Remarks

The currently used bitmap formats are monochrome and color. The monochrome bitmap uses a 1-bit, 1-plane format. Each scan is a multiple of 16 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 turned on (white). If the corresponding bit in the bitmap is 0, the pixel is turned off (black).

All devices support bitmaps that have the RC_BITBLT bit set in the RASTERCAPS index of the CDC::GetDeviceCaps member function.

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

Requirements

Header: wingdi.h

See Also

Structures, Styles, Callbacks, and Message Maps
CBitmap::CreateBitmapIndirect