RECOGCHARS
typedef struct _tagRecogChars
{
L_UINT uStructSize;
RECT rcArea;
L_INT nYOffset;
L_INT nSpace;
L_INT nSpaceErr;
L_WCHAR wGuessCode;
L_WCHAR wGuessCode2;
L_WCHAR wGuessCode3;
L_INT nZoneIndex;
L_INT nCellIndex;
L_INT nConfidence;
L_UINT uFont;
L_INT nFontSize;
L_INT nCharFormat;
LANGIDS Lang;
LANGIDS Lang2;
} RECOGCHARS, * pRECOGCHARS;
The RECOGCHARS structure contains information about the recognized characters.
Member |
Description | |
uStructSize |
Specifies the structure size. It should be equal to sizeof(RECOGCHARS). | |
rcArea |
RECT structure that contains the area for the recognized character. | |
nYOffset |
Y coordinate of the baseline measured from the top edge of the rectangle exactly containing the character. | |
nSpace |
Value that represents the number of spaces in front of the recognized code character. | |
nSpaceErr |
Confidence number expressing the certainty of the space parameter. | |
wGuessCode |
Character code in UNICODE. This is either the first guess of the recognition or zero (0) signaling that the engine could not recognize the character (rejected character). | |
wGuessCode2 |
Second guess of the recognition, if any. | |
wGuessCode3 |
Third guess of the recognition, if any. | |
nZoneIndex |
Index of the zone in the zone list which contains the character. | |
nCellIndex |
Index of the cell in the cell list which contains the character (applicable only for ZONE_TABLE zones). The cell list is not accessible for the application. | |
nConfidence |
Confidence number expressing both the certainty of the recognition of the first guess (code member) and also the certainty of the word. | |
uFont |
Font information about the recognized character. Possible values are given below. These values can be combined using OR (|) | |
|
Value |
Meaning |
|
FONT_ITALIC |
[0x001] The character is italic. |
|
FONT_BOLD |
[0x002] The character is bold. |
|
FONT_UNDERLINE |
[0x004] The character is underlined. |
|
FONT_SUBSCRIPT |
[0x008] The character is subscript. |
|
FONT_SUPERSCRIPT |
[0x010] The character is superscript. |
|
FONT_SANSSERIF |
[0x020] The character is Sans Serif. |
|
FONT_SERIF |
[0x040] The character is Serif. |
|
FONT_PROPORTIONAL |
[0x080] The character is proportional. |
nFontSize |
Font size in points. | |
nCharFormat |
Formatting attributes of the character. Possible values are given below. These values can be combined using OR (|) | |
|
Value |
Meaning |
|
CHAR_ENDOFLINE |
[0x001] This is the last character in a line. |
|
CHAR_ENDOFPARA |
[0x002] This is the last character in a paragraph. |
|
CHAR_ENDOFWORD |
[0x004] This is the last character of a word. |
|
CHAR_ENDOFZONE |
[0x008] This is the last character in a zone. |
|
CHAR_ENDOFPAGE |
[0x010] This is the last character on a page. |
|
CHAR_ENDOFCELL |
[0x020] This is the last character in a cell. |
|
|
(applicable only for ZONE_TABLE type zones). |
Lang |
Value that represents the first language in which the recognized word is found. For a list of possible values, refer to LANGIDS. | |
Lang2 |
Value that represents the second language in which the recognized word is found. |
Comments
The application should evaluate the nConfidence member, when confidence information on the recognition is also required. Its most significant bit is used to express the certainty/uncertainty of the word (word is uncertain, if this bit set to one (1). The remaining bits represent the certainty of the character recognition, which ranges between 0 and 100. The smaller this value is, the higher is the confidence of the recognition. For more details, see the Confidence reporting topic.
pRECOGCHARS is a pointer to a RECOGCHARS structure. Where the function parameter type is pRECOGCHARS, declare a RECOGCHARS variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pRECOGCHARS variable is necessary only if the program requires a pointer.
If the recognition process cannot associate the current recognized word with any language, then Lang is updated with LANG_ID_NO.
If the recognized word can be found in more than one language, then Lang will be updated with the ID of the first language in which the recognized word was found and Lang2 will be updated with the second language in which the word was found.
This structure is used with the following functions: