McodeAlloc

This function allocates a code context. A code context is a container for one or more code models. The code model is used by the read, write, and grading operations.

To add code models to the context, use McodeModel(). A code context can contain multiple code models of 1D code types (excluding GS1 databar, Planet, Postnet, and 4-state); for other code types, a code context can contain at most one code model.

To adjust code model settings, use McodeControl().

When allocating a code context, specify whether the context should be initialized for a robust or a typical read operation. The initial configuration of the code context establishes the default values for some code model settings. To change the initial configuration at a later date, use McodeControl() with M_INITIALIZATION_MODE. If your target images lack similarity (for example, some but not all include complex or noisy backgrounds), contain distorted codes, or contains codes that are at an angle or even flipped, use the M_IMPROVED_RECOGNITION initialization mode. Otherwise, use the M_TYPICAL_RECOGNITION initialization mode, which might produce a faster but potentially less robust result. The restrictions are indicated within the description of each code model setting; see McodeControl() for details.

To read and grade codes in an image, use McodeRead() and McodeGrade(), respectively. The module only supports searching for multiple occurrences of 1D codes (excluding 4-State, GS1 Databar, Planet, and Postnet code types) and 2D Data Matrix codes. For other types of codes, the module only supports searching for a single occurrence. When reading or grading multiple codes, multiple results can be retrieved using McodeGetResult(), one set of results for each occurrence.

When the code context is no longer needed, you should free it, using McodeFree().