struct L_OcrCharacter{L_UINT StructSize;L_WCHAR Code;L_WCHAR GuessCode1;L_WCHAR GuessCode2;L_WCHAR Reserved2;L_UINT Confidence;L_BOOL WordIsCertain;L_RECT Bounds;L_OcrCharacterPositions Positions;L_INT Base;L_UINT CellIndex;L_UINT LeadingSpaces;L_UINT LeadingSpacesConfidence;L_FLOAT FontSize;L_OcrCharacterFontStyles FontStyles;L_COLORREF Color;L_OcrLanguage Language;L_UINT16 RotationAngle;L_UINT16 Reserved;L_UCHAR EngineData[16];};typedef struct L_OcrCharacter L_OcrCharacter;
Represents recognized character data.
| Member | Description |
|---|---|
| StructSize | Structure size. It should be equal to sizeof(L_OcrCharacter). |
| Code | Gets or sets the code (value) of the character. |
| GuessCode1 | Gets or sets the first guess of the recognition, if any. |
| GuessCode2 | Gets or sets the second guess of the recognition, if any. |
| Reserved2 | Reserved for future use. |
| Confidence | Gets or sets the confidence number expressing the recognition certainty for the first guess. |
| WordIsCertain | Gets or sets a value indicating whether the word this character is part of has passed spell checking. |
| Bounds | Gets or sets the coordinates of the rectangle exactly containing the character. |
| Positions | Gets or sets the character's position information. For a list of possible values, refer to L_OcrCharacterPositions. |
| Base | Gets or sets the length of the Y coordinate of the baseline measured from the top edge of the rectangle exactly containing the character. |
| CellIndex | Gets or sets the index of the cell in the table that contains this character. |
| LeadingSpaces | Gets or sets the estimated number of leading spaces in front of the character. |
| LeadingSpacesConfidence | Gets or sets the confidence number expressing the certainty of the number of leading spaces in front of this character. |
| FontSize | Gets or sets the font size of the character in points. |
| FontStyles | Gets or sets the character's font attributes. |
| Color | Gets or sets the character's color. |
| Language | Gets or sets the language which the character belongs to. For a list of possible values, refer to L_OcrLanguage. |
| RotationAngle | Gets or sets the character's rotation angle. A positive value indicates a counter-clockwise rotation. |
| Reserved | Reserved, For internal use. |
| EngineData | For internal use. |
To get the recognized characters of a page, call L_OcrPage_GetRecognizedCharacters after L_OcrPage_Recognize.
To update the recognized characters of a page, call L_OcrPage_SetRecognizedCharacters before calling L_OcrDocument_Save or L_OcrDocument_SaveXml.
L_OcrPageCharacters contains a list of the characters of the zones.
L_OcrZoneCharacters contains a list of the characters for a particular zone.
L_OcrCharacter is the most detailed information available about the recognized characters.
Touching characters, those whose shapes are physically joined in the page passed to the OCR engine, will result in a separate L_OcrCharacter structure for each recognized character within the block. However, the coordinate property of these characters (Bounds) will have identical coordinates defining a rectangle boundary for the character block. The order of the L_OcrCharacter structures representing a character block gives the order of the touching characters on the original document. This means the coordinates do not give information on the order of characters inside a boundary block.
This structure is used inside L_OcrZoneCharacters structure which in turn is used inside the L_OcrPageCharacters which in turn is used by the following functions:
L_OcrPage_GetRecognizedCharacters