You are here: Start » Function Reference » Computer Vision » Barcodes » ReadMultipleBarcodes

ReadMultipleBarcodes

Header:	FIL.h
Namespace:	fil
Module:	Barcodes

Detects and recognizes multiple barcodes on the input image.

Applications: To be used as an easy all-in-one solution for typical barcode reading applications.

Syntax

void fil::ReadMultipleBarcodes
(
	const fil::Image& inImage,
	ftl::Optional<const fil::ShapeRegion&> inRoi,
	ftl::Optional<const fil::CoordinateSystem2D&> inRoiAlignment,
	const fil::BarcodeParams& inBarcodeParams,
	const fil::BarcodeDecodingParams& inDecodingParams,
	int inMaxBarcodeCount,
	ftl::Array<fil::Barcode>& outBarcodes,
	ftl::Optional<ftl::Array<fil::Rectangle2D>&> outBarcodeCandidates = ftl::NIL,
	ftl::Optional<fil::ShapeRegion&> outAlignedRoi = ftl::NIL,
	fil::Image& diagGradientImage,
	ftl::Array<ftl::Array<fil::Segment2D>>& diagScheduledScanSegments
)

Parameters

Name	Type	Range	Default	Description
inImage	const Image&			Input image
inRoi	Optional<const ShapeRegion&>		NIL	Region of interest
inRoiAlignment	Optional<const CoordinateSystem2D&>		NIL	Adjusts the region of interest to the position of the inspected object
inBarcodeParams	const BarcodeParams&			Specification of barcodes that can be detected
inDecodingParams	const BarcodeDecodingParams&			Parameters of the barcode decoding algorithm
inMaxBarcodeCount	int	1 -	2	Maximum number of barcodes in one image
outBarcodes	Array<Barcode>&			List of barcodes that have been correctly detected and decoded
outBarcodeCandidates	Optional<Array<Rectangle2D>&>		NIL	Places with high gradient values that are further investigated
outAlignedRoi	Optional<ShapeRegion&>		NIL	Input ROI after transformation (in the image coordinates)
diagGradientImage	Image&			Image of gradient directions
diagScheduledScanSegments	Array<Array<Segment2D>>&			Scheduled scan segments

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outBarcodeCandidates, outAlignedRoi.

Description

This filter detects barcodes present in the input image and reads their content.

Hints

Connect inImage with the output of your image acquisition filter.
Select inBarcodeParams.Format according to the type of codes you want to read. If you choose the wrong format, the codes will not be recognized. Setting its value to Auto can increase the computation time considerably. Furthermore, the Auto value causes detection of UPC-A codes as EAN-13 codes.

If the image resolution is high, set inBarcodeParams.MaxModuleSize accordingly or resize/downsample the input image.

Examples

Two barcodes in a good quality image.

Two barcodes in a blurry image.

Remarks

Minimal bar width requirement

To provide precise detection of the barcode width of the thinnest bar should be at least 1.5 pixels.

Depending on the barcode format guard or start/end code patterns must be readable.

Pharmacode usage

The pharmacode barcode type can be read correctly in both directions. To get results from both directions use a Pharmacode and PharmacodeInversed barcode types.

Before decoding a Pharmacode the code orientation angle is normalized to a range from -45° to 135° what makes the code decoding more stable

Results of reading using a different Pharmacode directions: Pharmacode = 23 and PharmacodeInversed = 16.

Using a relative coordinate systems

Read more about Local Coordinate Systems in Machine Vision Guide: Local Coordinate Systems.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.