PlainText Object (IPlainText Interface)
This object represents recognized text in a special "plain text" format. It provides information only about the recognized text symbols, their recognition confidence and positions as relative to the source image. You can receive this information either for a single character or for all the characters in the text.
Note: In case of barcode recognition, the Text property of the PlainText object is empty. If you need to obtain the recognized text for a one-page document containing a single barcode, use the Text property of the first block in the layout:
document.Pages[0].Layout.Blocks[0].GetAsBarcodeBlock().Text
Properties
| Name | Type | Description |
|---|---|---|
| Application | Engine, read-only | Returns the Engine object. |
| Main attributes | ||
| Text | BSTR, read-only |
Provides access to the whole recognized text in a form of Unicode string. This string may contain the following special characters:
|
| SymbolsCount | int, read-only | Returns the number of symbols in the text, including the special characters. |
| PageNumber | int, read-only | This property takes as the input parameter the index of a symbol in the recognized text. It returns the number of the page on which the specified symbol is located. |
| Voting API | ||
| CharConfidence | int, read-only |
Returns the value of recognition confidence of the character. This is the confidence of the main (selected) recognition variant.
Confidence estimates the accuracy of a recognition variant. It should not be understood as a general recognition quality measure: the only safe use of confidence is for comparing recognition variants of the same character. The characters extracted from the source PDF file without recognition have confidence set to 55. |
| ErrorProbability | int, read-only | Returns the estimated probability (in range from 0 to 100) that the specified character was recognized incorrectly. |
| IsSuspicious | VARIANT_BOOL, read-only |
Returns TRUE if the specified character was recognized unreliably. Use this property to determine whether verification is needed. This property is calculated based on the ErrorProbability value and recognition settings. If you need to implement more fine-grained distinctions for verification, use ErrorProbability instead. |
| Character coordinates | ||
| Bottom | int, read-only | This property takes as the input parameter the index of a symbol in the recognized text. It returns the coordinate of the bottom border of the symbol's rectangle as relative to the deskewed black-and-white plane of the source image. |
| Left | int, read-only | This property takes as the input parameter the index of a symbol in the recognized text. It returns the coordinate of the left border of the character's rectangle as relative to the deskewed black-and-white plane of the source image. |
| Right | int, read-only | This property takes as the input parameter the index of a symbol in the recognized text. It returns the coordinate of the right border of the symbol's rectangle as relative to the deskewed black-and-white plane of the source image. |
| Top | int, read-only | This property takes as the input parameter the index of a symbol in the recognized text. It returns the coordinate of the top border of the symbol's rectangle as relative to the deskewed black-and-white plane of the source image. |
Methods
| Name | Description |
|---|---|
| GetCharacterData | Returns the information about all characters in the text as a set of arrays: the page numbers on which the characters are located, the coordinates of characters' rectangles, and characters' confidences. |
| SaveToAsciiXMLFile | Saves the recognized text into an XML file. |
| SaveToTextFile | Saves the recognized text into a text file with the specified encoding. |
Related objects
See also
What is the difference between CharConfidence, ErrorProbability, and IsSuspicious?
07.11.2025 12:48:30