نظرة عامة على الميزات

نظرة عامة على الميزات

تقدم هذه الصفحة تعريفًا بـ 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