Prezentare generală a caracteristicilor
Prezentare generală a funcționalităților
Această pagină prezintă API de recunoaștere al bibliotecii și capabilitățile detaliate în altă parte în acest ghid. AsposeOcr este punctul de intrare pentru întreaga bibliotecă. Metoda sa Recognize() acceptă un OcrInput și returnează un OcrOutput — o listă de RecognitionResult, una pentru fiecare imagine sau pagină PDF.
Recunoaștere imagine unică și PDF
OcrInput este construit cu un InputType — InputType.SingleImage pentru o imagine raster, sau InputType.PDF pentru un document PDF. Fișierele sunt puse în coadă cu OcrInput.Add(). Eliberarea OcrInput șterge doar căile de fișiere din coadă pe care le deține.
using Aspose.OCR;
var api = new AsposeOcr();
using var input = new OcrInput(InputType.PDF);
input.Add("document.pdf");
OcrOutput output = api.Recognize(input);Rezultatele recunoașterii
Fiecare RecognitionResult expune RecognitionText (textul complet recunoscut al paginii) și RecognitionLinesResult (o listă de RecognitionResult.LinesResult, fiecare având TextInLine și o cutie delimitatoare System.Drawing.Rectangle în Line).
foreach (RecognitionResult page in output)
{
Console.WriteLine(page.RecognitionText);
foreach (RecognitionResult.LinesResult line in page.RecognitionLinesResult)
{
Console.WriteLine($"{line.Line}: {line.TextInLine}");
}
}Procesare în lot
OcrInput acceptă mai mult de un fișier de același tip de intrare. OcrOutput păstrează ordinea în care fișierele au fost adăugate, cu un RecognitionResult per fișier (sau per pagină PDF).
using var input = new OcrInput(InputType.SingleImage);
input.Add("page-1.jpg");
input.Add("page-2.png");
OcrOutput output = api.Recognize(input);Sfaturi și cele mai bune practici
- Eliberați
OcrInput(sau încadrați-l într-o declarațieusing) odată ce recunoașterea este finalizată pentru a elibera resursele subiacente. - Doar
InputType.SingleImageșiInputType.PDFsunt acceptate — orice alt tip de intrare aruncăNotSupportedException. - Recunoașterea este disponibilă doar pentru scriptul latin; nu există un parametru de selecție a limbii.
- Paginile PDF sunt randate intern înainte de recunoaștere, astfel că nu este necesar un pas separat de conversie PDF-în-imagine.
Probleme comune
| Problemă | Cauză | Remediere |
|---|---|---|
NotSupportedException pe Recognize() | Un OcrInput a fost construit cu un InputType nesuportat | Folosiți numai InputType.SingleImage sau InputType.PDF |
FileNotFoundException pe Recognize() | O cale adăugată prin OcrInput.Add() nu există | Verificați calea fișierului înainte de a apela Add() |
Gol RecognitionLinesResult | Nu a fost detectată nicio linie de text în acea imagine sau pagină | Confirmați că imaginea sursă conține text lizibil, ne-rotit, în script latin |
FAQ
Ce limbi recunoaște Aspose.OCR FOSS pentru .NET?
Text cu script latin. Modelul de recunoaștere încorporat nu acoperă scripturile non-latine.
Necesită o conexiune la internet?
Nu. Toate cele trei modele ONNX (detectare, rafinare, recunoaștere) sunt încorporate în ansamblu și rulează local prin Microsoft.ML.OnnxRuntime.
Pot recunoaște mai multe fișiere într-un singur apel?
Da — adăugați mai multe fișiere la același OcrInput înainte de a apela AsposeOcr.Recognize(). OcrOutput returnat păstrează ordinea lor.
Pe ce platforme rulează aceasta?
Vizează .NET Standard 2.0, .NET Framework 4.8 și .NET 8.0+. Procesarea imaginilor necesită Windows, deoarece depinde de System.Drawing.Common.
API Reference Rezumat
| Clasă/Metodă | Descriere: |
|---|---|
AsposeOcr.Recognize(OcrInput) | Punct de intrare: recunoaște textul și returnează un OcrOutput |
OcrInput.Add(string) | Pune în coadă o cale de fișier pentru recunoaștere |
InputType | Enum: SingleImage sau PDF |
RecognitionResult.RecognitionText | Text complet al paginii recunoscute |
RecognitionResult.RecognitionLinesResult | Listă de linii recunoscute cu cutii de delimitare |
RecognitionResult.LinesResult.TextInLine | Text recunoscut pentru o linie |
RecognitionResult.LinesResult.Line | Cutie delimitatoare cu coordonate de pixel pentru o linie |