Panoramica delle funzionalità

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’istruzione using) una volta completato il riconoscimento per liberare le risorse sottostanti.
  • Sono supportati solo InputType.SingleImage e InputType.PDF — qualsiasi altro tipo di input genera NotSupportedException.
  • 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

ProblemaCausaCorrezione
NotSupportedException su Recognize()Un OcrInput è stato costruito con un InputType non supportatoUsa solo InputType.SingleImage o InputType.PDF
FileNotFoundException su Recognize()Un percorso aggiunto tramite OcrInput.Add() non esisteVerifica il percorso del file prima di chiamare Add()
Vuoto RecognitionLinesResultNon è stata rilevata alcuna riga di testo in quell’immagine o paginaConferma 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/MetodoDescrizione
AsposeOcr.Recognize(OcrInput)Punto di ingresso: riconosce il testo e restituisce un OcrOutput
OcrInput.Add(string)Accoda un percorso file per il riconoscimento
InputTypeEnum: SingleImage o PDF
RecognitionResult.RecognitionTextTesto completo della pagina riconosciuta
RecognitionResult.RecognitionLinesResultElenco delle linee riconosciute con bounding boxes
RecognitionResult.LinesResult.TextInLineTesto riconosciuto per una riga
RecognitionResult.LinesResult.LineRettangolo di delimitazione in coordinate pixel per una riga

Vedi anche

 Italiano