List of Operators ↓
This chapter contains operators for reading 2D data codes.
2D data code symbols are a special kind of two-dimensional patterns that encode text and numbers. HALCON is able to read the most popular 2D data codes: Data Matrix ECC 200, QR Code, Micro QR Code, Aztec Code, and PDF417. These codes contain a finder pattern and a data pattern. The finder pattern is used to locate the pattern of the symbol and get basic information about the geometric properties, e.g., the orientation of the symbol. The data pattern contains the code itself and consists of multiple dots, bars, or small squares, the so-called modules. Because of the special design of the codes, they can be decoded even if some parts are disturbed.
In the following, the steps that are required to read 2D data codes are described briefly.
First, a 2D data code model must be created using
This model provides the reader with all necessary information about the structure of the code. For normal printed codes only the name needs to be provided and HALCON will select suitable default parameters. For special cases, you can modify the model parameters either when creating the 2D data code model or in a later step to adapt the model to a particular symbol appearance.
Using the default parameters, the 2D data code reader is able to read a wide range of codes. For non-standard codes the parameters can be modified using
Here, you can either select an enhanced set of default parameters using the
'default_parameters', e.g., with the value
'enhanced_recognition', or you specify the parameter values
separately to adapt the model optimally to the conditions of the used print
style. Note that
can be used to query the
parameters that are valid for the specific data code type. To obtain the
currently set values of parameters,
Instead of modifying the model parameters manually, you can also let HALCON train the model using
with the generic parameter 'train'. Then, HALCON will search for the best parameters needed to extract the given code. It is recommended to apply this to multiple example images to ensure that all variations are covered.
The 2D data code is located and its content is decoded using
The operator returns for every successfully decoded symbol the surrounding
XLD contour, a handle to a result structure, which contains additional
information about the symbol as well as about the search and decoding
process, and the string that is encoded in the symbol. With the result
handles and the operators
, additional data about the extraction
process can be accessed that can be used both for process analysis and for
displaying. In particular,
allows to access
several alphanumerical results that were calculated while searching and
reading the symbols and
allows to access
iconic objects that were created during the last call of
In addition to the operators mentioned above,
allows to write the model into a file that
can be used later to create (e.g., in a different application) an identical
copy of the model. Such a model copy is created directly by
). Furthermore, you can use
to serialize and deserialize the 2D
data code model.
Two-dimensional graphical symbol that encodes characters and numbers. It is constructed by dark and light dots, bars, or small squares that are called modules. There are different types of 2D data codes. Two common types are the so-called stacked codes and the so-called matrix codes.
Type of 2D data code symbol that contains a stack of 1D bar codes arranged in rows and columns. To ensure that the complete stack of 1D bar codes is processed, the symbol contains a start and a stop pattern. Additionally, the symbol is framed by a quiet zone.
Type of 2D data code symbol that uses graphical patterns consisting of dark and light modules arranged in two dimensions. The symbol consists of three components: a finder pattern, a data pattern, and a quiet zone.
Dark and light dots, bars, or small squares that are used to build a 2D data code symbol.
Homogeneous frame around the symbol's border that makes the symbol better distinguishable from the background or from other objects in the image.
Pattern that is used to find the symbol and its orientation in the image. The pattern differs depending on the used data code type.
See also the
“Solution Guide Basics” and the
“Solution Guide on 2D Data Codes” for further details
about 2D data codes.