ImageGear for C and C++ on Windows v19.2 - Updated
IG_REC_despeckle_mode_set
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Recognition Image Preprocessing Functions > IG_REC_despeckle_mode_set

Specifies the Image despeckle mode setting.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_despeckle_mode_set(
   AT_BOOL bMode
);

Arguments:

Name Type Description
bMode AT_BOOL Image despeckle mode to be set.

Return Value:

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

Supported Raster Image Formats:

This function does not process image pixels.

Example:

 
Copy Code
AT_ERRCOUNT ErrCount = 0;
ErrCount += IG_REC_despeckle_mode_set(TRUE);

Remarks:

The function specifies whether the adaptive noise removal algorithm is to be activated during image pre-processing, auto-zoning, or recognition.

The noise removal algorithm runs only on bi-tonal images with a resolution of 280 dpi or higher.

This setting might influence the accuracy of the recognition.

  1. When this setting is enabled, bi-tonal images with a resolution above 280 dpi automatically undergo an implicit secondary image conversion whenever the application calls a Recognition API function whose operation requires a bi-tonal or despeckled image, e.g., the IG_REC_zones_locate, the IG_REC_image_preprocess or the IG_REC_image_recognize functions. The resulting despeckled bi-tonal images are not available to the application.
  2. Grayscale or color images undergo their own implicit secondary image conversion whenever a bi-tonal image is required. This conversion results in cleaned bi-tonal images, so this setting is not applied to them.
  3. If this function is not called to specify the Image despeckle mode setting, by default this setting is enabled.
  4. Immediate despeckling of a bi-tonal image (regardless of its resolution) is available by calling IG_REC_image_despeckle. The despeckled image replaces the original one and is available to the application.