How to Read Specialized Documents with C# and IronOCR

Über das Paket

Die Methoden ReadLicensePlate, ReadPassport, ReadPhoto und ReadScreenShot sind Erweiterungsmethoden des Basispakets IronOCR und erfordern die Installation des Pakets IronOcr.Extensions.AdvancedScan .

Die Methoden funktionieren mit OCR-Engine-Konfigurationen wie Blacklist und Whitelist. Mehrere Sprachen, darunter Chinesisch, Japanisch, Koreanisch und das lateinische Alphabet, werden von allen Methoden außer der Methode ReadPassport unterstützt. Bitte beachten Sie, dass jede Sprache ein zusätzliches Sprachpaket erfordert, IronOcr.Languages.

Die erweiterte Abtastung auf dem .NET Framework erfordert, dass das Projekt auf der x64-Architektur ausgeführt wird. Navigieren Sie zur Projektkonfiguration und deaktivieren Sie die Option "Bevorzugt 32-Bit", um dies zu erreichen. Erfahren Sie mehr im folgenden Leitfaden zur Fehlersuche: "Erweiterte Abtastung auf dem .NET Framework".

Dokumentbeispiel lesen

Die ReadDocument-Methode ist eine robuste Dokumentenlesemethode, die sich auf gescannte Dokumente oder Fotos von Papierdokumenten mit viel Text spezialisiert hat. Die Konfiguration PageSegmentationMode ist sehr wichtig beim Lesen von Textdokumenten mit unterschiedlichen Layouts.

Zum Beispiel könnten die Typen SingleBlock und SparseText viel Informationen aus einem Tabellenlayout abrufen. Dies liegt daran, dass SingleBlock davon ausgeht, dass der Text als Block bleibt, während SparseText davon ausgeht, dass der Text im gesamten Dokument verstreut ist.

:path=/static-assets/ocr/content-code-examples/how-to/read-specific-document-document.cs

using IronOcr;
using System;

// Instantiate OCR engine
var ocr = new IronTesseract();

// Configure OCR engine
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.SingleBlock;

using var input = new OcrInput();

input.LoadPdf("Five.pdf");

// Perform OCR
OcrResult result = ocr.ReadDocument(input);

Console.WriteLine(result.Text);

Die unten aufgeführten Methoden sind Erweiterungsmethoden des grundlegenden IronOCR-Pakets und erfordern die Installation des IronOcr.Extensions.AdvancedScan-Pakets.

Nummernschild-Beispiel

Die Methode ReadLicensePlate ist für das Auslesen von Kfz-Kennzeichen anhand von Fotos optimiert. Die speziellen Informationen, die von dieser Methode zurückgegeben werden, sind die Licenseplate-Eigenschaft, die die Informationen über den Standort des Nummernschilds im bereitgestellten Dokument enthält.

:path=/static-assets/ocr/content-code-examples/how-to/read-specific-document-license-plate.cs

using IronOcr;
using IronSoftware.Drawing;
using System;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputLicensePlate = new OcrInput();

inputLicensePlate.LoadImage("LicensePlate.jpeg");

// Perform OCR
OcrLicensePlateResult result = ocr.ReadLicensePlate(inputLicensePlate);

// Retrieve license plate coordinates
Rectangle rectangle = result.Licenseplate;

// Retrieve license plate value
string output = result.Text;

Passexempel lesen

Die Methode ReadPassport ist für das Lesen optimiert und extrahiert Passinformationen aus Passfotos durch Scannen des Inhalts der maschinenlesbaren Zone (MRZ). Eine MRZ ist eine speziell definierte Zone in offiziellen Dokumenten wie Pässen, Personalausweisen und Visa. Die MRZ enthält typischerweise wesentliche persönliche Informationen, wie den Namen des Inhabers, das Geburtsdatum, die Nationalität und die Dokumentennummer. Derzeit unterstützt diese Methode nur die englische Sprache.

:path=/static-assets/ocr/content-code-examples/how-to/read-specific-document-passport.cs

using IronOcr;
using System;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputPassport = new OcrInput();

inputPassport.LoadImage("Passport.jpg");

// Perform OCR
OcrPassportResult result = ocr.ReadPassport(inputPassport);

// Output passport information
Console.WriteLine(result.PassportInfo.GivenNames);
Console.WriteLine(result.PassportInfo.Country);
Console.WriteLine(result.PassportInfo.PassportNumber);
Console.WriteLine(result.PassportInfo.Surname);
Console.WriteLine(result.PassportInfo.DateOfBirth);
Console.WriteLine(result.PassportInfo.DateOfExpiry);

Ergebnis

Bitte stellen Sie sicher, dass das Dokument nur das Passbild enthält. Jeglicher Kopf- und Fußzeilentext könnte die Methode verwirren und ein unerwartetes Ergebnis hervorrufen.

Foto-Beispiel lesen

Die Methode ReadPhoto ist für das Lesen von Bildern mit schwer lesbarem Text optimiert. Diese Methode gibt die TextRegions-Eigenschaft zurück, die nützliche Informationen über den erkannten Text enthält, wie Region, TextInRegion und FrameNumber.

:path=/static-assets/ocr/content-code-examples/how-to/read-specific-document-photo.cs

using IronOcr;
using IronSoftware.Drawing;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputPhoto = new OcrInput();
inputPhoto.LoadImageFrame("photo.tif", 2);

// Perform OCR
OcrPhotoResult result = ocr.ReadPhoto(inputPhoto);

// index number refer to region order in the page
int number = result.TextRegions[0].PageNumber;
string textinregion = result.TextRegions[0].TextInRegion;
Rectangle region = result.TextRegions[0].Region;

Screenshot-Beispiel lesen

Die Methode ReadScreenShot ist für das Lesen von Screenshots mit schwer lesbarem Text optimiert. Ähnlich wie bei der ReadPhoto-Methode gibt es auch die TextRegions-Eigenschaft zurück.

:path=/static-assets/ocr/content-code-examples/how-to/read-specific-document-screenshot.cs
}

using IronOcr;
using System;
using System.Linq;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputScreenshot = new OcrInput();
inputScreenshot.LoadImage("screenshot.png");

// Perform OCR
OcrPhotoResult result = ocr.ReadScreenShot(inputScreenshot);

// Output screenshoot information
Console.WriteLine(result.Text);
Console.WriteLine(result.TextRegions.First().Region.X);
Console.WriteLine(result.TextRegions.Last().Region.Width);
Console.WriteLine(result.Confidence);
}