imaqReadBarcode
Usage
BarcodeInfo* imaqReadBarcode(const Image* image, BarcodeType type, const ROI* roi, int validate);
Purpose
Reads a barcode from an image.
Image Types Supported
IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| image | const Image* | The image containing the barcode to read. |
| type | BarcodeType | The type of the barcode to read. |
| roi | const ROI* | A region of interest specifying the location of the barcode in the image. The first contour of roi must be a rectangle. Set this parameter to NULL to use the entire image. |
| validate | int | If type is IMAQ_I2_OF_5, IMAQ_CODE39, or IMAQ_CODABAR, set validate to TRUE to use the error correction information of the barcode to validate the data. If type is not IMAQ_I2_OF_5, IMAQ_CODE39, or IMAQ_CODABAR, or if you set validate to FALSE, the function does not validate the data. |
Return Value
| Type |
Description |
|---|---|
| BarcodeInfo* | On success, this function returns a structure containing information about the barcode. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with this structure, dispose of it by calling imaqDispose(). |