COLORREF PALETTERGB(cRed, cGreen, cBlue) | |||||
BYTE cRed; | /* red component of palette-relative RGB | */ | |||
BYTE cGreen; | /* green component of palette-relative RGB | */ | |||
BYTE cBlue; | /* blue component of palette-relative RGB | */ |
The PALETTERGB macro accepts three values representing relative intensities of red, green, and blue and returns a value consisting of 2 in the high-order byte and an RGB value in the three low-order bytes. This is called a palette-relative RGB specifier. An application using a color palette can pass this specifier instead of an explicit RGB value to functions that expect a color.
For output devices that support logical palettes, Windows matches a palette-relative RGB value to the nearest color in the logical palette of the device context as though the application had specified an index to that palette entry. If an output device does not support a system palette, then Windows uses the palette-relative RGB as though it were a conventional RGB doubleword returned by the RGB macro.
cRed
Specifies the intensity of the red color field.
cGreen
Specifies the intensity of the green color field.
cBlue
Specifies the intensity of the blue color field.
The return value specifies a palette-relative RGB value.
The PALETTERGB macro is defined in WINDOWS.H as follows:
#define PALETTERGB(r,g,b) (0x02000000L | RGB(r,g,b))