Aspose.OCR FOSS for .NET — פתרון בעיות

דף זה מציג את השגיאות והמגבלות הסבירות ביותר שיופיעו בעת אינטגרציה של Aspose.OCR FOSS עבור .NET, עם הסיבה האמיתית מאחורי כל אחת מהן.

חריגות שנזרקות על ידי Recognize()

AsposeOcr.Recognize() מאמת את הקלט שלו לפני שהמודל רץ. כל בדיקה למטה נכשלת בסדר הבא:

Exception	סיבה	תיקון
`ArgumentNullException`	ה`OcrInput` שהועבר ל`Recognize()` הוא `null`	תמיד צור `OcrInput` לפני קריאה ל`Recognize()`
`NotSupportedException`	ה`OcrInput` נבנה עם `InputType` שאינו `SingleImage` או `PDF`	רק `InputType.SingleImage` ו`InputType.PDF` הם תקפים
`FileNotFoundException`	נתיב שנוסף דרך `OcrInput.Add()` אינו קיים בדיסק	אמת כל נתיב לפני קריאה ל-`Add()` — קובץ חסר גורם לכשל של כל הקריאה, לא רק של קובץ זה

הזיהוי מחזיר ללא טקסט

אם RecognitionResult.RecognitionText ריק ו-RecognitionLinesResult אין בו רשומות, הגלאי לא מצא אזור של שורת טקסט בתמונה. זה צפוי — לא באג — עבור:

תמונות ללא טקסט קריא, או טקסט שהוא קטן מדיי, מסובב, או בעל ניגודיות נמוכה מכדי שהגלאי יזהה אותו כאזור
כתבים לא-לטיניים: מודל הזיהוי המוטמע תומך רק בטקסט בכתב לטיני ובתווים המבטאים שלו
תמונות שבהן האזורים שזוהו סוננו החוצה במהלך עיבוד לאחרי (ציון סבירות טקסט נמוכה מאוד)

אין מדד ביטחון חשוף להבחין בין “nothing detected” ל-“detected but uncertain” — ראה היקף ומגבלות.

טקסט מסובב או משופע. אין תיקון הטייה או סיבוב אוטומטי. יש לסובב מראש את תמונת המקור לפני הקריאה Recognize().
פריסות טבלאות או טפסים נראות מבולבלות. הגלאי מחזיר רק מלבני קו מיושרים לציר — הוא אינו מכיר מושגים של עמודות, טבלאות, או סדר קריאה מעבר למיקום הקו. שחזור הפריסה הוא באחריות המתקשר.
מיקום הטקסט ב-PDF נראה מוזז. דפי PDF תמיד מוצגים בפנים ברזולוציית 150 DPI; קואורדינטות המלבן ב- RecognitionResult.LinesResult.Line הן במרחב הפיקסלים של התמונה המוצגת, ולא במרחב הנקודות של ה-PDF.

PlatformNotSupportedException או דומה בזמן ריצה ב-Linux/macOS. עיבוד תמונה תלוי ב- System.Drawing.Common, שהיא זמינה רק ב-Windows על .NET 6 ומעלה. נתיב עיבוד התמונות של ספרייה זו פועל רק ב-Windows.
הבנייה נכשלת במטרה net9.0/net10.0. בניית היעדים האלה דורשת את .NET 10 SDK — ראה כיצד לבנות ממקור.
Mixing InputType.SingleImage and InputType.PDF ביחיד OcrInput. לא נתמך — ראה כיצד לעבד במצב אצווה מספר תמונות.