ABBYY Mobile OCR Engine 4

Go to: Contents | Native Library API Reference | Functions

FineRecognizeBusinessCard Function

This function recognizes all text lines on the image and analyzes the image as a business card in one step.

C Syntax
TFineErrorCode FineRecognizeBusinessCard( 
  const TLanguageID                 languages[], 
  const TFinePatternsPtr            patterns,
  const TFinePatternsPtr*           cjkPatterns,
  const TFineDictionaryPtr          dictionaries[],
  const TFineKeywordsPtr            keywords[],
  const CFineImage*                 image,
  TFineImageProcessingOptions       imageProcessingOptions,
  TFineRecognitionMode              recMode,
  TFineRecognitionConfidenceLevel   confidenceLevel,
  CFineBusinessCard**               businessCardBuffer,
  TFineRotationType*                rotation,
  TFineProgressCallbackFunction     progressCallback,
  TFinePrebuiltDataCallbackFunction prebuiltDataCallback
);

Parameters

languages[]
[in] The list of language IDs as an array of the TLanguageID constants terminated by LID_Undefined. We do not recommend adding more than two recognition languages to the list.
For the best result of business card recognition, add the English language to the list of the recognition languages, regardless of the language of the business card.
patterns
[in] The address of patterns as a TFinePatternsPtr variable.
cjkPatterns
[in] The zero-terminated list of pointers to the patterns for CJK languages.
dictionaries[]
[in] The zero-terminated list of dictionaries as an array of the TFineDictionaryPtr variables.
keywords[]
[in] The zero-terminated list of keywords dictionaries as an array of the TFineKeywordsPtr variables. For the best result of business card recognition, add the English language keywords dictionary to the list, regardless of the language of the business card.
image
[in] The image to be recognized as a CFineImage variable.
imageProcessingOptions
[in] OR combination of the TFineImageProcessingOptionsFlags constants which define the image processing parameters.
recMode
[in] The TFineRecognitionMode constant which sets the recognition mode.
confidenceLevel
[in] The TFineRecognitionConfidenceLevel constant which sets the recognition confidence level.
businessCardBuffer
[out] A pointer to pointer variable that receives the interface pointer of a CFineBusinessCard variable which represents a business card. This pointer must be released afterwards with the help of the FineFreeMemory function.
rotation
[out] The TFineRotationType constant which 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.
prebuiltDataCallback
[in] The TFinePrebuiltDataCallbackFunction callback function that delivers the information about the document layout, text blocks and lines before the text recognition. It can be 0.

Return value

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

See also

Recognizing Business Cards
Working with Languages
Working with Dictionaries