Aspose.OCR FOSS for .NET — Probleemoplossing
Deze pagina geeft een overzicht van de fouten en beperkingen die het meest waarschijnlijk optreden bij het integreren van Aspose.OCR FOSS voor .NET, met de werkelijke oorzaak achter elk.
Uitzonderingen gegooid door Recognize()
AsposeOcr.Recognize() valideert zijn invoer voordat een model wordt uitgevoerd. Elke controle hieronder faalt in deze volgorde:
| Exception | Oorzaak | Oplossing |
|---|---|---|
ArgumentNullException | De OcrInput die aan Recognize() is doorgegeven, is null | Maak altijd een OcrInput aan voordat je Recognize() aanroept |
NotSupportedException | OcrInput is geconstrueerd met een InputType anders dan SingleImage of PDF | Alleen InputType.SingleImage en InputType.PDF zijn geldig |
FileNotFoundException | Een pad dat via OcrInput.Add() is toegevoegd, bestaat niet op schijf | Valideer elk pad voordat Add() wordt aangeroepen — een ontbrekend bestand laat de hele oproep mislukken, niet alleen dat bestand |
Herkenning geeft geen tekst terug
Als RecognitionResult.RecognitionText leeg is en RecognitionLinesResult geen invoer heeft, heeft de detector geen tekstregelgebied in de afbeelding gevonden. Dit is verwacht — geen bug — voor:
- Afbeeldingen zonder leesbare tekst, of tekst die te klein, gedraaid of van laag contrast is, waardoor de detector het niet als een regio registreert
- Niet-Latijnse scripts: het ingebedde herkenningsmodel ondersteunt alleen Latijnse tekst en de bijbehorende diacritische tekens
- Afbeeldingen waarin de gedetecteerde regio’s tijdens de nabewerking werden gefilterd (zeer lage tekst-kansscores)
Er is geen betrouwbaarheidscore beschikbaar om “nothing detected” te onderscheiden van “detected but uncertain” — see Reikwijdte en beperkingen.
Herkenning wordt uitgevoerd, maar resultaten lijken onjuist
- Gedraaide of scheve tekst. Er is geen automatische rechtzetting of rotatiecorrectie. Pre-rotate de bronafbeelding voordat je aanroept
Recognize(). - Tabellen of formulierindelingen zien er rommelig uit. De detector retourneert alleen as-uitgelijnde lijnrechthoeken — hij heeft geen concept van kolommen, tabellen of leesvolgorde buiten de lijnpositie. Het reconstrueren van de lay-out is de verantwoordelijkheid van de aanroeper.
- PDF-tekstpositie lijkt verschoven. PDF-pagina’s worden intern altijd gerenderd op 150 DPI; rechthoekcoördinaten in
RecognitionResult.LinesResult.Linebevinden zich in de pixelruimte van die gerenderde afbeelding, niet in de puntruimte van de PDF.
Platform- en buildproblemen
PlatformNotSupportedExceptionof iets dergelijks tijdens runtime op Linux/macOS. Beeldverwerking is afhankelijk vanSystem.Drawing.Common, die alleen beschikbaar is voor Windows op .NET 6 en later. Het beeldverwerkingspad van deze bibliotheek draait alleen op Windows.- Bouw mislukt bij targeten van
net9.0/net10.0. Het bouwen van die doelwitten vereist de .NET 10 SDK — zie Hoe te bouwen vanaf de bron. - Mixing
InputType.SingleImageandInputType.PDFin éénOcrInput. Niet ondersteund — zie Hoe meerdere afbeeldingen in batch te verwerken.
