This function reduces a 24-bit image to an 8-bit image while retaining its most popular, or prevalent, colors.

Declaration:

AT_ERRCOUNT ACCUAPI IG_IP_color_reduce_popularity ( 
        HIGEAR hIGear, 
        BOOL bFastRemap, 
        UINT nMaxColors 
);

Arguments:

Return Value:

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

Supported Raster Image Formats:

RGB – 24 bpp.

Sample:

None

Example:

HIGEAR hIGear;     /* HIGEAR handle of image */
/* Reduce to 64 colors using octree algorithm   */
IG_IP_color_reduce_popularity ( hIGear, FALSE, 64 );

Remarks:

Use nMaxColors to specify the maximum number of colors wanted in the result.