Aspose.OCR FOSS for .NET — Depanare
Această pagină enumeră erorile și limitările care sunt cel mai probabil să apară în timpul integrării Aspose.OCR FOSS pentru .NET, cu cauza reală din spatele fiecăreia.
Excepții aruncate de Recognize()
AsposeOcr.Recognize() își validează intrarea înainte de a rula orice model. Fiecare verificare de mai jos eșuează în această ordine:
| Exception | Cauză | Remediere |
|---|---|---|
ArgumentNullException | Obiectul OcrInput transmis către Recognize() este null | Construiește întotdeauna un OcrInput înainte de a apela Recognize() |
NotSupportedException | OcrInput a fost construit cu un InputType diferit de SingleImage sau PDF | Doar InputType.SingleImage și InputType.PDF sunt valide |
FileNotFoundException | Un traseu adăugat prin OcrInput.Add() nu există pe disc | Validați fiecare traseu înainte de a apela Add() — un fișier lipsă eșuează întreaga apelare, nu doar acel fișier |
Recunoașterea nu returnează text
Dacă RecognitionResult.RecognitionText este gol și RecognitionLinesResult nu are intrări, detectorul nu a găsit nicio regiune de linie de text în imagine. Acest lucru este așteptat — nu este o eroare — pentru:
- Imagini fără text lizibil sau text care este prea mic, rotit sau cu contrast scăzut pentru ca detectorul să îl înregistreze ca regiune
- Scripturi non-latine: modelul de recunoaștere încorporat acoperă doar text în script latin și caracterele sale diacritice
- Imagini în care regiunile detectate au fost filtrate în timpul post-procesării (scoruri foarte mici de probabilitate a textului)
Nu există un scor de încredere expus pentru a distinge “nimic detectat” de “detectat, dar incert” — vezi Domeniu de aplicare și limitări.
Recunoașterea rulează, dar rezultatele par greșite
- Text rotit sau înclinat. Nu există corecție automată de înclinare sau rotire. Pre-rotați imaginea sursă înainte de a apela
Recognize(). - Aspectele de tabel sau formular par dezordonate. Detectorul returnează doar dreptunghiuri aliniate pe axe — nu are niciun concept de coloane, tabele sau ordine de citire în afara poziției liniei. Reconstruirea aspectului este responsabilitatea apelantului.
- Poziția textului în PDF pare decalată. Paginile PDF sunt întotdeauna redate la 150 DPI intern; coordonatele dreptunghiului în
RecognitionResult.LinesResult.Linesunt în spațiul de pixeli al imaginii redate, nu în spațiul de puncte al PDF-ului.
Probleme de platformă și de compilare
PlatformNotSupportedExceptionsau similar la rulare pe Linux/macOS. Procesarea imaginilor depinde deSystem.Drawing.Common, care este disponibil doar pe Windows în .NET 6 și ulterior. Calea de procesare a imaginilor a acestei biblioteci rulează numai pe Windows.- Construirea eșuează la țintirea
net9.0/net10.0. Construirea acelor ținte necesită SDK-ul .NET 10 — vezi Cum să construiești din sursă. - Mixing
InputType.SingleImageandInputType.PDFîntr-unOcrInput. Nu este acceptat — vezi Cum să procesezi în lot mai multe imagini.
