Latest release

What was changed

Public API changes and backwards compatibility

This section lists all public API changes introduced in Aspose.OCR for .NET 25.8.0 that August affect the code of existing applications.

Added public APIs:

The following public APIs have been introduced in this release:

AI Component

⚠️ Disclaimer:
By using AI-powered features, you are solely responsible for ensuring compliance with any
applicable laws, licensing terms, third-party AI model usage policies, and data privacy regulations.
Aspose does not take responsibility for the accuracy, licensing, or reliability of external AI models.

AI Component Enhancements

The AsposeAI class now provides more flexibility in integrating AI models for spell-checking, intelligent postprocessing, and structured table extraction.

📄 TableAIProcessor — New AI Module

Implements: IOcrAIPostProcessor

Performs AI-driven table detection, extraction, and reconstruction.

AITableDetectionMode — a new enum for controlling AI-powered table detection modes:

• NONE — Does not explicitly detect tables, processes the entire image as if it were a single table.
  Returns both recognized text and detected tables but does not crop them from the image.
• AUTO — Automatically detects tables, extracts them from surrounding text,
  applies proper table layout, and returns fully structured, well-marked tables.

AIResult — a new class representing the transformed and processed result of text recognition.

🔗 API References

• TableAIProcessor
  Built-in AI postprocessor that uses a language model to fix spelling mistakes in recognized text.

Updated public APIs:

🛠 Constructors

public AsposeAI();
public AsposeAI(ILogger customLogger);

You can also pass optional logging and customization callbacks.

Configuration

⚙️ AsposeAIModelConfig

🧠 AsposeAI Class – Core Methods

🔤 SpellCheckAIProcessor Class – Postprocessor Module

New Methods

Deprecated APIs

The following public APIs have been marked as deprecated and will be removed in 25.11.0 (October 2025) release:

RectangleOutput class

AsposeOcr.DetectRectangles method

RecognitionResult.RecognitionAreasText

RecognitionResult.RecognitionAreasRectangles

RecognitionResult.Skew

CharacterRecognitionResult.ImageIndex

SkewOutput.ImageIndex

OcrPageRecognizeEventsArgs.CurrentImage

Removed public APIs:

No changes.

Examples

The code samples below illustrate the changes introduced in this release:

Enable Debug Mode for Logging

ILogger logger = new ConsoleLogger();
AsposeAIModelConfig modelConfig = new AsposeAIModelConfig
{
    // FileModelPath = @"C:\Models\Qwen2-7B-Instruct",
    // ContextSize = 5000,
    // GpuLayers = 40,
    // HuggingFaceRepoId = "lmstudio-community/Qwen3-14B-GGUF"
};

AsposeOcr api = new AsposeOcr();
AsposeAI ai = new AsposeAI(logger);

var procSpell = new SpellCheckAIProcessor();
var procTable = new TableAIProcessor();

// Register table processor
ai.AddPostProcessor(procTable);

// OCR input and recognition
input.Add(fileName, 0, 1);
OcrOutput res = api.Recognize(input, new RecognitionSettings
{
    DetectAreasMode = DetectAreasMode.TABLE
});

// Process tables
ai.RunPostprocessor(res);
Console.WriteLine("TABLE RESULT:");
Console.WriteLine(procTable.GetResult()[0].RecognitionText);
procTable.SaveXlsx(outputFile);

// Process spell-check
ai.AddPostProcessor(procSpell);
ai.RunPostprocessor(res);
Console.WriteLine("SPELLCHECK RESULT:");
Console.WriteLine(procSpell.GetResult()[0].RecognitionText);

ai.Dispose();