ABBYY Mobile OCR Engine 4

Go to: Contents | Native Library API Reference | Functions

FinePrebuildWordsInfo Function

This function returns the document layout information, including rectangles of words, without the text recognition. It does not support CJK languages. If any CJK language is included in the languages parameter, the function returns an error.

C Syntax
TFineErrorCode FinePrebuildWordsInfo(
  const TLanguageID             languages[], 
  const TFinePatternsPtr        patterns,
  const CFineImage*             image, 
  TFineImageProcessingOptions   imageProcessingOptions,
  CFinePrebuiltLayoutInfo**     finePrebuiltLayoutInfo,
  TFineRotationType*            rotation,
  TFineProgressCallbackFunction progressCallback
);

Parameters

languages[]
[in] The list of language IDs as an array of the TLanguageID constants terminated by LID_Undefined.
Note: It is better not to add to the list more than two recognition languages.
patterns
[in] The address of patterns as a TFinePatternsPtr variable.
image
[in] The image to be recognized as a CFineImage variable.
imageProcessingOptions
[in] OR combination of the TFineImageProcessingOptionsFlags constants that define the image processing parameters.
finePrebuiltLayoutInfo
[out] A pointer to the CFinePrebuiltLayoutInfo pointer with the output results. This pointer must be released afterwards with the help of the FineFreeMemory function.
rotation
[out] The TFineRotationType constant that specifies the rotation angle of an input image before recognition if the FIPO_DetectPageOrientation flag is set in the imageProcessingOptions parameter, otherwise, it contains 0.
Note:
The recognized text coordinates correspond to a rotated image.
progressCallback
[in] The TFineProgressCallbackFunction callback function that delivers the progress information. It can be 0.

Return value

The function returns the standard return values of ABBYY Mobile OCR Engine functions.

See also

Working with Languages
Working with Dictionaries