AnalyzePageSkewJSON

Bildverarbeitung, Dokumentprüfung, Rendering

Beschreibung

Misst die zum Begradigen horizontaler Text- und Linienstrukturen auf einer gescannten PDF-Seite erforderliche Drehung und gibt deterministisches JSON zurück, ohne das Dokument zu ändern

Syntax

Delphi

Function TPDFlib.AnalyzePageSkewJSON(Page: Integer; DPI: Double= 0;
  MaxAngle: Double= 0; AngleStep: Double= 0): WideString;

ActiveX

Function PDFlib::AnalyzePageSkewJSON(Page As Long, DPI As Double,
  MaxAngle As Double, AngleStep As Double) As String

DLL

const wchar_t* DLAnalyzePageSkewJSON(int InstanceID, int Page,
  double DPI, double MaxAngle, double AngleStep);
const char* DLAnalyzePageSkewJSONA(int InstanceID, int Page,
  double DPI, double MaxAngle, double AngleStep);

Parameter

Page	Die einsbasierte Seitennummer
DPI	Die Analyseauflösung von 24 bis 1200 vor `RenderScale`; null wählt 96 DPI
MaxAngle	Der symmetrische Suchbereich von 0,1 bis 45 Grad; null wählt 7 Grad aus
AngleStep	Der grobe Suchschritt von 0,01 bis `MaxAngle`; null wählt 1 Grad, gefolgt von automatischer Feinverfeinerung

Rückgabewerte

Gibt JSON-Felder für page, den Korrekturwinkel angle, das Bewertungsverhältnis confidence, den Spitzenwert score, den automatischen Graustufenschwellenwert threshold, die Anzahl der abgetasteten Vordergrundpixel, den Abtastschritt, die Anzahl ausgewerteter Winkel, die Rasterabmessungen und die effektive DPI zurück

Der Winkel ist die im PDF-Benutzerraum anzuwendende Korrektur; positive Werte drehen gegen den Uhrzeigersinn, negative im Uhrzeigersinn

Gibt eine leere Zeichenfolge zurück, wenn Validierung, Rendering oder Analyse fehlschlägt

Anmerkungen

Die Implementierung rendert eine begrenzte Top-down-Bitmap, senkt bei Bedarf automatisch die effektive DPI-Zahl, um innerhalb von vier Millionen Pixeln zu bleiben, berechnet einen automatischen Luminanzschwellenwert und bewertet differenzielle Zeilenprofile durch eine Winkelsuche von grob nach fein

Leere oder nahezu einfarbige Seiten gelten als erfolgreiche Analysen mit einer Konfidenz von null und ohne Korrektur

Die zuvor ausgewählte Seite wird vor der Rückkehr der Methode wiederhergestellt

LastErrorCode ist 116 bei ungültigen Seiten- oder Suchparametern und 520 bei Render- oder Analysefehlern

Siehe auch

DeskewPage, DeskewPageRange, ApplyOCRTextLayer