imaqReadPDF417Barcode

NI Vision for LabWindows/CVI Function

imaqReadPDF417Barcode

Usage

Barcode2DInfo* imaqReadPDF417Barcode(const Image* image, const ROI* roi, Barcode2DSearchMode searchMode, unsigned int* numBarcodes);

Purpose

Reads PDF417 barcodes from an image.

Image Types Supported

IMAQ_IMAGE_U8

Parameters

Name

Type

Description

image const Image* The image containing the barcodes to read.
roi const ROI* A region of interest specifying the location of the barcodes in the image. The first contour of roi must be a rectangle, rotated rectangle, oval, annulus or closed contour. Set this parameter to NULL to use the entire image.
searchMode Barcode2DSearchMode Specifies the mode the function uses to search for barcodes. This function supports searchMode values of IMAQ_SEARCH_MULTIPLE and IMAQ_SEARCH_SINGLE_CONSERVATIVE.
numBarcodes unsigned int* On return, the number of barcodes that the function found. Set this parameter to NULL if you do not need this information.

Return Value

Type

Description

Barcode2DInfo* On success, this function returns an array of structures containing information about the barcodes. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with this array, dispose of it by calling imaqDispose().