| MIL 10 Reference
| Customize Help
| Save Settings

MocrSaveFont


See also
Availability
Not available in MIL-Lite
Available in MIL

Available on Windows
Available on Linux with restrictions

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Examples
MocrRestoreFont
MocrSetConstraint
Synopsis
Save an existing OCR font context to disk.
Syntax
void MocrSaveFont(
MIL_CONST_TEXT_PTR FileName, //in
MIL_INT64 Operation, //in
MIL_ID FontContextOcrId //in
)
Description

This function saves an existing OCR font context to disk using the MIL font file format. The OCR font context's control, constraint, and/or font character data can all be saved; which data is saved depends on the value of the Operation parameter.

The font character data contains the character representation of each character in the OCR font context. The control data includes controls used to specify the operational controls for a read/verify operation (such as M_BLANK_CHARACTERS, and M_TOUCHING_CHAR) and those used to set the characteristics of the target characters (such as M_THICKEN_CHAR, and M_TARGET_CHAR_SPACING). The constraint data specifies which characters can appear at given positions in the search string.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
FileName

Specifies the name and path of the file in which to save the font data. It is recommended that you use the MFO file extension for easier use with other Matrox Imaging software products. The function internally handles the opening and closing of this file. If this file already exists, it will be overwritten.

This parameter can be set to one of the following values:

function map For specifying the file name and path
CollapseValue Description
Collapse M_INTERACTIVE
[This is only applicable to Windows]

Opens the File Save As dialog box from which you can interactively specify the drive, directory, and name of the file.
Collapse MIL_TEXT("FileName") 1

Specifies the drive, directory, and name of the file (for example, "C:\mydirectory\myfile").

To specify a file on a remote computer (under Distributed MIL), prefix the specified file name string with "remote:///" (for example, "remote:///C:\mydirectory\myfile").

(summarize)

1 If you are passing the value in a variable, don't enclose it in MIL_TEXT().

Operation

Specifies which data to save to disk. The Operation parameter can take one of the following values:

function map For specifying the data to save
CollapseValue Description
Collapse M_DEFAULT

Saves the same data as M_SAVE.
Collapse M_SAVE

Saves the OCR font context.
Collapse M_SAVE_CONSTRAINT

Saves only character constraint data.
Collapse M_SAVE_CONTROL

Saves only control data.
FontContextOcrId

Specifies the OCR font context to be saved.

Compilation information
Header Include mil.h.
Library Use mil.lib; milocr.lib.
DLL Requires mil.dll; milocr.dll.
INTERACTIVE DEFAULT SAVE SAVE CONSTRAINT SAVE CONTROL