You are here: Start » Function Reference » Datacodes » RecognizeSingleDataMatrix_Deprecated
![](../../img/icon/ReadDatamatrix.png)
RecognizeSingleDataMatrix_Deprecated
Extracts information from the first correct Data Matrix code from among the specified positions.
Syntax
void avl::RecognizeSingleDataMatrix_Deprecated ( const avl::Image& inImage, const atl::Array<avl::Rectangle2D>& inDataMatrixPositions, avl::DataMatrixCodeType::Type inCodeType, atl::Optional<int> inCodeColumnCount, atl::Optional<int> inCodeRowCount, atl::Conditional<avl::DataMatrix>& outDataMatrix, atl::Conditional<avl::Image>& diagValues )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
![]() |
inImage | const Image& | Input image | ||
![]() |
inDataMatrixPositions | const Array<Rectangle2D>& | Candidates for Data Matrix | ||
![]() |
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 |
![]() |
outDataMatrix | Conditional<DataMatrix>& | |||
![]() |
diagValues | Conditional<Image>& | Image of decoded Data Matrix used by the reading algorithm |
Description
The operation reads a DataMatrix code on the inImage.
The operation is capable of reading codes from images subject to perspective distortion.
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.
Examples
![]() |
RecognizeSingleDataMatrix_Deprecated results drawn onto an input image.