You are here: Start » Filter Reference » Datacodes » ReadSingleDataMatrix_Deprecated

ReadSingleDataMatrix_Deprecated

Detects and recognizes a single Data Matrix code.

Name	Type	Range	Description
inImage	Image		Input image
inRoi	Rectangle2D *		Range of pixels to be processed
inRoiAlignment	CoordinateSystem2D *		Adjusts the region of interest to the position of the inspected object
inAllowRectangular	Bool		Enables detecting rectangular Data Matrices
inCodeType	DataMatrixCodeType
inCodeColumnCount	Integer *	1 - 160	Optional width of a Data Matrix
inCodeRowCount	Integer *	1 - 160	Optional height of a Data Matrix
outDataMatrix	DataMatrix ?
outAlignedRoi	Rectangle2D		Input ROI after transformation (in the image coordinates)
diagValues	Image ?		Image of decoded Data Matrix used by the reading algorithm

Applications

To be used as an easy all-in-one solution for typical Data Matrix reading applications.

Description

This filter is a composition of DetectDataMatrices_Deprecated and RecognizeSingleDataMatrix_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

Connect inImage with the output of your image acquisition filter.
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.