Read matrix code🔗

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

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

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

  • codeType: The type of the matrix code that was recognized.

  • codeSize: The number of modules in the code matrix. If codeSize input is set to automatic mode, this output gives the observed number of modules.