Go to: Contents |
Native Library API Reference |
Functions
FineExtractBarcodes Function
This function finds and recognizes all barcodes on the image.
C Syntax
TFineErrorCode FineExtractBarcodes(
const CFineImage* image,
unsigned allowedTypes,
unsigned allowedOrientations,
unsigned allowedSupplements,
int hasChecksum,
int isCode39WithoutAsterisk,
int isBinaryInterpretedAsText,
TFineSupportedCodepage defaultCodePage,
CFineLayout** layoutBuff,
TFineProgressCallbackFunction progressCallback
);
Parameters
- image
- [in] The image to be recognized as a
CFineImage variable.
- allowedTypes
- [in] The OR combination of the TFineBarcodeType constants
that define acceptable barcode types.
- allowedOrientations
- [in] The OR combination of the TFineBarcodeOrientation
constants that define the possible orientations of the barcode.
- allowedSupplements
- [in] The OR combination of the TFineBarcodeSupplement
constants
that define the possible supplements of the barcode. This parameter is
ignored for barcodes without supplement. Set the parameter to FBS_Void if the barcode
you recognize does not have a supplement.
- hasChecksum
- [in] Should not be zero if the barcode should be recognized as a barcode with checksum.
It is valid for Code39, Interleaved25, Codabar, and Matrix25 barcodes. For
these types of the barcodes, the last symbol of the barcode is considered as
control sum of all barcode symbols, and is checked during the recognition.
- isCode39WithoutAsterisk
- [in] Should not be zero if the Code39 barcode has no start and stop symbol, the asterisk
"*". It is valid for Code39 barcode. This parameter is ignored if the
allowedTypes parameter set to more than one type.
- isBinaryInterpretedAsText
- [in] Should not be zero if byte data should be interpreted as text in the current code
page. If this parameter is zero the data will be stored in hexadecimal
format. This parameter is ignored if the allowedTypes parameter set
to more than one type.
- defaultCodePage
- [in] A TFineSupportedCodepage
constant that specifies a default code page. If barcode was created using
code page that differs from the specification code page, that code page
should be specified in this parameter. This parameter is ignored if the allowedTypes
parameter set to more than one type.
- layoutBuff
- [out] A pointer to pointer variable that receives the interface pointer of
a CFineLayout variable that contains the
recognition results. This pointer must be released afterwards with the help of the
FineFreeMemory function.
- progressCallback
- [in] The pointer to 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
TFineBarcodeType
TFineBarcodeOrientation
TFineBarcodeSupplement