Overzicht van functies
Functies Overzicht
Deze pagina introduceert de API van de bibliotheek en de mogelijkheden die elders in deze gids uitvoerig worden behandeld. AsposeOcr is het toegangspunt voor de hele bibliotheek. Zijn Recognize() methode accepteert een OcrInput en retourneert een OcrOutput — een lijst van RecognitionResult, één per afbeelding of PDF-pagina.
Enkele afbeelding- en PDF-herkenning
OcrInput wordt geconstrueerd met een InputType — InputType.SingleImage voor een rasterafbeelding, of InputType.PDF voor een PDF-document. Bestanden worden in de wachtrij geplaatst met OcrInput.Add(). Het vrijgeven van OcrInput wist alleen de in de wachtrij opgeslagen bestands-paden die het bevat.
using Aspose.OCR;
var api = new AsposeOcr();
using var input = new OcrInput(InputType.PDF);
input.Add("document.pdf");
OcrOutput output = api.Recognize(input);Herkenningsresultaten
Elke RecognitionResult biedt RecognitionText (de volledige herkende paginatekst) en RecognitionLinesResult (een lijst van RecognitionResult.LinesResult, elk met TextInLine en een System.Drawing.Rectangle begrenzingsvak in Line).
foreach (RecognitionResult page in output)
{
Console.WriteLine(page.RecognitionText);
foreach (RecognitionResult.LinesResult line in page.RecognitionLinesResult)
{
Console.WriteLine($"{line.Line}: {line.TextInLine}");
}
}Batchverwerking
OcrInput accepteert meer dan één bestand van hetzelfde invoertype. OcrOutput behoudt de volgorde waarin de bestanden werden toegevoegd, met één RecognitionResult per bestand (of per PDF-pagina).
using var input = new OcrInput(InputType.SingleImage);
input.Add("page-1.jpg");
input.Add("page-2.png");
OcrOutput output = api.Recognize(input);Tips en best practices
- Dispose
OcrInput(of wikkel het in eenusing-statement) zodra de herkenning voltooid is om de onderliggende bronnen vrij te geven. - Alleen
InputType.SingleImageenInputType.PDFworden ondersteund — elk ander invoertype veroorzaaktNotSupportedException. - Herkenning ondersteunt alleen het Latijnse schrift; er is geen taalkeuze-parameter.
- PDF-pagina’s worden intern gerenderd vóór de herkenning, dus een aparte PDF-naar-afbeelding-conversiestap is niet nodig.
Veelvoorkomende problemen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
NotSupportedException op Recognize() | Een OcrInput werd geconstrueerd met een niet-ondersteunde InputType | Gebruik alleen InputType.SingleImage of InputType.PDF |
FileNotFoundException op Recognize() | Een pad toegevoegd via OcrInput.Add() bestaat niet | Controleer het bestandspad voordat je Add() aanroept |
Leeg RecognitionLinesResult | Er is geen tekstregel gedetecteerd in die afbeelding of pagina | Bevestig dat de bronafbeelding leesbare, niet-gedraaide Latijnse tekst bevat |
FAQ
Welke talen herkent Aspose.OCR FOSS voor .NET?
Latijns schrifttekst. Het ingebedde herkenningsmodel dekt geen niet-Latijnse scripts.
Vereist het een internetverbinding?
Nee. Alle drie ONNX-modellen (detectie, verfijning, herkenning) zijn ingebed in de assembly en worden lokaal uitgevoerd via Microsoft.ML.OnnxRuntime.
Kan ik meerdere bestanden in één aanroep herkennen?
Ja — voeg meerdere bestanden toe aan dezelfde OcrInput voordat je AsposeOcr.Recognize() aanroept. De geretourneerde OcrOutput behoudt hun volgorde.
Op welke platforms draait dit?
Het richt zich op .NET Standard 2.0, .NET Framework 4.8 en .NET 8.0+. Beeldverwerking vereist Windows, omdat het afhankelijk is van System.Drawing.Common.
API Reference Samenvatting
| Klasse/Methode | Beschrijving |
|---|---|
AsposeOcr.Recognize(OcrInput) | Instappunt: herkent tekst en retourneert een OcrOutput |
OcrInput.Add(string) | Zet een bestandspad in de wachtrij voor herkenning |
InputType | Enum: SingleImage of PDF |
RecognitionResult.RecognitionText | Volledige herkende paginatekst |
RecognitionResult.RecognitionLinesResult | Lijst van herkende regels met begrenzingsvakken |
RecognitionResult.LinesResult.TextInLine | Herkennde tekst voor één regel |
RecognitionResult.LinesResult.Line | Pixelcoördinaat begrenzingsvak voor één regel |