IG_dspl_dithering

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

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