Огляд функцій

Огляд функцій

Ця сторінка представляє API розпізнавання бібліотеки та можливості, які докладно розглянуті в інших розділах цього посібника. AsposeOcr є точкою входу для всієї бібліотеки. Її метод Recognize() приймає OcrInput і повертає OcrOutput — список RecognitionResult, по одному на зображення або сторінку PDF.

Розпізнавання одиночних зображень та PDF

OcrInput створюється за допомогою InputType — InputType.SingleImage для растрового зображення або InputType.PDF для PDF-документа. Файли додаються у чергу за допомогою OcrInput.Add(). Звільнення OcrInput лише очищає чергу шляхів до файлів, які він містить.

using Aspose.OCR;

var api = new AsposeOcr();
using var input = new OcrInput(InputType.PDF);
input.Add("document.pdf");
OcrOutput output = api.Recognize(input);

Результати розпізнавання

Кожен RecognitionResult надає RecognitionText (повний розпізнаний текст сторінки) і RecognitionLinesResult (список RecognitionResult.LinesResult, кожен з яких має TextInLine і System.Drawing.Rectangle обмежувальну рамку у Line).

foreach (RecognitionResult page in output)
{
    Console.WriteLine(page.RecognitionText);
    foreach (RecognitionResult.LinesResult line in page.RecognitionLinesResult)
    {
        Console.WriteLine($"{line.Line}: {line.TextInLine}");
    }
}

Пакетна обробка

OcrInput приймає більше ніж один файл одного типу вводу. OcrOutput зберігає порядок, у якому файли були додані, з одним RecognitionResult на файл (або на сторінку PDF).

using var input = new OcrInput(InputType.SingleImage);
input.Add("page-1.jpg");
input.Add("page-2.png");
OcrOutput output = api.Recognize(input);

Поради та найкращі практики

• Вивільніть OcrInput (або обгорніть його у вираз using), коли розпізнавання завершиться, щоб звільнити базові ресурси.
• Підтримуються лише InputType.SingleImage і InputType.PDF — будь-який інший тип вводу викликає NotSupportedException.
• Розпізнавання підтримує лише латинську абетку; параметр вибору мови відсутній.
• Сторінки PDF відображаються внутрішньо перед розпізнаванням, тому окремий крок перетворення PDF у зображення не потрібен.

Типові проблеми

FAQ

Які мови розпізнає Aspose.OCR FOSS для .NET?

Текст латинським письмом. Вбудована модель розпізнавання не охоплює нелатинські скрипти.

Чи потрібне інтернет-з’єднання?

Ні. Усі три моделі ONNX (детекція, уточнення, розпізнавання) вбудовані в збірку та виконуються локально через Microsoft.ML.OnnxRuntime.

Чи можу я розпізнати кілька файлів в одному виклику?

Так — додайте кілька файлів до того ж OcrInput перед викликом AsposeOcr.Recognize(). Повернений OcrOutput зберігає їх порядок.

На яких платформах це працює?

Він орієнтується на .NET Standard 2.0, .NET Framework 4.8 та .NET 8.0+. Обробка зображень вимагає Windows, оскільки залежить від System.Drawing.Common.

API Reference Огляд

Дивіться також

• Aspose.OCR — Enterprise Documentation