Back to FabImage Library website

You are here: Start » Function Reference » Datacodes » ReadMultipleDataMatrices_Deprecated

ReadMultipleDataMatrices_Deprecated


Header:FIL.h
Namespace:fil

Detects and recognizes multiple Data Matrix codes.

Syntax

C++
 
void fil::ReadMultipleDataMatrices_Deprecated
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Rectangle2D&> inRoi,
	ftl::Optional<const fil::CoordinateSystem2D&> inRoiAlignment,
	bool inAllowRectangular,
	fil::DataMatrixCodeType::Type inCodeType,
	ftl::Optional<int> inCodeColumnCount,
	ftl::Optional<int> inCodeRowCount,
	ftl::Array<fil::DataMatrix>& outDataMatrices,
	ftl::Optional<fil::Rectangle2D&> outAlignedRoi = ftl::NIL,
	ftl::Array<ftl::Conditional<fil::Image> >& diagValues
)

Parameters

Name Type Range Default Description
inImage const Image& Input image
inRoi Optional<const Rectangle2D&> NIL Range of pixels to be processed
inRoiAlignment Optional<const CoordinateSystem2D&> NIL Adjusts the region of interest to the position of the inspected object
inAllowRectangular bool False Enables detecting rectangular Data Matrices
inCodeType DataMatrixCodeType::Type
inCodeColumnCount Optional<int> 1 - 160 NIL Optional width of a Data Matrix
inCodeRowCount Optional<int> 1 - 160 NIL Optional height of a Data Matrix
outDataMatrices Array<DataMatrix>&
outAlignedRoi Optional<Rectangle2D&> NIL Input ROI after transformation (in the image coordinates)
diagValues Array<Conditional<Image> >& Images of decoded Data Matrices used by the reading algorithm

Optional Outputs

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

Read more about Optional Outputs.

Description

This filter is a composition of DetectDataMatrices_Deprecated and RecognizeMultipleDataMatrices_Deprecated filters.

Supported code types: ECC 200 and ECC 000-140.

Around datamatrix must be quiet zone. The minimum quiet zone is equal to the width of a module on all four sides. For applications with moderate to excessive reflected noise in close proximity to the symbol, a quiet zone of 2 to 4 module widths is recommended.

Hints

  • Select an appropriate code type by setting inCodeType.
  • Set inAllowRectangular if you expect to work also with non-square codes.
  • Set inCodeColumnCount and inCodeRowCount to increase reliability and speed when dimensions of the codes are fixed.
  • For low-quality images and codes composed of punched dots, use appropriate image preprocessing to assure highest reliability.

Examples

DataMatrix on blurry image.

Low quality DataMatrix code.

DataMatrix on chip.

Rectangular DataMatrix code.

Remarks

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

See Also