ImageGear for C and C++ on Linux v20.0 - Updated
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Image Processing Functions > IG_IP_color_reduce_halftone


Copy Code
AT_ERRCOUNT ACCUAPI IG_IP_color_reduce_halftone ( 
        HIGEAR hIGear, 
        AT_MODE nOption 


Name Type Description
hIGear HIGEAR HIGEAR handle of image.
nOption AT_MODE Halftoning pattern - 0 for now (squares).

Return Value:

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

Supported Raster Image Formats:

Indexed RGB – 4, 8 bpp;
Grayscale – 4, 8 bpp;
RGB – 24 bpp.


Copy Code
HIGEAR hIGear;    /* HIGEAR handle of 4, 8, or 24 bit image */
/* Reduce to a 1-bit halftone image: */
IG_IP_color_reduce_halftone ( hIGear, 0 );


This function reduces a color or grayscale image to a 1 bit per pixel image suitable for use in half-toning. The resulting image will consist of small squares of varying sizes that will give the appearance of varying shades of gray.

See also the section in entitled Color Reduction.
Is this page helpful?
Yes No
Thanks for your feedback.