Aspose.OCR FOSS for .NET — Risoluzione dei problemi
Questa pagina elenca gli errori e le limitazioni più probabili che si presenteranno durante l’integrazione di Aspose.OCR FOSS per .NET, con la causa reale dietro ciascuno.
Eccezioni generate da Recognize()
AsposeOcr.Recognize() convalida il suo input prima che venga eseguito qualsiasi modello. Ogni controllo qui sotto fallisce in questo ordine:
| Exception | Causa | Correzione |
|---|---|---|
ArgumentNullException | Il OcrInput passato a Recognize() è null | Costruisci sempre un OcrInput prima di chiamare Recognize() |
NotSupportedException | OcrInput è stato costruito con un InputType diverso da SingleImage o PDF | Solo InputType.SingleImage e InputType.PDF sono validi |
FileNotFoundException | Un percorso aggiunto tramite OcrInput.Add() non esiste sul disco | Convalida ogni percorso prima di chiamare Add() — un file mancante fa fallire l’intera chiamata, non solo quel file |
Il riconoscimento non restituisce testo
Se RecognitionResult.RecognitionText è vuoto e RecognitionLinesResult non ha voci, il rilevatore non ha trovato alcuna regione di linea di testo nell’immagine. Questo è previsto — non è un bug — per:
- Immagini senza testo leggibile, o testo troppo piccolo, ruotato o a basso contrasto perché il rilevatore lo registri come una regione
- Script non latini: il modello di riconoscimento incorporato copre solo testo in alfabeto latino e i suoi caratteri diacritici
- Immagini in cui le regioni rilevate sono state filtrate durante l’elaborazione posteriore (punteggi molto bassi di probabilità del testo)
Non è disponibile alcun punteggio di confidenza per distinguere “nothing detected” da “detected but uncertain” — vedi Ambito e limitazioni.
Riconoscimento in esecuzione ma i risultati sembrano errati
- Testo ruotato o inclinato. Non esiste alcuna correzione automatica di inclinazione o rotazione. Pre-ruota l’immagine di origine prima di chiamare
Recognize(). - Layout di tabelle o moduli sembrano confusi. Il rilevatore restituisce solo rettangoli di linea allineati agli assi — non ha alcun concetto di colonne, tabelle o ordine di lettura al di là della posizione della linea. Ricostruire il layout è responsabilità di chi chiama.
- La posizione del testo PDF sembra spostata. Le pagine PDF vengono sempre renderizzate internamente a 150 DPI; le coordinate dei rettangoli in
RecognitionResult.LinesResult.Linesono nello spazio dei pixel di quell’immagine renderizzata, non nello spazio dei punti del PDF.
Problemi di piattaforma e compilazione
PlatformNotSupportedExceptiono simile a runtime su Linux/macOS. L’elaborazione delle immagini dipende daSystem.Drawing.Common, che è solo per Windows su .NET 6 e successive. Il percorso di elaborazione delle immagini di questa libreria funziona solo su Windows.- La compilazione fallisce durante il targeting
net9.0/net10.0. La compilazione di questi obiettivi richiede l’SDK .NET 10 — vedi Come compilare dal codice sorgente. - Mixing
InputType.SingleImageandInputType.PDFin unoOcrInput. Non supportato — vedi Come elaborare più immagini in batch.
