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