GetOCRDiagnosticsJSON

OCR, diagnostiek

Beschrijving

Geeft JSON in versie 1 terug die de laatste OCR-fase en laagactie beschrijft, met rapporten van de momenteel toegewezen engine in instantiebezit wanneer beschikbaar

Syntaxis

Delphi

Function TPDFlib.GetOCRDiagnosticsJSON: WideString;

ActiveX

Function PDFlib::GetOCRDiagnosticsJSON() As String

DLL

const wchar_t* DLGetOCRDiagnosticsJSON(int InstanceID);
const char* DLGetOCRDiagnosticsJSONA(int InstanceID);

Retourwaarden

Een JSON-object met version, phase, status, complete, errorCode en error, met pagina- en wordtellingen wanneer van toepassing

Laagstatus

notStarted	Er is op deze instantie geen OCR-bewerking gestart
configured	Een engineconfiguratie is geaccepteerd; dit bewijst niet dat een getraind datamodel een pagina kan herkennen
skipped	De pagina heeft bestaande tekst buiten bibliotheekbezit; `reason` is `existingText`
empty	Geen enkel woord haalde de drempel; oude OCR-lagen blijven onaangetast
appended	Er is een nieuwe OCR-laag in bibliotheekbezit toegevoegd
replaced	Minstens één oude OCR-laag in bibliotheekbezit is vervangen
error	De bewerking mislukte; bekijk de foutvelden
cancelled	De provider heeft de lopende bewerking geannuleerd

Enginerapporten

Het optionele provider-object bevat zijn laatste status, complete, exitCode, error en de engine-log

Providerstatuscodes zijn 0 succes, 1 niet beschikbaar, 2 ongeldige invoer, 3 ongeldige uitvoer, 4 mislukt, 5 time-out en 6 uitvoerlimiet

Het optionele orientation-object bevat orientationDegrees, rotateClockwise, confidence en zijn eigen voltooiings- en foutvelden

Oriëntatiestatuscodes zijn 0 succes, 1 niet beschikbaar, 2 ongeldige invoer, 3 ongeldige uitvoer, 4 mislukt, 5 time-out, 6 uitvoerlimiet en 7 lage betrouwbaarheid

Controleer altijd de voltooiingsvlag: een pas geconfigureerde engine heeft de herkenning nog niet afgerond, ook niet als zijn standaard numerieke status nul is

Opmerkingen

Het rapport voert OCR niet opnieuw uit en wisselt de geselecteerde pagina niet

De rapporten van de geconfigureerde engine beschrijven zijn laatste run, dus een later overgeslagen pagina kan het eerdere enginerapport behouden; de pagina-actie op topniveau identificeert de laatste paginabeslissing

OCRDocumentEx laat het rapport van zijn laatst geprobeerde pagina staan; zijn integer-retourwaarde geeft het aantal verwerkte pagina's

errorCode weerspiegelt LastErrorCode; lees de diagnostiek direct na de OCR-aanroep, omdat andere API-aanroepen de laatste foutcode van de bibliotheek kunnen veranderen

De DLL wide-pointer volgt de levensduur van de wide-retourbuffer van de instantie; de A-variant geeft UTF-8 terug en volgt de bijbehorende levensduur van de ANSI-retourbuffer

Zie ook

OCRPageEx, OCRDocumentEx, ConfigureTesseractOCR, LastOCRError