نحوه کار با Aspose.OCR FOSS Core API در .NET

Aspose.OCR FOSS برای .NET متن را در تصاویر رستری و اسناد PDF از طریق یک هسته کوچک API: AsposeOcr، OcrInput، OcrOutput و RecognitionResult شناسایی می‌کند. این راهنما نصب بسته و استفاده از آن API هسته‌ای را از ابتدا تا انتها راهنمایی می‌کند.

راهنمای گام‌به‌گام

dotnet add package Aspose.OCR.FOSS

using Aspose.OCR;

var api = new AsposeOcr();
using var input = new OcrInput(InputType.SingleImage);
input.Add("scan.png");
RecognitionResult result = api.Recognize(input)[0];
Console.WriteLine(result.RecognitionText);

foreach (RecognitionResult.LinesResult line in result.RecognitionLinesResult)
{
    System.Drawing.Rectangle bounds = line.Line;
    Console.WriteLine($"x={bounds.X}, y={bounds.Y}: {line.TextInLine}");
}

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

foreach (RecognitionResult page in output)
{
    Console.WriteLine(page.RecognitionText);
}

مشکلات رایج و راه‌حل‌ها

NotSupportedException هنگام فراخوانی Recognize(). این OcrInput با نوع ورودی‌ای غیر از InputType.SingleImage or InputType.PDF. فقط آن دو نوع ورودی پشتیبانی می‌شوند.

FileNotFoundException هنگام فراخوانی Recognize(). مسیر اضافه‌شده از طریق OcrInput.Add() وجود ندارد بر روی دیسک. مسیر را قبل از فراخوانی اعتبارسنجی کنید Add().

ArgumentNullException هنگام فراخوانی Recognize(). null به‌جای یک … ارسال شد OcrInput همیشه یک … بسازید OcrInput ابتدا.

Empty RecognitionLinesResult. هیچ خط متنی تشخیص داده نشد — تأیید کنید که تصویر منبع شامل متن قابل خواندن، بدون چرخش و با اسکریپت لاتین باشد.

سوالات متداول

آیا OcrOutput ترتیب فایل‌ها را حفظ می‌کند؟

بله. OcrOutput یک فهرست از RecognitionResult است، یک مورد برای هر تصویر (یا هر صفحهٔ PDF)، به ترتیب افزودن فایل‌ها از طریق OcrInput.Add().

آیا نیاز به از بین بردن OcrInput دارم؟

بله — OcrInput IDisposable را پیاده‌سازی می‌کند. پس از تکمیل شناسایی، از یک عبارت using استفاده کنید یا به‌صورت صریح Dispose() را فراخوانی کنید.

آیا می‌توانم هم تصاویر و هم PDFها را در همان OcrInput پردازش کنم؟

نه — هر OcrInput با یک InputType واحد (SingleImage یا PDF) ساخته می‌شود و فقط فایل‌های آن نوع را می‌پذیرد.

همچنین ببینید:

• Installation
• راهنمای توسعه‌دهنده Core API
• FAQ
• Aspose.OCR for .NET — Enterprise Knowledge Base