ImageGear for C and C++ on Linux - Updated
IG_dspl_palette_get
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Display Functions > IG_dspl_palette_get

This function returns the current palette settings.

Declaration:

 
Copy Code
AT_ERRCOUNT  ACCUAPI  IG_dspl_palette_get(
        [IN] HIGEAR hIGear,
        [IN] DWORD dwGrpID,
        [OUT] LPAT_MODE lpnPalMode,
        [OUT] HPALETTE FAR* lphPalette
);

Arguments:

Name Type Description
hIGear HIGEAR ImageGear handle of image.
dwGrpID DWORD Identifier of group from which to get palette options.
lpnPalMode LPAT_MODE Pointer to where PaletteMode is to be received. If NULL, then this parameter is ignored.
lphPalette HPALETTE FAR* Pointer to where DevicePalette is to be received. If NULL, then this parameter is ignored.

Return Value:

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

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Example:

 
Copy Code
HIGEAR            hIGear;      /* HIGEAR handle of image   */
DWORD           nGrpID;      /* display group identifier  */
AT_MODE         nPalMode;    /* palette mode  */
HPALETTE                 hPalette;    /* palette handle */
 ...
IG_dspl_palette_get( hIGear, nGrpID, &nPalMode, &hPalette );
 ...