GetOCRDiagnosticsJSON

OCR, Diagnose

Beschreibung

Liefert JSON in Version 1 zur letzten OCR-Phase und Ebenenaktion, mit Berichten der aktuell zugewiesenen instanzeigenen Engine, sofern verfügbar

Syntax

Delphi

Function TPDFlib.GetOCRDiagnosticsJSON: WideString;

ActiveX

Function PDFlib::GetOCRDiagnosticsJSON() As String

DLL

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

Rückgabewerte

Ein JSON-Objekt mit version, phase, status, complete, errorCode und error, mit Seiten- und Wortzählern, falls zutreffend

Ebenenstatus

notStartedAuf dieser Instanz wurde keine OCR-Operation gestartet
configuredEine Engine-Konfiguration wurde akzeptiert; das beweist nicht, dass ein trainiertes Datenmodell eine Seite erkennen kann
skippedDie Seite hat nicht bibliothekseigenen vorhandenen Text; reason ist existingText
emptyKein Wort erreichte den Schwellenwert; alte OCR-Ebenen bleiben unverändert
appendedEine neue bibliothekseigene OCR-Ebene wurde hinzugefügt
replacedMindestens eine bibliothekseigene alte OCR-Ebene wurde ersetzt
errorDie Operation ist fehlgeschlagen; prüfen Sie die Fehlerfelder
cancelledDer Anbieter hat die laufende Operation abgebrochen

Engine-Berichte

Das optionale provider-Objekt enthält seinen letzten status, complete, exitCode, error und das Engine-log

Provider-Statuscodes sind 0 Erfolg, 1 nicht verfügbar, 2 ungültige Eingabe, 3 ungültige Ausgabe, 4 fehlgeschlagen, 5 Zeitlimit überschritten und 6 Ausgabelimit

Das optionale orientation-Objekt umfasst orientationDegrees, rotateClockwise, confidence sowie eigene Abschluss- und Fehlerfelder

Ausrichtungsstatuscodes sind 0 Erfolg, 1 nicht verfügbar, 2 ungültige Eingabe, 3 ungültige Ausgabe, 4 fehlgeschlagen, 5 Zeitlimit überschritten, 6 Ausgabelimit und 7 niedrige Konfidenz

Prüfen Sie stets das Abschlussflag: eine neu konfigurierte Engine hat keine Erkennung abgeschlossen, selbst wenn ihr numerischer Standardstatus null ist

Anmerkungen

Der Bericht führt OCR nicht erneut aus und wechselt die ausgewählte Seite nicht

Die Berichte der konfigurierten Engine beschreiben ihren letzten Lauf, daher kann eine später übersprungene Seite den vorherigen Engine-Bericht behalten; die Ebenenaktion auf oberster Ebene nennt die letzte Seitenentscheidung

OCRDocumentEx hinterlässt den Bericht seiner zuletzt versuchten Seite; sein ganzzahliger Rückgabewert nennt die Anzahl verarbeiteter Seiten

errorCode spiegelt LastErrorCode; lesen Sie die Diagnose unmittelbar nach dem OCR-Aufruf, weil andere API-Aufrufe den letzten Fehlercode der Bibliothek ändern können

Der DLL-Zeiger in breiten Zeichenfolgen folgt der Lebensdauer des Breitzeichen-Rückgabepuffers der Instanz; die A-Variante liefert UTF-8 und folgt der entsprechenden ANSI-Lebensdauer des Rückgabepuffers

Siehe auch

OCRPageEx, OCRDocumentEx, ConfigureTesseractOCR, LastOCRError