Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Datacodes » 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


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


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.


  • 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.


DataMatrix on blurry image.

Low quality DataMatrix code.

DataMatrix on chip.

Rectangular DataMatrix code.


For more information about local coordinate systems please refer to the following article.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of ReadDataMatrices_Deprecated filter group.

See Also