Learning a Matrix Code

Important: This topic applies to EasyMatrixCode1 only.

To search for specific features and speed up your processing, learn a Matrix code model.

Workflow

1.

Load the image of the matrix code you want to learn.

2.

Learn the model:

□

Use the Learn method with Contrast, Family, Flipping, Logical Size parameters.

□

If you need to learn several matrix codes, use LearnMore and pass additional sample images.

□

Call Learn to replace EMatrixCodeReader parameters (calling Learn several times does not accumulate results, while LearnMore does).

3.

Tune search parameters to be efficient and either:

□

Read only matrix codes that match a sample matrix code,

□

Or read only matrix codes that have the same properties (Contrast, Family, Flipping, Logical Size) as the learned one,

□

Or disregard a search parameter of the learned matrix code SetLearnMaskElement, for example to read only unflipped matrixcodes. Just remove the default parameters, then add new ones.

4.

Ask EMatrixCodeReader to decode the supplied image.

5.

Display the decoded string.

6.

Save the state of the reader object using EMatrixCodeReader::Save.

Restoring the state of an EMatrixCodeReader

To restore the state of an EMatrixCodeReader and use it to read a matrix code:

1. Load an image.

2. Restore the reader state from the given file using EMatrixCodeReader::Load.

3. Read the image.

4.

Display the decoded string.