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

Specifies the Image resolution enhancement mode.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_res_enhancement_mode_set(
   enumIGRecImgResEnhancement res
);

Arguments:

Name Type Description
res enumIGRecImgResEnhancement Image enhancement 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_res_enhancement_mode_set(IG_REC_IMG_RE_LEGACY);

Remarks:

This setting is applied only to non-bi-tonal images stored in the recognition engine's memory space. The value specifies whether the image resolution enhancement is to be activated during the secondary image conversion, i.e., during image pre-processing, auto-zoning, or recognition. The resolution enhancement algorithm results in a bi-tonal image whose resolution is doubled - compared to the original image.

This setting might influence the accuracy of the recognition.

  1. When the Image resolution enhancement value IG_REC_IMG_RE_YES (enumIGRecImgResEnhancement) is set, all non-bi-tonal images undergoing an implicit secondary image conversion to bi-tonal also have their resolution doubled, regardless of their original resolution. This is done on the basis of information taken from the extra pixel depth in the grayscale and color images. These secondary image conversions occur whenever the application calls a Recognition API function whose operation requires a bi-tonal image, e.g., the IG_REC_zones_locate, the IG_REC_image_preprocess, or the IG_REC_image_recognize functions.
  2. With the IG_REC_IMG_RE_AUTO setting, only images with a resolution of 150 or less are resolution-enhanced during secondary image conversion.
  3. If this function is not called to specify the Image resolution enhancement mode setting, by default IG_REC_IMG_RE_AUTO is applied.