Specifies which image reduction mode will be used during the primary image conversion step.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_REC_primary_reduction_mode_set( enumIGRecImgConversion Conversion ); |
|
Arguments:
| Name | Type | Description |
| Conversion | enumIGRecImgConversion | Primary image conversion 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_primary_reduction_mode_set(IG_REC_IMG_CONVERSION_AUTO); |
|
Remarks:
While loading an image to the recognition engine's memory space (IG_REC_PID_IMGINPUT process), an image conversion is performed according to the current image conversion mode setting.
The setting specified here will influence what kind of HIG_REC_IMAGE image will be created in the recognition engine's memory, i.e., whether it will be bi-tonal, grayscale, or color.
The following table demonstrates what kind of image will created in the recognition engine as the result of the image loading process.
| Primary Image Conversion Mode | Image Source is Bitonal | Image Source is Grayscale | Image Source is Color |
| IG_REC_IMG_CONVERSION_SET | bi-tonal | bi-tonal | bi-tonal |
| IG_REC_IMG_CONVERSION_NO | bi-tonal | grayscale | color |
| IG_REC_IMG_CONVERSION_GLOBAL | bi-tonal | bi-tonal | bi-tonal |
| IG_REC_IMG_CONVERSION_GRAY | bi-tonal | grayscale | grayscale |