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 generic parameter '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 query_data_code_2d_params can be used to query the parameters that are valid for the specific data code type. To obtain the currently set values of parameters, get_data_code_2d_param can be used.
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 get_data_code_2d_results and get_data_code_2d_objects, additional data about the extraction process can be accessed that can be used both for process analysis and for displaying. In particular, get_data_code_2d_results allows to access several alphanumerical results that were calculated while searching and reading the symbols and get_data_code_2d_objects allows to access iconic objects that were created during the last call of find_data_code_2d.
When you no longer need the 2D data code model, you destroy it by passing the handle to
In addition to the operators mentioned above, write_data_code_2d_model 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 read_data_code_2d_model (without calling create_data_code_2d_model). Furthermore, you can use serialize_data_code_2d_model and deserialize_data_code_2d_model 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.