ImageGear for C and C++ on Windows v19.7 - Updated
IG_dspl_dithering_set
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Display Functions > IG_dspl_dithering_set

This function sets new dithering options.

Declaration:

 
Copy Code
AT_ERRCOUNT  ACCUAPI   IG_dspl_dithering_set(
        [IN] HIGEAR hIGear,
        [IN] DWORD dwGrpID,
        [IN] AT_MODE nDitherFlags
);

Arguments:

hIGear ImageGear handle of image.
dwGrpID Identifier of group from which to set dithering.
nDitherFlags

New value of DitherMode to set. Possible values include:

  • IG_DSPL_DITHER_AUTO
  • IG_DSPL_DITHER_TO_8BPP
  • IG_DSPL_DITHER_TO_4BPP
  • IG_DSPL_DITHER_TO_1BPP
  • IG_DSPL_DITHER_NONE

with OR combination from two flags:

  • IG_DSPL_DITHER_FIXED_PALETTE
  • IG_DSPL_DITHER_NETSCAPE_PALETTE

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:

MFC

Example:

 
Copy Code
HIGEAR   hIGear;    /* HIGEAR handle of image */ 
DWORD   nGrpID;    /* display group identifier  */
 ...
/* if device is palette based then dither to fixed palette */
IG_dspl_dithering_set( hIGear, nGrpID, IG_DSPL_DITHER_AUTO| IG_DSPL_DITHER_FIXED_PALETTE
);
 ...