ImageGear for C and C++ on Linux v20.0 - Updated
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Palette Functions > IG_palette_get

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


Copy Code
        HIGEAR hIGear, 
        LPAT_RGBQUAD lpPalette


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.


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 );


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().

Is this page helpful?
Yes No
Thanks for your feedback.