ApplyOCRTextLayer

OCR, Text, Dokumentbearbeitung

Beschreibung

Validiert anbieterneutrales OCR-JSON und fügt einer Seite eingepassten Text im Renderingmodus 3 hinzu

Der hinzugefügte Text kann durchsucht und ausgewählt werden, bleibt beim Rendern der Seite jedoch unsichtbar

Syntax

Delphi

Function TPDFlib.ApplyOCRTextLayer(Page: Integer; Const ResultJSON,
  FontName: WideString; MinConfidence: Double): Integer;

ActiveX

Function PDFlib::ApplyOCRTextLayer(Page As Long, ResultJSON As String, FontName As String, MinConfidence As Double) As Long

DLL

int DLApplyOCRTextLayer(int InstanceID, int Page, const wchar_t* ResultJSON,
  const wchar_t* FontName, double MinConfidence);
int DLApplyOCRTextLayerA(int InstanceID, int Page, const char* ResultJSON,
  const char* FontName, double MinConfidence);

Parameter

Page	Die einsbasierte Zielseite
ResultJSON	Ein versioniertes OCR-Ergebnisobjekt
FontName	Name oder Pfad einer einbettbaren TrueType-Schriftart oder eine leere Zeichenfolge zur Auswahl einer installierten Ausweichschrift
MinConfidence	Der inklusive Konfidenzschwellenwert von 0 bis 1

JSON-Schema

{
  "version": 1,
  "width": 2480,
  "height": 3508,
  "words": [
    {"text": "Invoice", "left": 120, "top": 180,
     "width": 260, "height": 54, "confidence": 0.98}
  ]
}

left und top verwenden einen Ursprung oben links in Quelleinheiten

Wenn sowohl width als auch height vorhanden sind, werden Wortfelder von diesen Quelldimensionen auf die PDF-Seite skaliert; fehlen beide, werden Koordinaten als PDF-Punkte interpretiert

Jedes Wort erfordert text, left, top, width und height; confidence ist optional und hat den Standardwert 1

Die Geometrie muss endlich und nicht negativ sein und positive Breite und Höhe besitzen; die Konfidenz muss zwischen 0 und 1 liegen

Rückgabewerte

1	Die Textebene wurde hinzugefügt oder kein Wort erreichte den Schwellenwert
0	Die Validierung oder das Schreiben ist fehlgeschlagen

Anmerkungen

Die vollständige JSON-Struktur und jede Wortgrenze werden validiert, bevor Seiteninhalt geschrieben wird

Die Größe jedes Worts wird aus seiner Rahmenhöhe abgeleitet und mit Textskalierung horizontal eingepasst; ein isolierter Grafikzustand verhindert, dass OCR-Formatierungen in spätere Zeichenvorgänge gelangen

LastErrorCode ist 110 bei ungültigem OCR-JSON und 307 bei einem Fehler beim Schreiben einer Seite, Schrift oder Textebene

LastOCRError liefert den ausführlichen Grund

Siehe auch

OCRPage, OCRDocument, LastOCRError, RenderPageToString