IG_palette

This function obtains the referenced image's DIB palette, storing it in your array of AT_RGBQUAD structs pointed to by lpPalette.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_palette_get ( HIGEAR hIGear, LPAT_RGBQUAD lpPalette );

Arguments:

Name	Type	Description
hIGear	HIGEAR	HIGEAR handle of image.
lpPalette	LPAT_RGBQUAD	Far pointer to the first of an array of AT_RGBQUAD structs sufficient to hold the entire palette from the image's DIB.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

Indexed RGB - 1…8 bpp.

Example:

	Copy Code
HIGEAR hIGear; /* HIGEAR handle of image / AT_ERRCOUNT nErrcount; / Returned count of errors on stack / AT_RGBQUAD rgbqPalette[256]; / Array of AT_RGBQUAD structs */ nErrcount = IG_palette_get ( hIGear, rgbqPalette );

Copy Code

HIGEAR hIGear;        /* HIGEAR handle of image     */
AT_ERRCOUNT nErrcount;      /* Returned count of errors on stack  */
AT_RGBQUAD rgbqPalette[256];  /* Array of AT_RGBQUAD structs    */
nErrcount = IG_palette_get ( hIGear, rgbqPalette );

Remarks:

The array must be large enough to hold the palette. For example, if an 8-bit image, lpPalette must point to the start of an array of 256 AT_RGBQUAD structs, therefore to an array of at least 256 x 4 = 1024 bytes. If the image is 24-bit, no error is set but no palette is returned.

See also function IG_palette_set() function.

To obtain an image's logical palette (the palette after mapping through the display LUTs, or for a 24-bit image the palette that would be used for displaying to an 8-bit device), use function IG_dspl_palette_create().