סקירת תכונות

סקירת תכונות

סקירת תכונות

דף זה מציג את 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 לתמונה.

בעיות נפוצות

בעיהסיבהתיקון
NotSupportedException על Recognize()OcrInput נבנה עם InputType לא נתמךהשתמש רק בInputType.SingleImage או בInputType.PDF
FileNotFoundException על Recognize()נתיב שנוסף דרך OcrInput.Add() אינו קייםאמת את נתיב הקובץ לפני קריאה לAdd()
ריק RecognitionLinesResultלא זוהתה שורת טקסט בתמונה או בעמוד הזהאשר שהתמונה המקורית מכילה טקסט קריא, לא מסובב, בכתב לטיני

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 סיכום

מחלקה/מתודהתיאור
AsposeOcr.Recognize(OcrInput)נקודת כניסה: מזהה טקסט ומחזיר OcrOutput
OcrInput.Add(string)מכניס נתיב קובץ לתור לזיהוי
InputTypeEnum: SingleImage או PDF
RecognitionResult.RecognitionTextטקסט מלא של דף מזוהה
RecognitionResult.RecognitionLinesResultרשימת שורות מזוהות עם תיבות גבול
RecognitionResult.LinesResult.TextInLineטקסט מזוהה לשורה אחת
RecognitionResult.LinesResult.Lineתיבת גבול בתיאומי פיקסלים לשורה אחת

ראה גם

 עברית