Browse our Products

Aspose.OCR for .NET 24.4.0 - Release Notes

This article contains a summary of recent changes, enhancements and bug fixes in Aspose.OCR for .NET 24.4.0 (April 2024) release.

GPU version: 23.10.1

Deprecation warning

The release 24.3.0 updates the codes of some recognition languages to align with ISO 639-2 standard.

To make it easier to upgrade your code, we have kept all legacy values, but marked them as deprecated. All of your existing code will continue to work and you can even make minor updates to it, but be aware that all deprecated language codes are scheduled to be removed in release 25.1.0 (January 2025).

Time to deprecation: 9 months left.

What was changed

Key	Summary	Category
OCRNET‑811	Enabled recognition process cancellation.	New feature
OCRNET‑815	Added recognition of Arabic text.	New feature

Public API changes and backwards compatibility

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

Added public APIs:

No changes.

Updated public APIs:

The following public APIs have been changed in Aspose.OCR for .NET 24.4.0 release:

`Language` enumeration

Compatibility: fully backward compatible. See details below.

Aspose.OCR for .NET can now recognize Arabic texts, including texts in mixed Arabic/English:

Value	Alphabet
`Aspose.OCR.Language.Ara`	Arabic

Arabic text recognition requires aspose-ocr-arabic-v1 OCR feature to be installed.

`Recognize(OcrInput images, RecognitionSettings settings, CancellationToken cancellationToken)`

Compatibility: fully backward compatible. See details below.

An optional cancellationToken parameter was added to Recognize() method. This allows passing a cancellation token which can be used to forcibly stop the long recognition process either manually or automatically after the specified number of milliseconds.

Removed public APIs:

No changes.

Examples

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

Recognize Arabic text

// Initialize Aspose.OCR for .NET recognition API
Aspose.OCR.AsposeOcr recognitionEngine = new Aspose.OCR.AsposeOcr();
// Add image
Aspose.OCR.OcrInput input = new Aspose.OCR.OcrInput(Aspose.OCR.InputType.SingleImage);
input.Add("source.png");
// Set recognition language
Aspose.OCR.RecognitionSettings recognitionSettings = new Aspose.OCR.RecognitionSettings();
recognitionSettings.Language = Aspose.OCR.Language.Ara;
// Recognize image
List<Aspose.OCR.RecognitionResult> results = recognitionEngine.Recognize(input, recognitionSettings);
Console.WriteLine(results[0].RecognitionText);

Automatically cancel recognition after 20 seconds

// Set automatic cancellation after 20 seconds (20,000ms)
CancellationTokenSource cancellationTokenSource  = new CancellationTokenSource();
cancellationTokenSource.CancelAfter(20000);
// Initialize Aspose.OCR for .NET recognition API
Aspose.OCR.AsposeOcr recognitionEngine = new Aspose.OCR.AsposeOcr();
// Add scanned PDF to recognition batch
Aspose.OCR.OcrInput input = new Aspose.OCR.OcrInput(Aspose.OCR.InputType.PDF);
input.Add("large.pdf");
// Recognize image
List<Aspose.OCR.RecognitionResult> results = recognitionEngine.Recognize(input, null, cancellationTokenSource.Token);