PALETTERGB

3.0

  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.

Parameters

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.

Return Value

The return value specifies a palette-relative RGB value.

Comments

The PALETTERGB macro is defined in WINDOWS.H as follows:

#define PALETTERGB(r,g,b)   (0x02000000L | RGB(r,g,b))

See Also

PALETTEINDEX, RGB