Översikt över funktioner
Översikt över funktioner
Den här sidan introducerar bibliotekets API igenkänning och de funktioner som behandlas utförligt på andra ställen i den här guiden. AsposeOcr är startpunkten för hela biblioteket. Dess Recognize()-metod tar emot en OcrInput och returnerar ett OcrOutput — en lista över RecognitionResult, en per bild eller PDF-sida.
Enkel bild- och PDF-igenkänning
OcrInput konstrueras med en InputType — InputType.SingleImage för en rasterbild, eller InputType.PDF för ett PDF-dokument. Filer köas med OcrInput.Add(). Att avyttra OcrInput rensar bara de köade filsökvägarna den innehåller.
using Aspose.OCR;
var api = new AsposeOcr();
using var input = new OcrInput(InputType.PDF);
input.Add("document.pdf");
OcrOutput output = api.Recognize(input);Igenkänningsresultat
Varje RecognitionResult exponerar RecognitionText (den fullständiga igenkända sidtexten) och RecognitionLinesResult (en lista över RecognitionResult.LinesResult, var och en med TextInLine och en System.Drawing.Rectangle avgränsningsruta i Line).
foreach (RecognitionResult page in output)
{
Console.WriteLine(page.RecognitionText);
foreach (RecognitionResult.LinesResult line in page.RecognitionLinesResult)
{
Console.WriteLine($"{line.Line}: {line.TextInLine}");
}
}Batchbearbetning
OcrInput accepterar mer än en fil av samma inmatningstyp. OcrOutput bevarar den ordning som filerna lades till i, med en RecognitionResult per fil (eller per PDF-sida).
using var input = new OcrInput(InputType.SingleImage);
input.Add("page-1.jpg");
input.Add("page-2.png");
OcrOutput output = api.Recognize(input);Tips och bästa praxis
- Disposera
OcrInput(eller omslut den i ettusing-uttalande) när igenkänning är klar för att frigöra de underliggande resurserna. - Endast
InputType.SingleImageochInputType.PDFstöds — alla andra inmatningstyper kastarNotSupportedException. - Igenkänning är endast för latinskt skript; det finns ingen språkvalparameter.
- PDF-sidor renderas internt före igenkänning, så inget separat PDF-till-bild-konverteringssteg behövs.
Vanliga problem
| Problem | Orsak | Åtgärd |
|---|---|---|
NotSupportedException på Recognize() | Ett OcrInput konstruerades med en ej stödd InputType | Använd endast InputType.SingleImage eller InputType.PDF |
FileNotFoundException på Recognize() | En sökväg som lagts till via OcrInput.Add() finns inte | Verifiera filsökvägen innan du anropar Add() |
Tom RecognitionLinesResult | Ingen textrad upptäcktes i den bilden eller sidan | Bekräfta att källbilden innehåller läsbar, ej roterad text i latinskt skriftsystem |
FAQ
Vilka språk känner Aspose.OCR FOSS för .NET igen?
Latinskriven text. Den inbäddade igenkänningsmodellen täcker inte icke-latinska skript.
Kräver den en internetanslutning?
Nej. Alla tre ONNX-modellerna (detektion, förfining, igenkänning) är inbäddade i samlingen och körs lokalt via Microsoft.ML.OnnxRuntime.
Kan jag känna igen flera filer i ett anrop?
Ja — lägg till flera filer i samma OcrInput innan du anropar AsposeOcr.Recognize(). Den returnerade OcrOutput bevarar deras ordning.
På vilka plattformar körs detta?
Den riktar sig mot .NET Standard 2.0, .NET Framework 4.8 och .NET 8.0+. Bildbehandling kräver Windows, eftersom den är beroende av System.Drawing.Common.
API Reference Sammanfattning
| Klass/Metod | Beskrivning |
|---|---|
AsposeOcr.Recognize(OcrInput) | Ingångspunkt: känner igen text och returnerar ett OcrOutput |
OcrInput.Add(string) | Köar en filväg för igenkänning |
InputType | Enum: SingleImage eller PDF |
RecognitionResult.RecognitionText | Fullständig igenkänd sidtext |
RecognitionResult.RecognitionLinesResult | Lista över igenkända rader med avgränsningsrutor |
RecognitionResult.LinesResult.TextInLine | Känd text för en rad |
RecognitionResult.LinesResult.Line | Pixelkoordinatavgränsningsruta för en rad |