MocrGetResult

Retrieves the entire text. This includes all available strings, their separators, and the terminating character. Note that the string separator can be controlled using MocrControl() with M_TEXT_STRING_SEPARATOR.

Retrieves the total number of characters in the entire text. This includes all available strings, their separators, and the terminating character. Note that the string separator can be controlled using MocrControl() with M_TEXT_STRING_SEPARATOR.

Retrieves the match score for the entire text as determined during the read/verify operation.

Retrieves the value used to binarize the target image. Note that this is available only when using an M_GENERAL OCR font context, or when using an M_CONSTRAINED OCR font context if your target image has multiple lines, or its string angle is not 0.0°.

Retrieves the number of strings read by MocrReadString().

If no strings are found, 0 is returned.

Retrieves the null-terminated string found during the read/verify operation. By default, any unrecognized character in the string will be replaced by the most-likely character, even if the match score for that character is lower than the specified character acceptance level (MocrControl() with M_CHAR_ACCEPTANCE). You can replace all unrecognized characters in the string with an invalid character symbol by calling MocrControl() with M_CHAR_INVALID.

Note that no string separator is inserted between the different strings when getting all strings simultaneously. Refer to M_TEXT to retrieve the strings with separators.

Retrieves the total size of the string, including the terminating null character ("\0"). For multiple strings, the total size of each string, including its terminating null character ("\0"), is returned.

Retrieves the search angle of the string, in degrees, relative to the output coordinate system specified using MocrControl() with M_RESULT_OUTPUT_UNITS. For multiple strings, the search angle of each string is returned. Note that all strings are searched for at the same angle, so all returned values will be equivalent.

An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. 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 25: Calibrating your camera setup.

Retrieves the score calculated during the read/verify operation for the entire string. For multiple strings, the calculated score for each string is returned.

Retrieves the length of the null-terminated string found during the read/verify operation, not including the terminating null character ("\0") itself. For multiple strings, the length of each null-terminated string, not including the terminating null character ("\0") itself, is returned.

Retrieves the result of the read/verify operation as a flag that denotes the validity of the string. The flag's validity status is determined by comparing the string's read score with the string's acceptance level (MocrControl() with M_STRING_ACCEPTANCE). For multiple strings, a validity flag for each string is returned.

Retrieves the X-position of each individual character in the string, or strings.

Retrieves the Y-position of each individual character in the string, or strings.

Retrieves the match score of each individual character within the string, or strings.

Retrieves the cell width of each character within the string, or strings.

Retrieves the cell height of each character within the string, or strings.

Retrieves the spacing between each pair of characters in the selected string, or strings. Note that the spacing of the last character in each string is M_NULL.

Retrieves the result of the read/verify operation as flags that denote the validity of each character within the string, or strings. Each flag's validity status is determined by comparing the character's read score with the character's acceptance level (MocrControl() with M_CHAR_ACCEPTANCE).