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
| notStarted | Auf dieser Instanz wurde keine OCR-Operation gestartet |
|---|---|
| configured | Eine Engine-Konfiguration wurde akzeptiert; das beweist nicht, dass ein trainiertes Datenmodell eine Seite erkennen kann |
| skipped | Die Seite hat nicht bibliothekseigenen vorhandenen Text; reason ist existingText |
| empty | Kein Wort erreichte den Schwellenwert; alte OCR-Ebenen bleiben unverändert |
| appended | Eine neue bibliothekseigene OCR-Ebene wurde hinzugefügt |
| replaced | Mindestens eine bibliothekseigene alte OCR-Ebene wurde ersetzt |
| error | Die Operation ist fehlgeschlagen; prüfen Sie die Fehlerfelder |
| cancelled | Der 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