כיצד לעבוד עם Aspose.OCR FOSS Core API ב.NET

כיצד לעבוד עם Aspose.OCR FOSS Core API ב.NET

Aspose.OCR קוד פתוח עבור .NET מזהה טקסט בתמונות רסטר ובמסמכי PDF דרך ליבה קטנה של API: AsposeOcr, OcrInput, OcrOutput ו-RecognitionResult. מדריך זה מסביר כיצד להתקין את החבילה ולשימוש בליבה API מקצה לקצה.

מדריך שלב-בשלב

שלב 1: התקנת החבילה

dotnet add package Aspose.OCR.FOSS

שלב 2: ייבוא מרחב השמות

הוסף את מרחב השמות Aspose.OCR לכל קובץ מקור שמקרא ל-AsposeOcr, OcrInput או RecognitionResult:

using Aspose.OCR;

מרחב שם יחיד זה חושף את AsposeOcr, OcrInput, OcrOutput, InputType ו-RecognitionResult.


שלב 3: בנה OcrInput והזהה תמונה

בנה AsposeOcr, בנה OcrInput עם InputType.SingleImage, הוסף קובץ לתור עם OcrInput.Add(), וקרא ל-AsposeOcr.Recognize().

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);

שלב 4: קרא שורות בודדות ותיבות גבול

כל רשומת RecognitionResult.LinesResult ב-RecognitionLinesResult מכילה את הטקסט של שורה אחת (TextInLine) ואת תיבת הגבול בתיאום פיקסלים שלה (Line).

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

שלב 5: זהה PDF מרובה עמודים

עבור InputType.PDF, AsposeOcr.Recognize() מחזירה RecognitionResult אחד לכל עמוד, לפי סדר המקור.

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) ומקבל רק קבצים מהסוג הזה.

ראה גם

 עברית