MdmrName

• See also
User Guide:
Fonts
Reference:
MdmrAlloc MdmrInquire
Availability
Not available in MIL-Lite
Available in MIL


Available on Windows
Available on Linux


Not supported on:
Not supported on Matrox Indio (Update 53 or Update 68) (w)
Not supported on Matrox Concord PoE with ToE (Update 82) (z)
Fully supported on:
Fully supported on Host system (a)
Fully supported on Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)* (c)
Fully supported on Matrox Morphis (g)
Fully supported on Matrox Morphis QxT (h)
Fully supported on Matrox Orion HD (i)
Fully supported on Matrox Radient eCL (j)
Fully supported on Matrox Radient eV-CXP (MIL 10 or Update 29)* (k)
Fully supported on Matrox Solios eA/XA (l)
Fully supported on Matrox Solios ecl/xcl/ev-cl (m)
Fully supported on Matrox USB3 Vision driver (Update 19) (o)
Fully supported on Matrox RadientPro-CL (Update 7) (p)
Fully supported on Matrox Radient eV-CL (Update 27 or 74) (r)
Fully supported on Matrox Iris GTR (Update 28 or Update 68) (t)
Fully supported on Matrox Clarity UHD (Update 36 or 76) (u)
Fully supported on Matrox GenTL driver (Update 34) (v)
Fully supported on Matrox Rapixo CXP (Update 75 or Update 84) (y)
Fully supported on Matrox Rapixo CL Pro (Update 96) (aa)


* Refer to the MIL system-specific information
   in the MIL Reference for the minimum update required.


For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note


Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP/GPm
Available on Matrox Supersight
Function map
Examples
None.
MdmrInquireStringModel
MdmrPreprocess

Description

Parameters

ContextDmrId

Specifies the identifier of the SureDotOCR context containing the font or string model with which to perform the name operation. The context must have been previously allocated on the system using MdmrAlloc().

Operation

Specifies the name operation to perform. Set this parameter to one of the values below. Unless otherwise specified, the LabelOrIndex parameter can specify a font or string model, the Name parameter must specify the name information related to the operation, and the ValuePtr parameter must specify the address at which to write the information requested by the name operation.

For specifying the name operation
Value	Description
M_GET_FONT_INDEX	Retrieves the index of the font, based on the specified name. Set the LabelOrIndex parameter to M_DEFAULT. (summarize) Retrieves the index of the font, based on the specified name. (more details...)
M_GET_FONT_LABEL	Retrieves the label of the font, based on the specified name. Set the LabelOrIndex parameter to M_DEFAULT. (summarize) Retrieves the label of the font, based on the specified name. (more details...)
M_GET_NAME	Retrieves the name, and name length, of the specified font or string model. Use the Name parameter to retrieve the name. Use the ValuePtr parameter to retrieve the length of the name. (summarize) Retrieves the name, and name length, of the specified font or string model. (more details...)
M_GET_STRING_INDEX	Retrieves the index of the string model, based on the specified name. Set the LabelOrIndex parameter to M_DEFAULT. (summarize) Retrieves the index of the string model, based on the specified name. (more details...)
M_GET_STRING_LABEL	Retrieves the label of the string model, based on the specified name. Set the LabelOrIndex parameter to M_DEFAULT. (summarize) Retrieves the label of the string model, based on the specified name. (more details...)
M_SET_NAME	Sets the name of the font or string model, or releases the name of the font or string model. When setting a name, ensure it is not already used. All font names must be unique among font names and all string model names must be unique among string model names. When releasing a name, set the Name parameter to M_NULL. Once released, you can use the name again. (summarize) Sets the name of the font or string model, or releases the name of the font or string model. (more details...)

LabelOrIndex

Specifies the label or index value of the font or string model with which to perform the name operation. Set this parameter to M_DEFAULT when not required by the name operation.

For specifying the label or index value
Value	Description
M_FONT_INDEX( MIL_INT IndexValue )	Specifies a font by indicating its index. (summarize) Specifies a font by indicating its index. (more details...)
		Parameters
		IndexValue Set this parameter to the following:
			0 <= Value < M_NUMBER_OF_FONTS Specifies the index of the font.
M_FONT_LABEL( MIL_INT LabelValue )	Specifies a font by indicating its label. (summarize) Specifies a font by indicating its label. (more details...)
		Parameters
		LabelValue Set this parameter to the following:
			Value > 0 Specifies the label of the font.
M_STRING_INDEX( MIL_INT IndexValue )	Specifies a string model by indicating its index. (summarize) Specifies a string model by indicating its index. (more details...)
		Parameters
		IndexValue Set this parameter to the following:
			0 <= Value < M_NUMBER_OF_STRING_MODELS Specifies the index of the string model.
M_STRING_LABEL( MIL_INT LabelValue )	Specifies a string model by indicating its label. (summarize) Specifies a string model by indicating its label. (more details...)
		Parameters
		LabelValue Set this parameter to the following:
			Value > 0 Specifies the label of the string model.

Name

Specifies the name. Use this parameter to set, get, or release the name, depending on the name operation. If the operation is getting a label and it fails, SureDotOCR returns 0. If the operation is getting an index and it fails, SureDotOCR returns -1. To release the name of a font or string model, set this parameter to M_NULL and specify M_SET_NAME.

ValuePtr

Specifies the address at which to write the information requested by the name operation.

Set this parameter to M_NULL when not required by the name operation.

ControlFlag

Reserved for future expansion and must be set to M_DEFAULT.