Skip to main content

MdmrPreprocess

BoardSupported
Host SystemYes
V4L2Yes
Clarity UHDYes
Concord PoENo
GenTLYes
GevIQYes
GigE VisionYes
IndioNo
Iris GTXYes
Radient eV-CLYes
Rapixo CLYes
Rapixo CoFYes
Rapixo CXPYes
USB3 VisionYes

Preprocess a SureDotOCR context.

Syntax

void MdmrPreprocess(
AIL_ID ContextDmrId, //in
AIL_INT64 ControlFlag //in
)

Description

This function prepares a SureDotOCR context for a read operation. This allows SureDotOCR to make internal refinements so it can execute optimized and robust dot-matrix character recognition processes. You must call this function before the first call to MdmrRead. To preprocess a context without error, it must contain at least one font, one character, and one string model.

Changes to a context or to any of its content often require you to preprocess the context again. To inquire a context's preprocessing state, call MdmrInquire with M_PREPROCESSED.

Saving a context does not save preprocessing changes. Upon restoration, you must preprocess the context again.

Parameters

ContextDmrId (in, AIL_ID)

Specifies the identifier of the SureDotOCR context to preprocess. The context must have been previously allocated on the system using MdmrAlloc.

ControlFlag (in, AIL_INT64)

Specifies whether to preprocess the SureDotOCR context. Set this parameter to one of the values below:

For specifying whether to preprocess the context

ValueDescription
M_DEFAULTPreprocesses the context.
M_RESETUn-preprocesses the context.

Un-preprocessing the context can be useful if you want to conserve system memory within an application and preserve context settings. |

Copyright © 2026 Zebra Technologies.