ImageGear for C and C++ on Windows v19.1 - Updated
IG_IC_check_for_noise
API Reference Guide > ImageClean Component API Reference > ImageClean Component Functions Reference > IG_IC_check_for_noise

This function checks the image for the number of objects exceeding the size of the specified threshold value.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_IC_check_for_noise (
        HIGEAR hIGear,
        UINT nObjectSize, 
        LPUINT lpnObjectsAmount
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle of image.
nObjectSize UINT Object size threshold value.
lpnObjectsAmount LPUINT Pointer to variable to which to place the result.

Return Value:

If the function is successful, the return value is IGE_SUCCESS. If the function fails, the return value is the error count.

Supported Raster Image Formats:

Indexed RGB – 1 bpp.

Sample:

None

Remarks:

Object here means a connected group of black pixels. The object size is a diagonal of the minimum circumscribed rectangle that contains the object.

This function can be used to detect blank paper sheets in the scanner tray when the resulting image is almost clear and may contains only several black "noise" pixels.

Refer to the Component Manager API section.