[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
Display Independant BitmapInfo ( DIB )
------------------------------------------------------------------------------
DESCRIPTION:
The BITMAPINFO structure fully defines the dimensions and color info
for a Windows device-independent bitmap (DIB).
Member Description
bmiHeader Specifies a BITMAPINFOHEADER structure that contains
information about the dimensions and color format of a DIB
bmiColors Specifies an (c)array of RGBQUAD structures that define the
colors in the bitmap.
A Windows 3.0 or later DIB consists of two distinct parts: a BITMAPINFO
structure, which describes the dimensions and colors of the bitmap, and
an array of bytes defining the pixels of the bitmap. The bits in the
array are packed together, but each scan line must be zero-padded to end
on a LONG boundary. Segment boundaries, however, can appear anywhere in
the bitmap. The origin of the bitmap is the lower-left corner.
The biBitCount member of the BITMAPINFOHEADER structure determines the
number of bits which define each pixel and the maximum number of colors
in the bitmap. This member may be set to any of the following values:
Value Meaning
1 The bitmap is monochrome, and the bmciColors member must
contain two entries. Each bit in the bitmap array represents a
pixel. If the bit is clear, the pixel is displayed with the
color of the first entry in the bmciColors table. If the bit is
set, the pixel has the color of the second entry in the table.
4 The bitmap has a maximum of 16 colors, and the bmciColors
member contains 16 entries. Each pixel in the bitmap is
represented by a four-bit index into the color table. For
example, if the first byte in the bitmap is 0x1F, the byte
represents two pixels. The first pixel contains the color in
the second table entry, and the second pixel contains the color
in the sixteenth table entry.
8 The bitmap has a maximum of 256 colors, and the bmciColors
member contains 256 entries. In this case, each byte in the
array represents a single pixel.
24 The bitmap has a maximum of 224 colors. The bmciColors member
is zero, and each 3-byte sequence in the bitmap array represents
the relative intensities of red, green and blue, respectively,
of a pixel.
The biClrUsed member of the BITMAPINFOHEADER structure specifies the
number of color indexes in the color table actually used by the bitmap.
If the biClrUsed member is set to zero, the bitmap uses the maximum
number of colors corresponding to the value of the biBitCount member.
The colors in the bmiColors table should appear in order of importance.
Alternatively, for functions that use DIBs, the bmiColors member can be
an array of 16-bit unsigned integers that specify an index into the
currently realized logical palette instead of explicit RGB values.
In this case, an application using the bitmap must call DIB functions
with the wUsage parameter set to DIB_PAL_COLORS.
Note: The bmiColors member should not contain palette indexes if the
bitmap is to be stored in a file or transferred to another application.
Unless the application uses the bitmap exclusively and under its
complete control, the bitmap color table should contain explicit RGB
values.
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson