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_dithering_set
In This Topic
    IG_dspl_dithering_set
    In This Topic

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

     

     

    ©2025 Accusoft Corporation. All Rights Reserved.

    Get Product Support