Skip to main content

MdlocrSave

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

Save a Deep Learning OCR read or fine-tuning context to a file.

Syntax

void MdlocrSave(
AIL_CONST_TEXT_PTR FileName, //in
AIL_ID ContextDlocrId, //in
AIL_INT64 ControlFlag //in
)

Description

This function saves all the information about the previously allocated Deep Learning OCR read or fine-tuning context to disk, including all of its global settings and string model-specific positional constraints and settings. This information can be reloaded, using MdlocrRestore or MdlocrStream.

When you save the context, the preprocessing changes are not saved. Upon restoration, you must preprocess the context again.

Parameters

FileName (in, AIL_CONST_TEXT_PTR)

Specifies the name and path of the file in which to save the Deep Learning OCR read or fine-tuning context. The function internally handles the opening and closing of this file. For easier use with other Aurora Imaging Library software products, files for Deep Learning OCR read or fine-tuning contexts should use the MDLOCR file extension. If you specify a file that already exists, it will be overwritten.

For specifying the file name and path

ValueDescription
M_INTERACTIVEOpens a dialog box from which you can interactively specify the drive, directory, and name of the file.
"FileName"Specifies the drive, directory, and name of the Deep Learning OCR read or fine-tuning context file (for example,"C:\mydirectory\MyContext.mdlocr"). Typically, Deep Learning OCR context files have an MDLOCR extension.

To specify a context file on a remote computer (under Distributed Aurora Imaging Library), prefix the specified file name string with "remote:///" (for example, "remote:///C:\mydirectory\MyContext.mdlocr"). |

ContextDlocrId (in, AIL_ID)

Specifies the identifier of the Deep Learning OCR read or fine-tuning context to save.

ControlFlag (in, AIL_INT64)

Reserved for future expansion and must be set to M_DEFAULT.

Copyright © 2026 Zebra Technologies.