Class AdvancedCharacter

Represents a single character recognized by the advanced OCR engine, including its spatial coordinates.

This class provides character-level granularity for OcrDocAdvancedResult, enabling precise positional mapping of individual characters within recognized text.

Inheritance
System.Object
AdvancedOcrElement
AdvancedCharacter
Inherited Members
Namespace: IronOcr
Assembly: IronOcr.dll
Syntax
public class AdvancedCharacter : AdvancedOcrElement

AdvancedCharacter is a single recognized character returned by the advanced OCR engine, complete with its position on the page. Each one pairs the decoded glyph with the pixel rectangle that locates it, so a project can highlight, crop, or map individual characters rather than only the run of text. It is the character-level peer of AdvancedWord, which groups the same data at word granularity.

You receive an AdvancedCharacter from the Characters array on an AdvancedOcrResultBase (the result type produced by the advanced and handwriting reads on IronTesseract). Iterate that array to walk every character the engine found across the document.

The recognized glyph is on Text, and the position comes from members inherited from AdvancedOcrElement: BoundingBox gives the pixel rectangle, X, Y, Width, and Height give the same box as separate values, and PageNumber reports the 1-based page the character sits on. RegionIndex and RegionConfidence tie the character back to its text region and that region's confidence score, useful when filtering low-confidence output before display.

foreach (AdvancedCharacter ch in result.Characters)
    Console.WriteLine($"{ch.Text} at {ch.X},{ch.Y}");

The read document advanced how-to walks through an advanced read, and the read results how-to shows how to traverse characters, words, and their coordinates.

Methods

ToString()

Returns a string representation of this character including its text and location.

Declaration
public override string ToString()
Returns
Type Description
System.String

Inherited members

Text
X
Y
Width
Height
PageNumber
BoundingBox
RegionIndex
RegionConfidence