Matrix Code Reading

Matrix Code Reading

Reads various formats of matrix codes (2D barcodes).

Inputs

image
Input image.
codeType
The type of the matrix code to be recognized.
frame
A coordinate frame which defines orientation of the bounding box in which the code matrix is assumed to be. Typically this input should be connected to the corresponding output of MatrixCodeDetectionTool.
size
The size (width, height) of the bounding box in which the code matrix is assumed to be. Typically this input should be connected to the corresponding output of MatrixCodeDetectionTool.
relativeDotSize
Ratio of the width of a module to the distance between the center points of adjacent modules. The value range is 0...1 or NAN. For example, if the modules are squares which are printed on paper, the value should be 1. If the modules are tiny dots etched on the surface, the value should be close to zero. The smaller the dots, the smaller the value. The optimal value is the one which gives maximal correlation. If 'relativeDotSize' is set to NAN, the tool estimates the relative dot size. This makes the reading slightly slower.
codeSize
Number of modules in the code matrix. If either width or height is zero, the tool tries to determine the size automatically. The automatic mode is slower than the mode where the matrix size is known.

Outputs

code
The contents of the matrix code as a text string.
correlation
Correlation metric of the selected code. This entity can be used for detecting code words which may be wrong but have passed the check sum by chance.
relativeDotSize
Estimated relative dot size if the corresponding input parameter is set to NAN for automatic estimation. Otherwise the same as input parameter 'relativeDotSize'.