Panoramica delle funzionalità
Panoramica delle funzionalità
Questa pagina introduce il API di riconoscimento della libreria e le capacità trattate in dettaglio altrove in questa guida. AsposeOcr è il punto di ingresso per l’intera libreria. Il suo metodo Recognize() accetta un OcrInput e restituisce un OcrOutput — un elenco di RecognitionResult, uno per immagine o pagina PDF.
Riconoscimento di immagine singola e PDF
OcrInput è costruito con un InputType — InputType.SingleImage per un’immagine raster, oppure InputType.PDF per un documento PDF. I file vengono accodati con OcrInput.Add(). Disporre OcrInput elimina solo i percorsi dei file accodati che contiene.
using Aspose.OCR;
var api = new AsposeOcr();
using var input = new OcrInput(InputType.PDF);
input.Add("document.pdf");
OcrOutput output = api.Recognize(input);Risultati del riconoscimento
Ogni RecognitionResult espone RecognitionText (il testo completo della pagina riconosciuta) e RecognitionLinesResult (un elenco di RecognitionResult.LinesResult, ciascuno con TextInLine e un System.Drawing.Rectangle bounding box in Line).
foreach (RecognitionResult page in output)
{
Console.WriteLine(page.RecognitionText);
foreach (RecognitionResult.LinesResult line in page.RecognitionLinesResult)
{
Console.WriteLine($"{line.Line}: {line.TextInLine}");
}
}Elaborazione batch
OcrInput accetta più di un file dello stesso tipo di input. OcrOutput preserva l’ordine in cui i file sono stati aggiunti, con un RecognitionResult per file (o per pagina PDF).
using var input = new OcrInput(InputType.SingleImage);
input.Add("page-1.jpg");
input.Add("page-2.png");
OcrOutput output = api.Recognize(input);Suggerimenti e migliori pratiche
- Rilascia
OcrInput(o racchiudilo in un’istruzioneusing) una volta completato il riconoscimento per liberare le risorse sottostanti. - Sono supportati solo
InputType.SingleImageeInputType.PDF— qualsiasi altro tipo di input generaNotSupportedException. - Il riconoscimento è disponibile solo per script latino; non esiste un parametro di selezione della lingua.
- Le pagine PDF vengono renderizzate internamente prima del riconoscimento, quindi non è necessario un passaggio separato di conversione PDF-in-immagine.
Problemi comuni
| Problema | Causa | Correzione |
|---|---|---|
NotSupportedException su Recognize() | Un OcrInput è stato costruito con un InputType non supportato | Usa solo InputType.SingleImage o InputType.PDF |
FileNotFoundException su Recognize() | Un percorso aggiunto tramite OcrInput.Add() non esiste | Verifica il percorso del file prima di chiamare Add() |
Vuoto RecognitionLinesResult | Non è stata rilevata alcuna riga di testo in quell’immagine o pagina | Conferma che l’immagine di origine contenga testo leggibile, non ruotato, in alfabeto latino |
FAQ
Quali lingue riconosce Aspose.OCR FOSS per .NET?
Testo in alfabeto latino. Il modello di riconoscimento incorporato non copre script non latini.
Richiede una connessione a Internet?
No. Tutti e tre i modelli ONNX (rilevamento, raffinamento, riconoscimento) sono incorporati nell’assembly e vengono eseguiti localmente tramite Microsoft.ML.OnnxRuntime.
Posso riconoscere più file in una singola chiamata?
Sì — aggiungi più file allo stesso OcrInput prima di chiamare AsposeOcr.Recognize(). Il OcrOutput restituito conserva il loro ordine.
Su quali piattaforme funziona questo?
Target .NET Standard 2.0, .NET Framework 4.8 e .NET 8.0+. L’elaborazione delle immagini richiede Windows, perché dipende da System.Drawing.Common.
API Reference Riepilogo
| Classe/Metodo | Descrizione |
|---|---|
AsposeOcr.Recognize(OcrInput) | Punto di ingresso: riconosce il testo e restituisce un OcrOutput |
OcrInput.Add(string) | Accoda un percorso file per il riconoscimento |
InputType | Enum: SingleImage o PDF |
RecognitionResult.RecognitionText | Testo completo della pagina riconosciuta |
RecognitionResult.RecognitionLinesResult | Elenco delle linee riconosciute con bounding boxes |
RecognitionResult.LinesResult.TextInLine | Testo riconosciuto per una riga |
RecognitionResult.LinesResult.Line | Rettangolo di delimitazione in coordinate pixel per una riga |