ABBYY Mobile OCR Engine 4

Go to: Contents | Native Library API Reference | Enumerations

TFineImageProcessingOptionsFlags

TFineImageProcessingOptionsFlags enumeration constants are used to set the input parameter of the FinePreprocessImage function. Some of the constants are defined using the BIT_FLAG macros.

typedef enum tagTFineImageProcessingOptionsFlags{
    FIPO_Default                        = 0,
    FIPO_DisableDeskew                  = BIT_FLAG( 0 ),
    FIPO_DisableImageGeometricTransform = FIPO_DisableDeskew,
    FIPO_DetectPageOrientation          = BIT_FLAG( 1 ),
    FIPO_HasCjk                         = BIT_FLAG( 4 ),
    FIPO_FindAllText                    = BIT_FLAG( 5 ),
    FIPO_IsEuropeanWithSomeCjk          = BIT_FLAG( 6 ),
    FIPO_ProhibitVerticalCjkText        = BIT_FLAG( 7 ),
    FIPO_MicrMode                       = BIT_FLAG( 8 ),
    FIPO_BuildWordsInfo                 = BIT_FLAG( 9 ),
    FIPO_PrebuildWordsInfo              = BIT_FLAG( 10 ),
    FIPO_UseOldBinarization             = BIT_FLAG( 11 )
} TFineImageProcessingOptionsFlags;

Flag

Name Description
FIPO_BuildWordsInfo If this flag is set, then, after recognition, the CFineTextLine::WordInfo field stores an array of CFineWordInfo structures with the CFineTextLine::WordInfoCount elements.
FIPO_Default If this constant is set, input image will be processed with default parameters.
FIPO_DetectPageOrientation Specifies whether the page orientation should be detected. The portrait or landscape page orientation will be detected. If this flag is set, the rotation parameter of the FineRecognizeImage, FineRecognizeRegion and FineRecognizeBusinessCard functions returns the rotation angle multiple of 90 degrees. These functions return the recognized text coordinates corresponding to a rotated image.

Note: Setting this flag decreases recognition speed. Also detection of page orientation requires additional 0.5-1 MB RAM.

FIPO_DisableDeskew Turns off automatic skew correction.

Note: If you do not use this option, skew correction is performed during image preprocessing. For adequate skew correction, the skew angle should not exceed 16 degrees.

FIPO_DisableImageGeometricTransform Equal to FIPO_DisableDeskew.
FIPO_FindAllText If this constant is set, the program will find all text on image. Pictures and garbage will be analyzed and recognized.
FIPO_HasCjk Specifies whether the input image has Asian characters. This constant is automatically added into the input parameters in the recognition functions if the input list of the recognition languages of these functions contains a CJK language.
FIPO_IsEuropeanWithSomeCjk Specifies whether the input image has text that is written in European and CJK languages. This constant is automatically added into the input parameters in the FineRecognizeBusinessCard function if the input list of the recognition languages of this function contains a CJK language.

Note: Setting this constant increases recognition speed on images which contain text written in CJK and European languages. If text on the image is written only in a CJK language, it could decrease recognition quality.

FIPO_MicrMode Specifies whether the MICR E13B font must be recognized. See the Recognizing in MICR Mode section for details.

Note: Only the MICR E13B characters are recognized in the FIPO_MicrMode mode, all other fonts are ignored.

FIPO_PrebuildWordsInfo If this flag is set, the information about the document layout, text blocks and lines is prebuilt before the text recognition. The TFinePrebuiltDataCallbackFunction callback is called before the text recognition, and the data argument points to a CFinePrebuiltLayoutInfo structure.

Note: This flag is ignored if the FIPO_HasCjk flag is set.

FIPO_ProhibitVerticalCjkText If this constant is set, the program will recognize only the horizontal CJK text on image, all vertical CJK text will be ignored.
FIPO_UseOldBinarization If this constant is set, fast binarization mechanism will not be used. Image binarization will be slower, but for CJK languages recognition quality may improve.

See also

FineAnalyzeImage
FineGetTextLines
FinePrebuildWordsInfo
FinePreprocessImage
FineRecognizeBlocks
FineRecognizeBusinessCard
FineRecognizeImage
FineRecognizeRegion