You are here: Start » Function Reference » Datacodes » ReadMultipleDataMatrices_Deprecated
ReadMultipleDataMatrices_Deprecated
Header: | AVL.h |
---|---|
Namespace: | avl |
Detects and recognizes multiple Data Matrix codes.
Syntax
void avl::ReadMultipleDataMatrices_Deprecated ( const avl::Image& inImage, atl::Optional<const avl::Rectangle2D&> inRoi, atl::Optional<const avl::CoordinateSystem2D&> inRoiAlignment, bool inAllowRectangular, avl::DataMatrixCodeType::Type inCodeType, atl::Optional<int> inCodeColumnCount, atl::Optional<int> inCodeRowCount, atl::Array<avl::DataMatrix>& outDataMatrices, atl::Optional<avl::Rectangle2D&> outAlignedRoi = atl::NIL, atl::Array<atl::Conditional<avl::Image> >& diagValues )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
inImage | const Image& | Input image | |||
inRoi | Optional<const Rectangle2D&> | NIL | Range of pixels to be processed | ||
inRoiAlignment | Optional<const CoordinateSystem2D&> | NIL | Adjusts the region of interest to the position of the inspected object | ||
inAllowRectangular | bool | False | Enables detecting rectangular Data Matrices | ||
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 | |
outDataMatrices | Array<DataMatrix>& | ||||
outAlignedRoi | Optional<Rectangle2D&> | NIL | Input ROI after transformation (in the image coordinates) | ||
diagValues | Array<Conditional<Image> >& | Images of decoded Data Matrices used by the reading algorithm |
Optional Outputs
The computation of following outputs can be switched off by passing value atl::NIL
to these parameters: outAlignedRoi.
Read more about Optional Outputs.
Description
This filter is a composition of DetectDataMatrices_Deprecated and RecognizeMultipleDataMatrices_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
- 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.
Examples
Remarks
Read more about Local Coordinate Systems in Machine Vision Guide: Local Coordinate Systems.
See Also
- DetectDataMatrices_Deprecated – Finds candidates for Data Matrix codes in the input image.
- RecognizeSingleDataMatrix_Deprecated – Extracts information from the first correct Data Matrix code from among the specified positions.
- RecognizeMultipleDataMatrices_Deprecated – Extracts information from multiple Data Matrix codes located at the specified positions.
- ReadMultipleDataMatrices_Deprecated – Detects and recognizes multiple Data Matrix codes.