Wie man Seitenrotation in C# mit IronOCR erkennt
Die DetectPageOrientation-Methode von IronOCR erkennt Seitenrotationswinkel (0°, 90°, 180°, 270°) in PDF-Dokumenten und Bildern automatisch. Es gibt eine RotationAngle-Eigenschaft für jede Seite zurück, die eine programmatische Ausrichtungskorrektur mit Vertrauensbewertungen für eine genaue Textextraktion ermöglicht.
Die Erkennung der Seitendrehung identifiziert, ob eine Dokumentseite im oder gegen den Uhrzeigersinn um 0, 90, 180 oder 270 Grad gedreht wurde. Diese Informationen stellen sicher, dass die Seiten in der richtigen Ausrichtung angezeigt oder verarbeitet werden, um eine genaue Darstellung und Textextraktion zu gewährleisten.
Schnellstart: Verwenden SieDetectPageOrientation, um Seitendrehungen zu identifizieren
Dieses Beispiel zeigt die Verwendung von IronOCRs DetectPageOrientation auf einem PDF, um auf die RotationAngle-Eigenschaft zuzugreifen. Sie bietet eine schnelle Erkennung und Korrektur von Seitendrehungen mit minimalem Code.
-
1Install IronOCR with NuGet Package Manager
-
2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.
var rotationResults = new IronOcr.OcrInput().LoadPdf("doc.pdf").DetectPageOrientation(); Console.WriteLine(rotationResults.First().RotationAngle);C# -
3Bereitstellen zum Testen in Ihrer Live-Umgebung
Beginnen Sie noch heute, IronOCR in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion
Minimaler Arbeitsablauf (5 Schritte)
- C#-Bibliothek herunterladen zum Erkennen von Seitenrotation
- Importieren Sie das PDF-Dokument und die Bilder zum Lesen
- Verwenden Sie die Methode
DetectPageOrientation, um die Drehung für alle Seiten zu erkennen - Zugriff auf die Eigenschaft RotationAngle zur Korrektur der Seitendrehung
- Zugriff auf die HighConfidence-Eigenschaft zur Behandlung von Grenzfällen
Wie kann ich die Seitendrehung in meinen Dokumenten erkennen?
Nach dem Laden eines Dokuments verwenden Sie die DetectPageOrientation-Methode, um die Rotation jeder Seite zu identifizieren. Diese Methode unterstützt 0, 90, 180 und 270 Grad. Für schiefe Bilder über diese Standarddrehungen hinaus verwenden Sie die Deskew-Methode von IronOCRs Bildkorrekturfiltern. Drehen Sie dann das Bild anhand des erkannten Winkels in seine ursprüngliche Ausrichtung zurück. Lassen Sie uns mit einem Beispiel-PDF arbeiten.
using IronOcr;
using System;
using var input = new OcrInput();
// Load PDF document
input.LoadPdf("Clockwise90.pdf");
// Detect page rotation
var results = input.DetectPageOrientation();
// Ouput result
foreach(var result in results)
{
Console.WriteLine(result.PageNumber);
Console.WriteLine(result.HighConfidence);
Console.WriteLine(result.RotationAngle);
}Imports IronOcr
Imports System
Private input = New OcrInput()
' Load PDF document
input.LoadPdf("Clockwise90.pdf")
' Detect page rotation
Dim results = input.DetectPageOrientation()
' Ouput result
For Each result In results
Console.WriteLine(result.PageNumber)
Console.WriteLine(result.HighConfidence)
Console.WriteLine(result.RotationAngle)
Next resultWas bedeuten die Detektionsergebnisse?
PageNumber: Null-basierter Index der Seite.RotationAngle: Drehwinkel in Grad. Verwenden Sie es mit derRotate-Methode, um die Ausrichtung zu korrigieren.HighConfidence: Vertrauensniveau im Ausrichtungsergebnis für Randfälle.
Wann sollte ich hohe Konfidenzwerte verwenden?
Die HighConfidence-Eigenschaft ist entscheidend für mehrdeutige oder minderwertige Dokumente, bei denen die Rotationsdetektion ungewiss sein kann. Dokumente mit spärlichem Text, ungewöhnlichen Layouts oder schlechter Scanqualität führen häufig zu niedrigeren Vertrauenswerten. In diesen Fällen sollten Sie eine zusätzliche Validierung durchführen oder Bildqualitätskorrekturfilter vor der Erkennung anwenden.
Verwenden Sie diesen Wert, um Ausweichstrategien oder eine manuelle Überprüfung für Seiten mit geringem Vertrauen zu implementieren. Wenn beispielsweise die Konfidenz unter 80 % fällt, verarbeiten Sie die Seite mit mehreren Ausrichtungen und vergleichen Sie die OCR-Ergebnisse, oder markieren Sie sie für eine manuelle Überprüfung. Die Computer-Vision-Funktionen von IronOCR helfen dabei, Textbereiche in schwierigen Dokumenten genauer zu identifizieren.
Wie korrigiere ich eine erkannte Drehung?
Nach der Identifizierung des Drehwinkels verwenden Sie die Rotate-Methode auf Ihrem OcrInput-Objekt, um die Ausrichtung vor dem OCR zu korrigieren. Dies gewährleistet eine optimale Texterkennungsgenauigkeit. Umfassende Korrekturen der Ausrichtung finden Sie im Leitfaden zur Korrektur der Bildausrichtung. Hier ist der Korrekturprozess:
// Apply rotation correction based on detection results
if (result.RotationAngle != 0)
{
input.Rotate(360 - result.RotationAngle); // Rotate back to 0°
}' Apply rotation correction based on detection results
If result.RotationAngle <> 0 Then
input.Rotate(360 - result.RotationAngle) ' Rotate back to 0°
End IfFür Dokumente, die eine zusätzliche Vorverarbeitung erfordern, empfiehlt sich die OcrInput-Klasse, die umfangreiche Methoden zur Vorbereitung von Dokumenten vor der OCR-Verarbeitung bietet.
Wie kann ich die Erkennungsgeschwindigkeit und -genauigkeit anpassen?
Die DetectPageOrientation-Methode akzeptiert einen optionalen Parameter zur Steuerung der Detektionsdetails. Durch das Bereitstellen von OrientationDetectionMode-Enums können Sie die Erkennungsgeschwindigkeit und Genauigkeit basierend auf Ihren Anforderungen anpassen.
So setzen Sie es um:
using IronOcr;
using System;
using var input = new OcrInput();
// Load PDF document
input.LoadPdf("Clockwise90.pdf");
// Detect page rotation with Fast mode
var results = input.DetectPageOrientation(OrientationDetectionMode.Fast);
// Ouput result
foreach(var result in results)
{
Console.WriteLine(result.PageNumber);
Console.WriteLine(result.HighConfidence);
Console.WriteLine(result.RotationAngle);
}Imports IronOcr
Imports System
Using input As New OcrInput()
' Load PDF document
input.LoadPdf("Clockwise90.pdf")
' Detect page rotation with Fast mode
Dim results = input.DetectPageOrientation(OrientationDetectionMode.Fast)
' Output result
For Each result In results
Console.WriteLine(result.PageNumber)
Console.WriteLine(result.HighConfidence)
Console.WriteLine(result.RotationAngle)
Next
End UsingWelchen Erkennungsmodus soll ich wählen?
Vier Geschwindigkeitsoptionen sind für OrientationDetectionMode verfügbar:
IronOcr.Extensions.AdvancedScan package. Diese Optionen sind auf Windows x86 und Mac ARM nicht verfügbar.- Schnell: Hochgeschwindigkeitserkennung mit geringerer Genauigkeit. Ideal für Entwürfe oder Massenverarbeitung, wo Schnelligkeit entscheidend ist. Standard für
DetectPageOrientation. Verarbeitet effizient Tausende von Seiten mit Multithreading-Unterstützung. - Balanced: Ausgewogene Geschwindigkeit und Genauigkeit. Geeignet für Produktionsaufgaben. Verwendet AdvancedScan-Erweiterungsfunktionen für verbesserte Genauigkeit bei gleichbleibender Leistung.
- Detailliert: Geringe Geschwindigkeit, hohe Genauigkeit. Am besten geeignet für präzise oder kritische Aufgaben, insbesondere für Dokumente mit komplexem Layout oder gemischtem Inhalt.
- ExtremeDetailed: Langsamste Geschwindigkeit, höchste Genauigkeit. Nur verwenden, wenn Detailliert nicht ausreicht oder der Text stark verdreht und verzerrt ist.
Was sind allgemeine Leistungsüberlegungen?
Die Leistung variiert je nach Modus erheblich. Der Schnellmodus verarbeitet Hunderte von Seiten pro Minute; ExtremeDetailed kann einige Sekunden pro Seite benötigen. Wählen Sie auf der Grundlage von Genauigkeitsanforderungen und Zeitvorgaben. Für optimale Leistung:
- Bildauflösung: Höhere DPI-Einstellungen verbessern die Genauigkeit, erhöhen aber die Verarbeitungszeit. 150-300 DPI reichen in der Regel für die Erkennung von Drehungen aus.
- Dokumententyp: Textreiche Dokumente werden schneller und genauer verarbeitet als spärliche Layouts. Verwenden Sie den Filter-Assistenten, um die Bildqualität vor der Erkennung zu optimieren.
- Ressourcennutzung: Überwachen Sie die Speichernutzung bei der Verarbeitung großer Stapel. Implementieren Sie Fortschrittsverfolgung, um Feedback zu geben und Systemressourcen zu verwalten.
- Parallelverarbeitung: Verwenden Sie für Massenoperationen das Multithreading von IronOCR, um mehrere Dokumente gleichzeitig zu verarbeiten und dabei die Genauigkeit beizubehalten.
Wie gehe ich mit gemischt orientierten Dokumenten um?
Für Dokumente mit gemischter Ausrichtung, verarbeiten Sie jede Seite einzeln mit DetectPageOrientation und wenden Sie dann vor dem OCR seitenweise Rotationskorrekturen an. Dies gewährleistet eine korrekte Orientierung unabhängig von der Ausgangssituation. Hier ist ein effektiver Ansatz:
// Process each page with individual rotation detection
for (int i = 0; i < results.Count; i++)
{
var pageResult = results[i];
// Apply rotation only to pages that need it
if (pageResult.RotationAngle != 0 && pageResult.HighConfidence)
{
// Correct the specific page
input.Pages[i].Rotate(360 - pageResult.RotationAngle);
}
}' Process each page with individual rotation detection
For i As Integer = 0 To results.Count - 1
Dim pageResult = results(i)
' Apply rotation only to pages that need it
If pageResult.RotationAngle <> 0 AndAlso pageResult.HighConfidence Then
' Correct the specific page
input.Pages(i).Rotate(360 - pageResult.RotationAngle)
End If
NextBei komplexen Szenarien mit gescannten Dokumenten unterschiedlicher Qualität oder mehrseitigen TIFFs sollte jede Seite einzeln vorverarbeitet werden, um optimale Ergebnisse zu erzielen.
Bei der Verarbeitung von Eingaben in gemischten Formaten liefert die OcrResult-Klasse detaillierte Seiteninformationen, die eine ausgefeilte Fehlerbehandlung und Qualitätskontroll-Workflows ermöglichen. Für Produktionsumgebungen mit hohem Durchsatz sollten Sie die Optionen der Schnellen OCR-Konfiguration erkunden, um ein Gleichgewicht zwischen Geschwindigkeit und Genauigkeit herzustellen.
Bei der Verarbeitung von Dokumenten, die sowohl Text als auch Barcodes enthalten, sollten Sie die IronOCR-Funktionen OCR mit Barcode- und QR-Lesung verwenden, um alle Informationen in einem einzigen Durchgang zu extrahieren und so die Effizienz zu steigern.
Häufig gestellte Fragen
Was ist die Seitendrehungserkennung und warum ist sie wichtig?
Die Erkennung von Seitendrehungen identifiziert, ob eine Dokumentseite um 0°, 90°, 180° oder 270° gedreht wurde. Dies ist für IronOCR von entscheidender Bedeutung, um sicherzustellen, dass die Seiten in ihrer korrekten Ausrichtung verarbeitet werden, was eine genaue Textextraktion und -wiedergabe aus PDFs und Bildern ermöglicht.
Wie kann ich mit C# schnell eine Seitendrehung in einer PDF-Datei erkennen?
Verwenden Sie die Methode DetectPageOrientation von IronOCR mit minimalem Code: var rotationResults = new IronOcr.OcrInput().LoadPdf("doc.pdf").DetectPageOrientation(); Dies liefert Rotationsinformationen für alle Seiten, die über die Eigenschaft RotationAngle zugänglich sind.
Welche Drehwinkel können erkannt werden?
Die DetectPageOrientation-Methode von IronOCR kann Standarddrehungen von 0°, 90°, 180° und 270° Grad erkennen. Für schiefe Bilder, die über diese Standarddrehungen hinausgehen, verwenden Sie IronOCRs Deskew-Methode aus den Bildkorrekturfiltern.
Welche Informationen werden von DetectPageOrientation zurückgegeben?
Die Methode gibt drei Schlüsseleigenschaften für jede Seite zurück: PageNumber (nullbasierter Index), RotationAngle (Drehung in Grad zur Verwendung mit der Rotate-Methode von IronOCR) und HighConfidence (Konfidenzniveau zur Behandlung von Randfällen).
Wann sollte ich die Eigenschaft HighConfidence verwenden?
Verwenden Sie die HighConfidence-Eigenschaft, wenn Sie mit mehrdeutigen oder qualitativ minderwertigen Dokumenten arbeiten, bei denen die Erkennung von Drehungen unsicher sein kann. Dokumente mit spärlichem Text, ungewöhnlichen Layouts oder schlechter Scanqualität liefern in IronOCR oft niedrigere Vertrauenswerte und erfordern zusätzliche Validierungs- oder Bildqualitätskorrekturfilter.
Funktioniert diese Funktion am besten bei bestimmten Arten von Dokumenten?
Die Funktion DetectPageOrientation von IronOCR funktioniert am besten bei Dokumenten mit hoher Textdichte. Bei Dokumenten mit wenig Text oder komplexen Layouts sollten Sie die Anwendung von Filtern zur Korrektur der Bildqualität vor der Erkennung in Betracht ziehen, um optimale Ergebnisse zu erzielen.
How do I limit memory usage when detecting orientation on large PDFs?
Pass a maxDegreeOfParallelism value to the DetectPageOrientation overload, for example input.DetectPageOrientation(OrientationDetectionMode.Fast, maxDegreeOfParallelism: 2). This caps how many pages are analysed at the same time, and because each concurrent page uses its own native engine, it directly caps peak memory. A non-positive value falls back to Environment.ProcessorCount.
Does adding the maxDegreeOfParallelism parameter break existing code?
No. The single-argument DetectPageOrientation overload is unchanged and remains fully supported, so existing code continues to work without modification. In Fast mode, orientation detection is also more memory efficient because it reuses one engine per worker thread rather than allocating one per page, and results are unchanged.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.
