ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / Core Component API Reference / Core Component Functions Reference / Display Functions / IG_dspl_palette_get
In This Topic
    IG_dspl_palette_get
    In This Topic

    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++.

    Sample:

    Medical, MFC

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