Skip to main content

MdlocrPreprocess

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 Deep Learning OCR context.

Syntax

void MdlocrPreprocess(
AIL_ID ContextDlocrId, //in
AIL_INT64 ControlFlag //in
)

Description

This function prepares a Deep Learning OCR context for a read or fine-tuning operation.

For a read context, this allows Deep Learning OCR to make internal refinements so it can execute optimized and robust character recognition processes. You must call this function before the first call to MdlocrRead.

For a fine-tuning context, this allows Deep Learning OCR to prepare the context for training. You must call this function before the first call to MdlocrFinetune.

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

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

Parameters

ContextDlocrId (in, AIL_ID)

Specifies the identifier of the Deep Learning OCR context to preprocess. The context must have been previously allocated on the system using MdlocrAlloc.

ControlFlag (in, AIL_INT64)

Specifies whether to preprocess the Deep Learning OCR 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.