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

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_IP_color_reduce_halftone ( 
        HIGEAR hIGear, 
        AT_MODE nOption 
);

Arguments:

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.

Example:

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

Remarks:

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.