IMG_CONVERSION Enumeration |
Namespace: Kofax.OmniPageCSDK.IproPlus
Assembly: Kofax.OmniPageCSDK.IproPlus (in Kofax.OmniPageCSDK.IproPlus.dll) Version: 1.0.0.0
SyntaxMembers| Member name | Value | Description | |
|---|---|---|---|
| CNV_AUTO | 0 | This has an effect on grayscale or 24-bit color images: a B/W image is created in the Engine's memory. An automatic adaptive thresholding algorithm is applied to the image binarization. Use the Brightness property to fine-tune the threshold calculation. | |
| CNV_SET | 1 | This has an effect on grayscale or 24-bit color images: a B/W image is created in the Engine's memory. This setting will implement a user-defined threshold value, defined by the BrightnessThreshold property. | |
| CNV_NO | 2 | There is no conversion while loading the image. The image is loaded into the Engine's memory without any conversion (i.e. a color image retains its color attributes). | |
| CNV_GLOBAL | 3 | This has an effect on grayscale or 24-bit color images: a B/W image is created in the Engine's memory. An automatic thresholding algorithm with a page-level global threshold value is applied in order to binarize the image. | |
| CNV_GRAY | 4 | For a color image: a grayscale image is created in the Engine's memory. For B/W or grayscale images: no conversion is performed while loading the image. |
RemarksImage conversion modes are applied for conversions from grayscale or color image sources. These values specify how different image types will be converted either during primary image conversion (loading an image into the IproPlus) or during secondary image conversion, (an image - already in the IproPlus's memory space - undergoes an image conversion step).
These modes can be set on Document object by Conversion property for primary and by Binarization for secondary image conversion.
Secondary image conversions are performed on an existing Page. This step is activated either directly or implicitly. This latter case may occur when the application calls a function whose operation requires a B/W image but the available image is not a B/W one, making an implicit image conversion necessary.
In primary image conversion, the default conversion type is CNV_NO. In secondary image conversion, the default conversion type is CNV_AUTO.
During primary image conversion CNV_SET and CNV_GLOBAL produce the same results as they do during secondary image conversion. However, CNV_AUTO method is faster in primary than in secondary conversion, but the result is less optimal for OCR. In general, it is true that the most optimal result for OCR can be got with the default values of these settings.
See Also