MstrGetResult

See also

User Guide:

Adding and deleting string models to the context Degrees of freedom Fixing read problems using String Expert Global context settings Retrieving results and annotation Scores and acceptances Steps to reading a string in an image

Reference:

MstrControl MstrEditFont MstrExpert MstrFree MstrInquire MstrRead

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

mstr.cpp
mstr.cs
mstr.vb
tirestringread.cpp
usdotnumberstr.cpp

Function Map

- ResultId

- Index

Table:

For specifying where to get results

- ResultType

- ResultArrayPtr

Parameter Associations

Table:	For retrieving general results
Table:	For individual strings
+ combination:	For getting the string size
Table:	For individual characters of a string
Table:	For retrieving transformation coefficient results for individual characters of a string with a font-based context
Table:	For retrieving errors or warnings reported by the last call to MstrExpert()
+ combination:	For determining the required array size (number of elements) to store the returned values
+ combination:	For determining whether results are available
+ combination:	For casting the result to a required data type

Compilation information

Synopsis

Get the specified type of result(s) from a String Reader result buffer.

Syntax

void MstrGetResult(

MIL_ID ResultId,	//in
MIL_INT Index,	//in
MIL_INT64 ResultType,	//in
void *ResultArrayPtr	//out

)

Description

This function retrieves the result(s) of the specified type from a String Reader result buffer. Results are only available after calling MstrRead().

When retrieving results, you will need to know the required type and size of the array in which to store the results. Typically, the default data type is MIL_DOUBLE. For certain results (such as, M_TEXT, M_FORMATTED_STRING, and M_STRING), the default type of the required array depends on the selected encoding scheme (MstrControl() with M_ENCODING). You can specify any data type by explicitly adding it to the result. The size of the array depends on the result type.

Unless otherwise specified, the value settings are applicable to both font based and fontless contexts.

If your target image (MstrRead()) was associated with a camera calibration context, positional and dimensional results are, by default, returned with respect to the relative coordinate system of the image. Otherwise, these results are returned in pixels, relative to the center of top-left pixel in the target image.

If your target image was associated with a camera calibration context but you want to retrieve positional and dimensional results in pixel units, use MstrControl() with the M_RESULT_OUTPUT_UNITS control type set to M_PIXEL. However, if you set M_RESULT_OUTPUT_UNITS to M_WORLD without specifying a calibrated image in which to calculate the results, MstrGetResult() generates an error.

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 which MIL system’s documentation you should use in its place and any possible differences.

Parameters

This function is not supported on the selected boards.

This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.

Parameters

ResultId

Specifies the identifier of the String Reader result buffer from which to retrieve results.

Index

Specifies where to get results. This parameter can be set to one of the following:

For specifying where to get results
Value	Description
M_DEFAULT	Same as M_ALL.
M_ALL	Specifies that the results of all strings will be retrieved.
M_GENERAL	Specifies that the results relating to the entire String Reader context will be retrieved.
0 <= Value < M_STRING_NUMBER	Specifies the index of the string from which to get results.

ResultType

Specifies the type of result to retrieve.

See the Parameter associations section for possible values that can be specified.

ResultArrayPtr

Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):

array of type char [optionally, in C++: a reference to a std::vector<char> ]
array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ]
array of type MIL_FLOAT [optionally, in C++: a reference to a std::vector<MIL_FLOAT> ]
array of type MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID> ]
array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ]
array of type MIL_INT16 [optionally, in C++: a reference to a std::vector<MIL_INT16> ]
array of type MIL_INT32 [optionally, in C++: a reference to a std::vector<MIL_INT32> ]
array of type MIL_INT64 [optionally, in C++: a reference to a std::vector<MIL_INT64> ]
array of type MIL_TEXT_CHAR [optionally, in C++: a reference to a MIL_STRING]
array of type short [optionally, in C++: a reference to a std::vector<short> ]
char
MIL_DOUBLE
MIL_FLOAT
MIL_ID
MIL_INT
MIL_INT16
MIL_INT32
MIL_INT64
MIL_TEXT_CHAR

Specifies the address in which to write results.

See the Parameter associations section for possible values that can be returned.

Parameter associations

The tables below list possible values for the ResultType parameter and possible values returned to the ResultArrayPtr parameter.

For retrieving general results
For individual strings
For individual characters of a string
For retrieving transformation coefficient results for individual characters of a string with a font-based context
For retrieving errors or warnings reported by the last call to MstrExpert()

When retrieving a general result (M_GENERAL), the ResultType parameter can be set to one of the following values.

For retrieving general results
ResultType		Description
	ResultArrayPtr - Possible values returned	Description
M_CHAR_NUMBER +		Retrieves the total number of characters read (all strings together). (summarize) Retrieves the total number of characters read (all strings together). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
M_CONTEXT_ID +		Retrieves the identifier of the String Reader context used by MstrRead() to obtain the results in the result buffer. Note that this identifier might not be valid if the String Reader context has been freed using MstrFree(). (summarize) Retrieves the identifier of the String Reader context used by MstrRead() to obtain the results in the result buffer. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE MORE Data type: address of a MIL_DOUBLE Recommended casting type: MIL_ID Data type info: Data type: address of a MIL_DOUBLE MORE Data type: address of a MIL_DOUBLE Recommended casting type: MIL_ID
M_ENCODING +		Retrieves the type of character encoding that MstrRead() used to generate the contents of the result buffer. (summarize) Retrieves the type of character encoding that MstrRead() used to generate the contents of the result buffer. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	M_ASCII	Specifies that the characters were encoded with an 8-bit ASCII standard.
	M_UNICODE	Specifies that the characters were encoded with a 16-bit Unicode standard.
M_STRING_NUMBER +		Retrieves the total number of strings read. (summarize) Retrieves the total number of strings read. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
M_TEXT +		Retrieves the entire text. This includes all string characters, the inserted space characters, the string separators, and the terminating null character ("\0"). Strings are ordered in the natural Latin-based reading order. A space character is inserted in the text each time the distance between two adjacent characters exceeds the space width, at the scale of the string. The inserted space character can be set using MstrControl() with M_SPACE_CHARACTER. By default, the inserted space character is a space (ASCII code 32). Note that a string separator is inserted between different strings when getting all strings simultaneously. The string separator can be set using MstrControl() with M_STRING_SEPARATOR. By default, the string separator is a new line (ASCII code 10). Refer to M_STRING to retrieve the strings without separators. Refer to M_FORMATTED_STRING to retrieve the formatted string. (summarize) Retrieves the entire text. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] \| array of type short [optionally, in C++: a reference to a std::vector<short> ] MORE Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size: MstrGetResult ( M_TEXT + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_ASCII. Data type: array of type short [optionally, in C++: a reference to a std::vector<short> ] Required array size: MstrGetResult ( M_TEXT + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_UNICODE. Data type info: Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] \| array of type short [optionally, in C++: a reference to a std::vector<short> ] MORE Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size: MstrGetResult ( M_TEXT + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_ASCII. Data type: array of type short [optionally, in C++: a reference to a std::vector<short> ] Required array size: MstrGetResult ( M_TEXT + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_UNICODE.
M_TEXT_ALLOC_SIZE_BYTE +		Retrieves the number of bytes required to retrieve M_TEXT result(s). This includes all string characters, the inserted space characters, the string separators, the terminating null character ("\0"), and takes the encoding bit size into account (MstrControl() with M_ENCODING). Note that the size returned is always the number of bytes, not the number of characters. (summarize) Retrieves the number of bytes required to retrieve M_TEXT result(s). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
M_TIMEOUT_END +		Retrieves whether the timeout limit was reached. You can set the timeout limit using MstrControl() with M_TIMEOUT. (summarize) Retrieves whether the timeout limit was reached. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	M_FALSE	Specifies that the timeout limit was not reached.
	M_TRUE	Specifies that the timeout limit was reached.

When retrieving individual string results, the ResultType parameter can be set to one of the following values. Results can be retrieved for a specific string, or for all strings (M_ALL), unless otherwise specified. Note that strings are ordered in the natural Latin-based reading order.

For individual strings
ResultType		Description
	ResultArrayPtr - Possible values returned	Description
M_CHAR_ANGLE +		Retrieves the angle of the characters in the string, in degrees. The angle is the same for all the characters in the string; different angles for individual characters within a string cannot be obtained. The characters' angle is not necessarily equal to the string's angle. The angle is measured counter-clockwise, from the positive X-axis towards the negative Y-axis of the image. (summarize) Retrieves the angle of the characters in the string, in degrees. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_CHAR_ANGLE + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_CHAR_ANGLE + M_NB_ELEMENTS ) Note: when retrieving all results
M_FOREGROUND_VALUE +		Retrieves the foreground value of the string read. (summarize) Retrieves the foreground value of the string read. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_FOREGROUND_VALUE + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_FOREGROUND_VALUE + M_NB_ELEMENTS ) Note: when retrieving all results
M_FORMATTED_STRING +		Retrieves the formatted string. This includes all strings characters, the inserted space characters, and the terminating null character ("\0"). A space character is inserted in the formatted string each time the distance between two adjacent characters exceeds the space width, at the scale of the string. The inserted space character can be set using MstrControl() with M_SPACE_CHARACTER. By default, the inserted space character is a space (ASCII code 32). Note that a space character is inserted between different strings when getting all strings simultaneously. Refer to M_STRING to retrieve the strings without separators. Refer to M_TEXT to retrieve the entire text. (summarize) Retrieves the formatted string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] \| array of type short [optionally, in C++: a reference to a std::vector<short> ] \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size: MstrGetResult ( M_FORMATTED_STRING + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_ASCII. Data type: array of type short [optionally, in C++: a reference to a std::vector<short> ] Required array size: MstrGetResult ( M_FORMATTED_STRING + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_UNICODE. Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size: MstrGetResult ( M_STRING_NUMBER ) Note: When retrieving all results Data type info: Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] \| array of type short [optionally, in C++: a reference to a std::vector<short> ] \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size: MstrGetResult ( M_FORMATTED_STRING + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_ASCII. Data type: array of type short [optionally, in C++: a reference to a std::vector<short> ] Required array size: MstrGetResult ( M_FORMATTED_STRING + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_UNICODE. Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size: MstrGetResult ( M_STRING_NUMBER ) Note: When retrieving all results
M_SKEW_ANGLE +		Retrieves the angle of the characters' skew in the string, in degrees. The angle is the same for all the characters in the string; different angles for individual characters within a string cannot be obtained. (summarize) Retrieves the angle of the characters' skew in the string, in degrees. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_SKEW_ANGLE + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_SKEW_ANGLE + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING +		Retrieves the null terminated string found during the read operation. The string does not contain any space characters or string separators. Refer to M_CHAR_VALUE to retrieve all characters of all strings without the terminating null character ("\0"). Refer to M_FORMATTED_STRING or M_TEXT to retrieve all strings with their space characters and/or string separators. (summarize) Retrieves the null terminated string found during the read operation. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] \| array of type short [optionally, in C++: a reference to a std::vector<short> ] \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size: MstrGetResult ( M_STRING + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_ASCII. Data type: array of type short [optionally, in C++: a reference to a std::vector<short> ] Required array size: MstrGetResult ( M_STRING + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_UNICODE. Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size: MstrGetResult ( M_STRING_NUMBER ) Note: when retrieving all results Data type info: Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] \| array of type short [optionally, in C++: a reference to a std::vector<short> ] \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size: MstrGetResult ( M_STRING + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_ASCII. Data type: array of type short [optionally, in C++: a reference to a std::vector<short> ] Required array size: MstrGetResult ( M_STRING + M_STRING_SIZE ) Note: Applies when MstrControl() with M_ENCODING is set to M_UNICODE. Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size: MstrGetResult ( M_STRING_NUMBER ) Note: when retrieving all results
M_STRING_ALLOC_SIZE_BYTE +		Retrieves the number of bytes required to retrieve M_STRING result(s). This includes the terminating null character ("\0"), and takes the encoding bit size into account (MstrControl() with M_ENCODING). M_STRING_ALLOC_SIZE_BYTE is typically used when retrieving all results (M_ALL), and will return an array of string size byte (1 element for each string). Note that the size is always the number of bytes, not the number of characters. (summarize) Retrieves the number of bytes required to retrieve M_STRING result(s). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_ALLOC_SIZE_BYTE + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_ALLOC_SIZE_BYTE + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_ANGLE +		Retrieves the angle of the string, in degrees. An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise, from the positive X-axis towards the negative Y-axis of the image. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup. (summarize) Retrieves the angle of the string, in degrees. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_ANGLE + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_ANGLE + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_ASPECT_RATIO +		Retrieves the aspect ratio of the string. The aspect ratio of the string is the median aspect ratio of all the characters in the string. Note that this control type is only available for a font-based context. (summarize) Retrieves the aspect ratio of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_ASPECT_RATIO + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_ASPECT_RATIO + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_BOX_BL_X +		Retrieves the X-position of the bottom-left corner of the bounding box of the string. (summarize) Retrieves the X-position of the bottom-left corner of the bounding box of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_BL_X + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_BL_X + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_BOX_BL_Y +		Retrieves the Y-position of the bottom-left corner of the bounding box of the string. (summarize) Retrieves the Y-position of the bottom-left corner of the bounding box of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_BL_Y + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_BL_Y + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_BOX_BR_X +		Retrieves the X-position of the bottom-right corner of the bounding box of the string. (summarize) Retrieves the X-position of the bottom-right corner of the bounding box of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_BR_X + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_BR_X + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_BOX_BR_Y +		Retrieves the Y-position of the bottom-right corner of the bounding box of the string. (summarize) Retrieves the Y-position of the bottom-right corner of the bounding box of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_BR_Y + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_BR_Y + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_BOX_UL_X +		Retrieves the X-position of the top-left corner of the bounding box of the string. (summarize) Retrieves the X-position of the top-left corner of the bounding box of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_UL_X + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_UL_X + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_BOX_UL_Y +		Retrieves the Y-position of the top-left corner of the bounding box of the string. (summarize) Retrieves the Y-position of the top-left corner of the bounding box of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_UL_Y + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_UL_Y + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_BOX_UR_X +		Retrieves the X-position of the top-right corner of the bounding box of the string. (summarize) Retrieves the X-position of the top-right corner of the bounding box of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_UR_X + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_UR_X + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_BOX_UR_Y +		Retrieves the Y-position of the top-right corner of the bounding box of the string. (summarize) Retrieves the Y-position of the top-right corner of the bounding box of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_UR_Y + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_BOX_UR_Y + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_CHAR_NUMBER +		Retrieves the number of characters in the string found during the read operation, not including the terminating null character ("\0"); this means it returns the number of characters with results. In addition, space characters are not counted in the string size. (summarize) Retrieves the number of characters in the string found during the read operation, not including the terminating null character ("\0"); this means it returns the number of characters with results. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_CHAR_NUMBER + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_CHAR_NUMBER + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_CHAR_SCORE_MAX +		Retrieves the maximum character score of the string. (summarize) Retrieves the maximum character score of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_CHAR_SCORE_MAX + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_CHAR_SCORE_MAX + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_CHAR_SCORE_MIN +		Retrieves the minimum character score of the string. (summarize) Retrieves the minimum character score of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_CHAR_SCORE_MIN + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_CHAR_SCORE_MIN + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_MODEL_INDEX +		Retrieves the index of the string model read. (summarize) Retrieves the index of the string model read. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_MODEL_INDEX + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_MODEL_INDEX + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_MODEL_USER_LABEL +		Retrieves the user label of the string model read. (summarize) Retrieves the user label of the string model read. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_MODEL_USER_LABEL + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_MODEL_USER_LABEL + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_POSITION_X +		Retrieves the X-position of the string. The position of the string is the position of its first character. For more information, see M_CHAR_POSITION_X. (summarize) Retrieves the X-position of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_POSITION_X + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_POSITION_X + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_POSITION_Y +		Retrieves the Y-position of the string. The position of the string is the position of its first character. For more information, see M_CHAR_POSITION_Y. (summarize) Retrieves the Y-position of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_POSITION_Y + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_POSITION_Y + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_SCALE +		Retrieves the scale of the string. The scale of the string is the median scale in the X-direction of all the characters in the string. (summarize) Retrieves the scale of the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_SCALE + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_SCALE + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_SCORE +		Retrieves the string score calculated during the read operation for the entire string. The string score is the average score of the characters in the string. (summarize) Retrieves the string score calculated during the read operation for the entire string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_SCORE + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_SCORE + M_NB_ELEMENTS ) Note: when retrieving all results
M_STRING_TARGET_SCORE +		Retrieves the string target score calculated during the read operation for the entire string. The string target score is computed from the unread characters that are in the region of the string in the target image. These otherwise readable characters remain unread due to user-specified constraints, such as scale and grammar restrictions. The more unread characters there are, the lower the target score will be. (summarize) Retrieves the string target score calculated during the read operation for the entire string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_TARGET_SCORE + M_NB_ELEMENTS ) Note: when retrieving all results Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_NUMBER ) MstrGetResult ( M_STRING_TARGET_SCORE + M_NB_ELEMENTS ) Note: when retrieving all results

Combination value for M_FORMATTED_STRING; M_STRING; M_TEXT.

You can add the following value to the above-mentioned values to get the string's length..

For getting the string size
ResultType		Description
	ResultArrayPtr - Possible values returned	Description
M_STRING_SIZE +		Retrieves the length of one or more strings, including the terminating null character ("\0"). In the case of M_TEXT, it also includes string separators. This combination constant is useful to establish the required array size to retrieve the string. (summarize) Retrieves the length of one or more strings, including the terminating null character ("\0"). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE

When retrieving results for individual characters of a string, the ResultType parameter can be set to one of the following values. Results can be returned for characters of a specific string or for characters of all (M_ALL) strings. However, an array of results is always returned. Note that characters in the string are ordered by their index position in the string.

For individual characters of a string
ResultType		Description
	ResultArrayPtr - Possible values returned	Description
M_CHAR_ASPECT_RATIO +		Retrieves the aspect ratio of the character. The aspect ratio of the character is the ratio of its scale in the X-direction and in the Y-direction. Note that this control type is only available for a font-based context. (summarize) Retrieves the aspect ratio of the character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_ASPECT_RATIO + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_ASPECT_RATIO + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_ASPECT_RATIO + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_ASPECT_RATIO + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_BASELINE_DEVIATION +		Retrieves the baseline deviation of every read character within the string. This represents the deviation of the character's baseline from the string's baseline. For non-punctuation characters, this value is a percentage of the character's height (Y-size). For punctuation characters, this value is a percentage of the height of the tallest character within the font. For more information, refer to MstrControl() with M_CHAR_MAX_BASELINE_DEVIATION and the Character's maximum baseline deviation subsection of the Degrees of freedom section of Chapter 13: String Reader. Note that if the character's baseline is set to M_NONE, its deviation will always be returned as '0'. Note that this control type is only available for a font-based context. (summarize) Retrieves the baseline deviation of every read character within the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BASELINE_DEVIATION + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BASELINE_DEVIATION + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BASELINE_DEVIATION + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BASELINE_DEVIATION + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_BOX_BL_X +		Retrieves the X-position of the bottom-left corner of the bounding box of each character. (summarize) Retrieves the X-position of the bottom-left corner of the bounding box of each character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BL_X + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BL_X + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BL_X + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BL_X + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_BOX_BL_Y +		Retrieves the Y-position of the bottom-left corner of the bounding box of each character. (summarize) Retrieves the Y-position of the bottom-left corner of the bounding box of each character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BL_Y + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BL_Y + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BL_Y + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BL_Y + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_BOX_BR_X +		Retrieves the X-position of the bottom-right corner of the bounding box of each character. (summarize) Retrieves the X-position of the bottom-right corner of the bounding box of each character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BR_X + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BR_X + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BR_X + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BR_X + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_BOX_BR_Y +		Retrieves the Y-position of the bottom-right corner of the bounding box of each character. (summarize) Retrieves the Y-position of the bottom-right corner of the bounding box of each character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BR_Y + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BR_Y + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BR_Y + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_BR_Y + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_BOX_UL_X +		Retrieves the X-position of the top-left corner of the bounding box of each character. (summarize) Retrieves the X-position of the top-left corner of the bounding box of each character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UL_X + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UL_X + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UL_X + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UL_X + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_BOX_UL_Y +		Retrieves the Y-position of the top-left corner of the bounding box of each character. (summarize) Retrieves the Y-position of the top-left corner of the bounding box of each character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UL_Y + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UL_Y + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UL_Y + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UL_Y + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_BOX_UR_X +		Retrieves the X-position of the top-right corner of the bounding box of each character. (summarize) Retrieves the X-position of the top-right corner of the bounding box of each character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UR_X + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UR_X + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UR_X + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UR_X + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_BOX_UR_Y +		Retrieves the Y-position of the top-right corner of the bounding box of each character. (summarize) Retrieves the Y-position of the top-right corner of the bounding box of each character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UR_Y + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UR_Y + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UR_Y + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_BOX_UR_Y + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_CONSECUTIVE_SPACE +		Retrieves the number of consecutive spaces that can be inserted between this character and the following one in the string. For more information, refer to M_SPACE_WIDTH and M_SPACE_MAX_CONSECUTIVE in MstrControl(). (summarize) Retrieves the number of consecutive spaces that can be inserted between this character and the following one in the string. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_CONSECUTIVE_SPACE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_CONSECUTIVE_SPACE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_CONSECUTIVE_SPACE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_CONSECUTIVE_SPACE + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_FONT +		Retrieves the index of the font of each individual character within the string(s). The index returned is that of the character's font at the moment the MstrRead() operation was performed. Note that this control type is only available for a font-based context. (summarize) Retrieves the index of the font of each individual character within the string(s). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_FONT + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_FONT + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_FONT + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_FONT + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_FONT_USER_LABEL +		Retrieves the user label of the font of each individual character within the string(s). Note that this control type is only available for a font-based context. (summarize) Retrieves the user label of the font of each individual character within the string(s). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_FONT_USER_LABEL + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_FONT_USER_LABEL + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_FONT_USER_LABEL + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_FONT_USER_LABEL + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_HOMOGENEITY_SCORE +		Retrieves the homogeneity score of each individual character within the string(s). The character's homogeneity score quantifies the similarity between the character in the target and the other characters of the string in the target. (summarize) Retrieves the homogeneity score of each individual character within the string(s). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_HOMOGENEITY_SCORE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_HOMOGENEITY_SCORE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_HOMOGENEITY_SCORE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_HOMOGENEITY_SCORE + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_INDEX +		Retrieves the index of the character in the font for each individual character within the string(s). The index returned is that of the index of the character in its font at the moment the MstrRead() operation was performed. Note that this control type is only available for a font-based context. (summarize) Retrieves the index of the character in the font for each individual character within the string(s). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_INDEX + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_INDEX + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_INDEX + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_INDEX + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_POSITION_X +		Retrieves the X-position of the character. The position of a character is the position of its center of gravity. (summarize) Retrieves the X-position of the character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_POSITION_X + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_POSITION_X + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_POSITION_X + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_POSITION_X + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_POSITION_Y +		Retrieves the Y-position of the character. The position of a character is the position of its center of gravity. (summarize) Retrieves the Y-position of the character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_POSITION_Y + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_POSITION_Y + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_POSITION_Y + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_POSITION_Y + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_SCALE +		Retrieves the scale of the character. The scale of the character is its scale in the X-direction. (summarize) Retrieves the scale of the character. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SCALE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SCALE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SCALE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SCALE + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_SCORE +		Retrieves the score of each individual character within the string(s). The character's score quantifies the similarity between the character in the target and the character in the font; it also quantifies the similarity between the character in the target and the other characters of the string in the target. (summarize) Retrieves the score of each individual character within the string(s). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SCORE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SCORE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SCORE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SCORE + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_SIMILARITY_SCORE +		Retrieves the similarity score of each individual character within the string(s). The character's similarity score quantifies the similarity between the character in the target and the character in the font. (summarize) Retrieves the similarity score of each individual character within the string(s). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SIMILARITY_SCORE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SIMILARITY_SCORE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SIMILARITY_SCORE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_SIMILARITY_SCORE + M_NB_ELEMENTS ) Note: when retrieving all strings
M_CHAR_VALUE +		Retrieves the value of each character read. (summarize) Retrieves the value of each character read. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] \| array of type short [optionally, in C++: a reference to a std::vector<short> ] MORE Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_VALUE + M_NB_ELEMENTS ) Note: Applies when MstrControl() with M_ENCODING is set to M_ASCII. Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_VALUE + M_NB_ELEMENTS ) Note: Applies when MstrControl() with M_ENCODING is set to M_ASCII. Data type: array of type short [optionally, in C++: a reference to a std::vector<short> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_VALUE + M_NB_ELEMENTS ) Note: Applies when MstrControl() with M_ENCODING is set to M_UNICODE. Data type: array of type short [optionally, in C++: a reference to a std::vector<short> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_VALUE + M_NB_ELEMENTS ) Note: Applies when MstrControl() with M_ENCODING is set to M_UNICODE. Data type info: Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] \| array of type short [optionally, in C++: a reference to a std::vector<short> ] MORE Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_VALUE + M_NB_ELEMENTS ) Note: Applies when MstrControl() with M_ENCODING is set to M_ASCII. Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_VALUE + M_NB_ELEMENTS ) Note: Applies when MstrControl() with M_ENCODING is set to M_ASCII. Data type: array of type short [optionally, in C++: a reference to a std::vector<short> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_CHAR_VALUE + M_NB_ELEMENTS ) Note: Applies when MstrControl() with M_ENCODING is set to M_UNICODE. Data type: array of type short [optionally, in C++: a reference to a std::vector<short> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_CHAR_VALUE + M_NB_ELEMENTS ) Note: Applies when MstrControl() with M_ENCODING is set to M_UNICODE.

When retrieving transformation coefficient results for individual characters of a string, the ResultType parameter can be set to one of the following values.

Transformation coefficients allow you to transform any point from the character's source image (the image from which the characters were defined) to its corresponding position in the target image (forward), or from the read position in the target image to its corresponding position in the character's source image (reverse). This is done using the following equations:

x _d = A x _s + B y _s + C

y _d = D x _s + E y _s + F

where A, B, C, D, E, and F are the transformation coefficients (forward or reverse); x _s and y _s specify the source coordinates (character image for forward transformation or target image for reverse transformation); and, x _d and y _d specify the destination coordinates (target image for forward transformation or character image for reverse transformation).

For retrieving transformation coefficient results for individual characters of a string with a font-based context
ResultType		Description
	ResultArrayPtr - Possible values returned	Description
M_A_FORWARD +		Retrieves the forward transformation coefficient A. (summarize) Retrieves the forward transformation coefficient A. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_A_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_A_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_A_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_A_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings
M_A_REVERSE +		Retrieves the reverse transformation coefficient A. (summarize) Retrieves the reverse transformation coefficient A. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_A_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_A_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_A_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_A_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings
M_B_FORWARD +		Retrieves the forward transformation coefficient B. (summarize) Retrieves the forward transformation coefficient B. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_B_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_B_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_B_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_B_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings
M_B_REVERSE +		Retrieves the reverse transformation coefficient B. (summarize) Retrieves the reverse transformation coefficient B. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_B_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_B_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_B_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_B_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings
M_C_FORWARD +		Retrieves the forward transformation coefficient C. (summarize) Retrieves the forward transformation coefficient C. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_C_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_C_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_C_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_C_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings
M_C_REVERSE +		Retrieves the reverse transformation coefficient C. (summarize) Retrieves the reverse transformation coefficient C. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_C_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_C_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_C_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_C_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings
M_D_FORWARD +		Retrieves the forward transformation coefficient D. (summarize) Retrieves the forward transformation coefficient D. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_D_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_D_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_D_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_D_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings
M_D_REVERSE +		Retrieves the reverse transformation coefficient D. (summarize) Retrieves the reverse transformation coefficient D. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_D_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_D_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_D_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_D_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings
M_E_FORWARD +		Retrieves the forward transformation coefficient E. (summarize) Retrieves the forward transformation coefficient E. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_E_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_E_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_E_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_E_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings
M_E_REVERSE +		Retrieves the reverse transformation coefficient E. (summarize) Retrieves the reverse transformation coefficient E. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_E_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_E_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_E_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_E_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings
M_F_FORWARD +		Retrieves the forward transformation coefficient F. (summarize) Retrieves the forward transformation coefficient F. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_F_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_F_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_F_FORWARD + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_F_FORWARD + M_NB_ELEMENTS ) Note: when retrieving all strings
M_F_REVERSE +		Retrieves the reverse transformation coefficient F. (summarize) Retrieves the reverse transformation coefficient F. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_F_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_F_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_STRING_CHAR_NUMBER ) MstrGetResult ( M_F_REVERSE + M_NB_ELEMENTS ) Note: when retrieving a specific string Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrGetResult ( M_CHAR_NUMBER ) MstrGetResult ( M_F_REVERSE + M_NB_ELEMENTS ) Note: when retrieving all strings

When retrieving errors or warnings reported by the last call to MstrExpert(), the ResultType parameter can be set to one of the following values.

To retrieve general errors or warnings (relating to the entire String Reader context), the Index parameter must be set to M_GENERAL. To retrieve errors or warnings for a specific string, or for all strings, the Index parameter must be set to the string's index, or to M_ALL.

For retrieving errors or warnings reported by the last call to MstrExpert()
ResultType		Description
	ResultArrayPtr - Possible values returned	Description
M_REPORT_ERRORS +		Retrieves a list of all the errors reported by the last call to MstrExpert(). To inquire the string associated with an error, use MstrInquire() with M_REPORT_STRING. (summarize) Retrieves a list of all the errors reported by the last call to MstrExpert(). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] MORE Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] Required array size (either of the following): MstrGetResult ( M_REPORT_NUMBER_OF_ERRORS ) MstrGetResult ( M_REPORT_ERRORS + M_NB_ELEMENTS ) Note: when retrieving general errors, using MstrGetResult() with M_GENERAL or when retrieving errors for a specific string index Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] Required array size (either of the following): MstrGetResult ( M_REPORT_NUMBER_OF_ERRORS ) MstrGetResult ( M_REPORT_ERRORS + M_NB_ELEMENTS ) Note: when retrieving errors for all strings Data type info: Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] MORE Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] Required array size (either of the following): MstrGetResult ( M_REPORT_NUMBER_OF_ERRORS ) MstrGetResult ( M_REPORT_ERRORS + M_NB_ELEMENTS ) Note: when retrieving general errors, using MstrGetResult() with M_GENERAL or when retrieving errors for a specific string index Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] Required array size (either of the following): MstrGetResult ( M_REPORT_NUMBER_OF_ERRORS ) MstrGetResult ( M_REPORT_ERRORS + M_NB_ELEMENTS ) Note: when retrieving errors for all strings
M_REPORT_NUMBER_OF_ERRORS +		Retrieves the number of errors reported by the last call to MstrExpert(). (summarize) Retrieves the number of errors reported by the last call to MstrExpert(). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving general errors, using MstrGetResult() with M_GENERAL or when retrieving errors for a specific string index Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrInquire ( M_NUMBER_OF_STRING_MODELS ) MstrGetResult ( M_REPORT_NUMBER_OF_ERRORS + M_NB_ELEMENTS ) Note: when retrieving errors for all strings Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving general errors, using MstrGetResult() with M_GENERAL or when retrieving errors for a specific string index Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrInquire ( M_NUMBER_OF_STRING_MODELS ) MstrGetResult ( M_REPORT_NUMBER_OF_ERRORS + M_NB_ELEMENTS ) Note: when retrieving errors for all strings
M_REPORT_NUMBER_OF_WARNINGS +		Retrieves the number of warnings reported by the last call to MstrExpert(). (summarize) Retrieves the number of warnings reported by the last call to MstrExpert(). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving warnings, using MstrGetResult() with M_GENERAL or when retrieving warnings for a specific string index Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrInquire ( M_NUMBER_OF_STRING_MODELS ) MstrGetResult ( M_REPORT_NUMBER_OF_WARNINGS + M_NB_ELEMENTS ) Note: when retrieving warnings for all strings Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: when retrieving warnings, using MstrGetResult() with M_GENERAL or when retrieving warnings for a specific string index Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size (either of the following): MstrInquire ( M_NUMBER_OF_STRING_MODELS ) MstrGetResult ( M_REPORT_NUMBER_OF_WARNINGS + M_NB_ELEMENTS ) Note: when retrieving warnings for all strings
M_REPORT_WARNINGS +		Retrieves a list of all the warnings reported by the last call to MstrExpert(). To inquire the string associated with a warning, use MstrInquire() with M_REPORT_STRING. (summarize) Retrieves a list of all the warnings reported by the last call to MstrExpert(). (more details...)
	ResultArrayPtr extra info	Data type info: Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] MORE Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] Required array size (either of the following): MstrGetResult ( M_REPORT_NUMBER_OF_WARNINGS ) MstrGetResult ( M_REPORT_WARNINGS + M_NB_ELEMENTS ) Note: when retrieving general warnings, using MstrGetResult() with M_GENERAL or when retrieving warnings for a specific string index Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] Required array size (either of the following): MstrGetResult ( M_REPORT_NUMBER_OF_WARNINGS ) MstrGetResult ( M_REPORT_WARNINGS + M_NB_ELEMENTS ) Note: when retrieving warnings for all strings Data type info: Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] MORE Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] Required array size (either of the following): MstrGetResult ( M_REPORT_NUMBER_OF_WARNINGS ) MstrGetResult ( M_REPORT_WARNINGS + M_NB_ELEMENTS ) Note: when retrieving general warnings, using MstrGetResult() with M_GENERAL or when retrieving warnings for a specific string index Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] Required array size (either of the following): MstrGetResult ( M_REPORT_NUMBER_OF_WARNINGS ) MstrGetResult ( M_REPORT_WARNINGS + M_NB_ELEMENTS ) Note: when retrieving warnings for all strings

Combination value for the values listed in For individual characters of a string; the values listed in For retrieving transformation coefficient results for individual characters of a string with a font-based context; the values listed in For retrieving errors or warnings reported by the last call to MstrExpert(); and for the following values: M_CHAR_ANGLE; M_CHAR_VALUE; M_FOREGROUND_VALUE; M_SKEW_ANGLE; M_STRING_ALLOC_SIZE_BYTE; M_STRING_ANGLE; M_STRING_ASPECT_RATIO; M_STRING_BOX_BL_X; M_STRING_BOX_BL_Y; M_STRING_BOX_BR_X; M_STRING_BOX_BR_Y; M_STRING_BOX_UL_X; M_STRING_BOX_UL_Y; M_STRING_BOX_UR_X; M_STRING_BOX_UR_Y; M_STRING_CHAR_NUMBER; M_STRING_CHAR_SCORE_MAX; M_STRING_CHAR_SCORE_MIN; M_STRING_MODEL_INDEX; M_STRING_MODEL_USER_LABEL; M_STRING_POSITION_X; M_STRING_POSITION_Y; M_STRING_SCALE; M_STRING_SCORE; M_STRING_TARGET_SCORE.

You can add the following value to the above-mentioned values to determine the required array size (number of elements) to store the returned values.

For determining the required array size (number of elements) to store the returned values
ResultType combination value		Description
	ResultArrayPtr - Possible values returned	Description
M_NB_ELEMENTS		Retrieves the required array size (number of elements) to store the returned values. (summarize) Retrieves the required array size (number of elements) to store the returned values. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE MORE Data type: address of a MIL_DOUBLE Recommended casting type: MIL_INT Data type info: Data type: address of a MIL_DOUBLE MORE Data type: address of a MIL_DOUBLE Recommended casting type: MIL_INT

Combination value for

Tables:

For retrieving general results
For individual strings
For individual characters of a string
For retrieving transformation coefficient results for individual characters of a string with a font-based context
For retrieving errors or warnings reported by the last call to MstrExpert()

the values listed in all the parameter association tables.

You can add the following value to the above-mentioned values to determine whether a result is available.

For determining whether results are available
ResultType		Description
	ResultArrayPtr - Possible values returned	Description
M_AVAILABLE		Retrieves whether a result is available to be returned. (summarize) Retrieves whether a result is available to be returned. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	M_NULL	Specifies that the result is not available to be retrieved.
	Value != 0	Specifies that the result is available to be retrieved.

Combination values for the values listed in For retrieving general results (exceptions might exist); the values listed in For individual strings (exceptions might exist); the values listed in For individual characters of a string (exceptions might exist); the values listed in For retrieving transformation coefficient results for individual characters of a string with a font-based context (exceptions might exist); the values listed in For retrieving errors or warnings reported by the last call to MstrExpert() (exceptions might exist); and for the following value: M_STRING_SIZE.

You can add one of the following values to the above-mentioned values to cast the requested results to a required data type.

Note: In C++, when using a standard vector (std::vector) instead of an array, the values listed in this combination table must not be used. If you need to use a specific data type, instantiate the vector with the necessary data type.

For casting the result to a required data type
ResultType		Description
	ResultArrayPtr - Possible values returned	Description
M_TYPE_CHAR		Casts the requested results to a char. (summarize) Casts the requested results to a char. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a char \| array of type char [optionally, in C++: a reference to a std::vector<char> ] MORE Data type: address of a char Note: When a single result. Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size:(defined elsewhere) Note: When multiple results. Data type info: Data type: address of a char \| array of type char [optionally, in C++: a reference to a std::vector<char> ] MORE Data type: address of a char Note: When a single result. Data type: array of type char [optionally, in C++: a reference to a std::vector<char> ] Required array size:(defined elsewhere) Note: When multiple results.
M_TYPE_MIL_DOUBLE		Casts the requested results to a MIL_DOUBLE. (summarize) Casts the requested results to a MIL_DOUBLE. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: When a single result. Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size:(defined elsewhere) Note: When multiple results. Data type info: Data type: address of a MIL_DOUBLE \| array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE Data type: address of a MIL_DOUBLE Note: When a single result. Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] Required array size:(defined elsewhere) Note: When multiple results.
M_TYPE_MIL_FLOAT		Casts the requested results to a MIL_FLOAT. (summarize) Casts the requested results to a MIL_FLOAT. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_FLOAT \| array of type MIL_FLOAT [optionally, in C++: a reference to a std::vector<MIL_FLOAT> ] MORE Data type: address of a MIL_FLOAT Note: When a single result. Data type: array of type MIL_FLOAT [optionally, in C++: a reference to a std::vector<MIL_FLOAT> ] Required array size:(defined elsewhere) Note: When multiple results. Data type info: Data type: address of a MIL_FLOAT \| array of type MIL_FLOAT [optionally, in C++: a reference to a std::vector<MIL_FLOAT> ] MORE Data type: address of a MIL_FLOAT Note: When a single result. Data type: array of type MIL_FLOAT [optionally, in C++: a reference to a std::vector<MIL_FLOAT> ] Required array size:(defined elsewhere) Note: When multiple results.
M_TYPE_MIL_ID		Casts the requested results to a MIL_ID. (summarize) Casts the requested results to a MIL_ID. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_ID \| array of type MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID> ] MORE Data type: address of a MIL_ID Note: When a single result. Data type: array of type MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID> ] Required array size:(defined elsewhere) Note: When multiple results. Data type info: Data type: address of a MIL_ID \| array of type MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID> ] MORE Data type: address of a MIL_ID Note: When a single result. Data type: array of type MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID> ] Required array size:(defined elsewhere) Note: When multiple results.
M_TYPE_MIL_INT		Casts the requested results to a MIL_INT. (summarize) Casts the requested results to a MIL_INT. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_INT \| array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] MORE Data type: address of a MIL_INT Note: When a single result. Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] Required array size:(defined elsewhere) Note: When multiple results. Data type info: Data type: address of a MIL_INT \| array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] MORE Data type: address of a MIL_INT Note: When a single result. Data type: array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] Required array size:(defined elsewhere) Note: When multiple results.
M_TYPE_MIL_INT16		Casts the requested results to a MIL_INT16. (summarize) Casts the requested results to a MIL_INT16. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_INT16 \| array of type MIL_INT16 [optionally, in C++: a reference to a std::vector<MIL_INT16> ] MORE Data type: address of a MIL_INT16 Note: When a single result. Data type: array of type MIL_INT16 [optionally, in C++: a reference to a std::vector<MIL_INT16> ] Required array size:(defined elsewhere) Note: When multiple results. Data type info: Data type: address of a MIL_INT16 \| array of type MIL_INT16 [optionally, in C++: a reference to a std::vector<MIL_INT16> ] MORE Data type: address of a MIL_INT16 Note: When a single result. Data type: array of type MIL_INT16 [optionally, in C++: a reference to a std::vector<MIL_INT16> ] Required array size:(defined elsewhere) Note: When multiple results.
M_TYPE_MIL_INT32		Casts the requested results to a MIL_INT32. (summarize) Casts the requested results to a MIL_INT32. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_INT32 \| array of type MIL_INT32 [optionally, in C++: a reference to a std::vector<MIL_INT32> ] MORE Data type: address of a MIL_INT32 Note: When a single result. Data type: array of type MIL_INT32 [optionally, in C++: a reference to a std::vector<MIL_INT32> ] Required array size:(defined elsewhere) Note: When multiple results. Data type info: Data type: address of a MIL_INT32 \| array of type MIL_INT32 [optionally, in C++: a reference to a std::vector<MIL_INT32> ] MORE Data type: address of a MIL_INT32 Note: When a single result. Data type: array of type MIL_INT32 [optionally, in C++: a reference to a std::vector<MIL_INT32> ] Required array size:(defined elsewhere) Note: When multiple results.
M_TYPE_MIL_INT64		Casts the requested results to a MIL_INT64. (summarize) Casts the requested results to a MIL_INT64. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_INT64 \| array of type MIL_INT64 [optionally, in C++: a reference to a std::vector<MIL_INT64> ] MORE Data type: address of a MIL_INT64 Note: When a single result. Data type: array of type MIL_INT64 [optionally, in C++: a reference to a std::vector<MIL_INT64> ] Required array size:(defined elsewhere) Note: When multiple results. Data type info: Data type: address of a MIL_INT64 \| array of type MIL_INT64 [optionally, in C++: a reference to a std::vector<MIL_INT64> ] MORE Data type: address of a MIL_INT64 Note: When a single result. Data type: array of type MIL_INT64 [optionally, in C++: a reference to a std::vector<MIL_INT64> ] Required array size:(defined elsewhere) Note: When multiple results.
M_TYPE_TEXT_CHAR		Casts the requested results to a MIL_TEXT_CHAR. (summarize) Casts the requested results to a MIL_TEXT_CHAR. (more details...)
	ResultArrayPtr extra info	Data type info: Data type: address of a MIL_TEXT_CHAR \| array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE Data type: address of a MIL_TEXT_CHAR Note: When a single result. Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] Required array size:(defined elsewhere) Note: When multiple results. Note: When using C++, you can pass a reference to a MIL_STRING instead. In this case, the function will automatically determine the correct string size. Data type info: Data type: address of a MIL_TEXT_CHAR \| array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE Data type: address of a MIL_TEXT_CHAR Note: When a single result. Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] Required array size:(defined elsewhere) Note: When multiple results. Note: When using C++, you can pass a reference to a MIL_STRING instead. In this case, the function will automatically determine the correct string size.

Compilation information

Header	Include mil.h.
Library	Use mil.lib; milstr.lib.
DLL	Requires mil.dll; milstr.dll.