סקירת תכונות
סקירת תכונות
דף זה מציג את 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) | מכניס נתיב קובץ לתור לזיהוי |
InputType | Enum: SingleImage או PDF |
RecognitionResult.RecognitionText | טקסט מלא של דף מזוהה |
RecognitionResult.RecognitionLinesResult | רשימת שורות מזוהות עם תיבות גבול |
RecognitionResult.LinesResult.TextInLine | טקסט מזוהה לשורה אחת |
RecognitionResult.LinesResult.Line | תיבת גבול בתיאומי פיקסלים לשורה אחת |