ImageGear for C and C++ on Windows v19.1 - Updated
IG_FX_pointillist
API Reference Guide > Core Component API Reference > Core Component Functions Reference > FX Functions > IG_FX_pointillist

This function applies an effect to an image that makes it appear to have been painted in the pointillism style of painting.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_FX_pointillist(
        HIGEAR  hIGear, 
        AT_INT pointSize,
        AT_INT pointType, 
        AT_INT smoothness, 
        HIGPIXEL hColor
);

Arguments:

Name Type Description
hIGear HIGEAR Image to which to apply pointillist effect.
pointSize AT_INT Average size of each point (in pixels).
pointType AT_INT Type of brush to use for each point. Determines the shape of the point.
smoothness AT_INT Smoothness factor for each point. This value typically ranges from 0 to 100.
hColor HIGPIXEL Specifies a background color to use. If this parameter is null, all points fit together smoothly with no gaps. If this parameter specifies a background a color, there are some occasional gaps which are set to the specified background color. The color should have the same color space and channel depths as the image to which the effect is applied.

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++, except:
Indexed RGB – 1 bpp;
Grayscale – 1 bpp.

The smoothness parameter is ignored for:
Indexed RGB with non-grayscale palette.
Images that have a Grayscale LUT attached to them.

Sample:

Image Processing

Remarks:

The painted points are randomly generated, hence creating a slightly different look to the image each time the method is applied with the exact same settings.