ImageGear for C and C++ on Windows v20.0 - 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.

Sample:

None

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.
Is this page helpful?
Yes No
Thanks for your feedback.