LPRGBQUAD pPalette (with CRF_OPTIMIZEDPALETTE)

The palette that you supply is an array of RGBQUAD values. The RGBQUAD structure (defined in WINDOWS.H) has four one-byte fields as follows:

rgbBlue
rgbGreen
rgbRed
rgbReserved

L_ColorResBitmap which maps the bitmap's pixel values to the palette entries, can also fill in some of the entries with optimized colors if you specify CRF_OPTIMIZEDPALETTE in the uFlags parameter. In the last field of the RGBQUAD structure (rgbReserved), you can enter the following flags to control whether the function fills in the entry and whether it maps any pixel values to the entry:

Value

Meaning

RGB_RESERVED

[0x01] Do not map any pixel values to this entry. Use this flag if you want to reserve the entry for later use.

RGB_EMPTY

[0x02] Let the function fill in the color. The function supplies optimized colors to fill the RGB_EMPTY entries, and it maps pixel values to the entries.

0

Map pixel values to the color that you supply.