ApplyOCRTextLayer

OCR, tekst, documentbewerking

Beschrijving

Valideert providerneutrale OCR-JSON en voegt gepaste rendering-mode-3-tekst toe aan een pagina

De toegevoegde tekst is doorzoekbaar en selecteerbaar, maar onzichtbaar wanneer de pagina wordt gerenderd

Syntaxis

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);

Parameters

PageDe doelpagina, beginnend bij 1
ResultJSONEen OCR-resultaatobject met versie
FontNameEen insluitbare TrueType-fontnaam of -pad, of een lege string om een geïnstalleerd alternatief te selecteren
MinConfidenceDe inclusieve vertrouwensdrempel van 0 tot en met 1

JSON-schema

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

lefttop

Wanneer zowel width als height aanwezig zijn, worden woordboxen van die brondimensies naar de PDF-pagina geschaald; wanneer beide ontbreken, worden coördinaten als PDF-punten geïnterpreteerd

Elk woord vereist text, left, top, width en height; confidence is optioneel en staat standaard op 1

top, breedte en hoogte; confidence is optioneel en staat standaard op 1 Geometrie moet eindig en niet-negatief zijn met positieve breedte en hoogte, terwijl confidence van 0 tot en met 1 moet lopen

Retourwaarden

1De tekstlaag is toegevoegd, of geen woord haalde de drempelwaarde
0Validatie of schrijven is mislukt

Opmerkingen

De volledige JSON-structuur en elke woordgrens worden gevalideerd voordat pagina-inhoud wordt weggeschreven

Elk woord wordt op boxhoogte gemeten en horizontaal passend gemaakt met textschaal, terwijl een geïsoleerde graphics state voorkomt dat OCR-opmaak intocht in latere tekenoperaties

LastErrorCode is 110 bij ongeldige OCR-JSON en 307 bij een schrijffout voor pagina, font of tekstlaag

LastOCRError geeft de gedetailleerde reden

Zie ook

OCRPage, OCRDocument, LastOCRError, RenderPageToString