EasyMatrixCode - Reading Matrix Codes¶

Purpose¶

The EasyMatrixCode library allows to read data matrix codes in images:

The reading is fast and robust.
Several codes can be read in the same image.
The processing can be limited to an ERegion in the image.
Specific support is provided for codes arranged in a grid.
The data matrix codes can be graded according to the ISO 15415, ISO 29158 or Semi T10 norms.

Reading a Data Matrix Code¶

You can read the matrix code in an image automatically as follows:

Create an EMatrixCodeReader ^.NET ^Python object.
Call the EMatrixCodeReader::Read ^.NET ^Python method to return a vector of EMatrixCode ^.NET ^Python.
Each instance contains, among others, the string ^.NET ^Python embedded in the data matrix code.

Note

The relevant classes of the EasyMatrixCode library are stored in the namespace EasyMatrixCode2. Classes outside that namespace (refered to as EasyMatrixCode1) are an earlier version of the EasyMatrixCode library, now deprecated.

C++

#include <eVision/EasyMatrixCode/EasyMatrixCode2/EMatrixCodeReader.h>

using namespace eVision;
namespace EMC2 = eVision::EasyMatrixCode2;
// Load an image
EImageBW8 image;
image.Load("image.bmp");
// Prepare a matrix code reader
EMC2::EMatrixCodeReader reader;
// Let the reader know that there are no more than 3 codes in the image
reader.SetMaxNumCodes(3);
// Read the source image
reader.Read(image);
// Retrieve the detected codes
std::vector<EMC2::EMatrixCode> codes = reader.GetReadResults();
// Retrieve the decoded string for the first code
std::string result = codes[0].GetDecodedString();

using eVision;
using EMC2 = eVision.EasyMatrixCode2;

// Load an image
EImageBW8 image = new EImageBW8();
image.Load("image.bmp");
// Prepare a matrix code reader
EMC2.EMatrixCodeReader reader = new EMC2.EMatrixCodeReader();
// Let the reader know that there are no more than 3 codes in the image
reader.MaxNumCodes = 3;
// Read the source image
reader.Read(image);
// Retrieve the detected codes
EMC2.EMatrixCode[] codes = reader.ReadResults;
// Retrieve the decoded string for the first code
string result = codes[0].DecodedString;

Python

import eVision
from eVision import EasyMatrixCode2 as EMC2
# Load an image
image = eVision.EImageBW8()
image.Load("image.bmp")
# Prepare a matrix code reader
reader = EMC2.EMatrixCodeReader()
# Let the reader know that there are no more than 3 codes in the image
reader.MaxNumCodes = 3
# Read the source image
codes = reader.Read(image)
# Retrieve the decoded string for the first code
result = codes[0].DecodedString

Contents¶

Specifications

Specifications of the data matrix and EasyMatrixCode library.

Specifications and Supported Symbols

Using EasyMatrixCode

How to use the EasyMatrixCode library.

Using EasyMatrixCode

Using EasyMatrixCode1 (deprecated)

How to use the first version of the EasyMatrixCode library, now deprecated.

EasyMatrixCode1 - Reading Matrix Codes (deprecated)

Quick Links¶

Reference

List of all Classes, Structs and Enumerations of the EasyMatrixCode library.

EasyMatrixCode Library

Code snippets

Code snippets for the EasyMatrixCode library.

EasyMatrixCode

List of Supported Codes

All the code symbologies read by the text and code reading libraries.

Matrix codes (2D)

Code Grading

Assess the printing quality of your bar, data matrix and QR codes.

Code Grading

ECodeReader

Read bar, data matrix and QR codes using a unified interface.

ECodeReader - Unified Interface