# AdaptiveOcrEngine

Opt-in, bounded retries of weak OCR evidence using caller-configured recognition variants.

Class 

`OfficeIMO.Ocr`

**Namespace**

`OfficeIMO.Ocr`

**Assembly**

`OfficeIMO.Ocr`

**Source revision**

`ba882f6b0d07` with working tree changes

**Source**

[AdaptiveOcrEngine.cs:28](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Ocr/AdaptiveOcrEngine.cs#L28)

**Implements**

`IOcrEngine`

**Modifiers**

sealed

Opt-in, bounded retries of weak OCR evidence using caller-configured recognition variants.

## Inheritance

- object
- AdaptiveOcrEngine

## Remarks

Variants receive identical raster bytes, metadata, and coordinate frames. Configure segmentation or language in each provider; raster preparation remains in the format/scanning owner. Retries cannot silently approve text.

## Guides & Samples

Authored walkthroughs and practical samples linked to this API.

- [Charts, Barcodes, OCR and Provenance](/docs/foundations/) Guide
  
  Add ChartForgeX charts, Mermaid diagrams and CodeGlyphX barcodes to documents, recognize text with OCR engines, and verify C2PA Content Credentials.

Filter members 

Show inherited

## Constructors

`public AdaptiveOcrEngine(string id, IReadOnlyList<OcrRecognitionAttempt> attempts, OcrReviewPolicy? reviewPolicy = null, TimeSpan? timeout = null, int maximumSpans = 100000, int maximumTextCharacters = 1000000, long maximumInputBytes = 26214400)` [#](#constructor-ctor-string-collections-generic-ireadonlylist-officeimo-ocr-ocrrecognitionattempt-officeimo-ocr-ocrreviewpolicy-nullable-system-timespan-int32-int32-int64)

[AdaptiveOcrEngine.cs:28](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Ocr/AdaptiveOcrEngine.cs#L28)

Creates up to four ordered variants with a single total execution budget.

Parameters

**id string required**

Stable identifier for this configured policy.

**attempts System.Collections.Generic.IReadOnlyList<OfficeIMO.Ocr.OcrRecognitionAttempt> required**

First attempt is the baseline. The review policy controls whether later variants always run or run only after failed checks.

**reviewPolicy OfficeIMO.Ocr.OcrReviewPolicy? = null optional**

Measurable checks; defaults are starting settings, not calibrated accuracy claims.

**timeout System.TimeSpan? = null optional**

Total budget including every gate wait, result capture, and retry. Defaults to one minute.

**maximumSpans int = 100000 optional**

Maximum retained spans per attempt.

**maximumTextCharacters int = 1000000 optional**

Maximum text characters per attempt, including span text.

**maximumInputBytes long = 26214400 optional**

Maximum encoded raster bytes; each attempt receives an isolated copy.

## Methods

`public async Task<OcrResult> RecognizeAsync(OcrRequest request, CancellationToken cancellationToken = default)` [#](#method-recognizeasync-officeimo-ocr-ocrrequest-threading-cancellationtoken)

Recognizes text and optional detailed spans from one raster payload.

Parameters

**request OfficeIMO.Ocr.OcrRequest required**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`Task<OcrResult>`

`public async Task<AdaptiveOcrResult> RecognizeWithReviewAsync(OcrRequest request, CancellationToken cancellationToken = default)` [#](#method-recognizewithreviewasync-officeimo-ocr-ocrrequest-threading-cancellationtoken)

Recognizes text and returns content-free attempt, uncertainty, disagreement, and selection evidence.

Parameters

**request OfficeIMO.Ocr.OcrRequest required**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`Task<AdaptiveOcrResult>`

## Inherited Methods

`public virtual bool Equals(object? obj)` [#](#method-equals-object)

Inherited from object

Parameters

**obj object? required**

Returns

`bool`

`public virtual int GetHashCode()` [#](#method-gethashcode)

Inherited from object

Returns

`int`

`public Type GetType()` [#](#method-gettype)

Inherited from object

Returns

`Type`

`public virtual string? ToString()` [#](#method-tostring)

Inherited from object

Returns

`string?`

## Properties

`public string Id { get; }` [#](#property-id)

[AdaptiveOcrEngine.cs:51](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Ocr/AdaptiveOcrEngine.cs#L51)

Stable provider identifier used in diagnostics and provenance. The value must remain unchanged for the lifetime of this configured engine instance, and the untrimmed value must not exceed [OcrEngineRunner.MaximumEngineIdCharacters](/api/ocr/officeimo-ocr-ocrenginerunner/) characters.

`public OcrEngineCapabilities Capabilities { get; }` [#](#property-capabilities)

[AdaptiveOcrEngine.cs:56](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Ocr/AdaptiveOcrEngine.cs#L56)

Stable capabilities exposed by this configured engine instance.

<!-- PowerForge markdown artifact sha256:C74EBF57B1FA91ACB1546F92295D31E6FDF05A7B596597AC6EFAF35D8F14AF3C -->
