GetOCRDiagnosticsJSON
OCR, diagnostyka
Opis
Zwraca JSON w wersji 1 opisujący ostatnią fazę OCR i działanie warstwy, wraz z raportami aktualnie przypisanego silnika należącego do instancji, gdy są dostępne
Składnia
Delphi
Function TPDFlib.GetOCRDiagnosticsJSON: WideString;ActiveX
Function PDFlib::GetOCRDiagnosticsJSON() As StringDLL
const wchar_t* DLGetOCRDiagnosticsJSON(int InstanceID);
const char* DLGetOCRDiagnosticsJSONA(int InstanceID);Wartości zwracane
Obiekt JSON z polami version, phase, status, complete, errorCode i error, wraz z liczbami stron i słów, gdy mają zastosowanie
Stan warstwy
| notStarted | Na tej instancji nie rozpoczęto żadnej operacji OCR |
|---|---|
| configured | Konfiguracja silnika została przyjęta; nie dowodzi to jeszcze, że model danych treningowych potrafi rozpoznać stronę |
| skipped | Strona ma istniejący tekst nienależący do biblioteki; reason ma wartość existingText |
| empty | Żadne słowo nie osiągnęło progu; stare warstwy OCR pozostają nienaruszone |
| appended | Dodano nową warstwę OCR należącą do biblioteki |
| replaced | Zastąpiono co najmniej jedną starą warstwę OCR należącą do biblioteki |
| error | Operacja nie powiodła się; obejrzyj pola błędów |
| cancelled | Dostawca anulował bieżącą operację |
Raporty silnika
Opcjonalny obiekt provider zawiera swój ostatni status, complete, exitCode, error oraz log silnika
Kody statusu dostawcy: 0 — sukces, 1 — niedostępny, 2 — nieprawidłowe wejście, 3 — nieprawidłowe wyjście, 4 — niepowodzenie, 5 — przekroczony limit czasu, 6 — limit wyjścia
Opcjonalny obiekt orientation zawiera orientationDegrees, rotateClockwise, confidence oraz własne pola ukończenia i błędu
Kody statusu orientacji: 0 — sukces, 1 — niedostępny, 2 — nieprawidłowe wejście, 3 — nieprawidłowe wyjście, 4 — niepowodzenie, 5 — przekroczony limit czasu, 6 — limit wyjścia, 7 — niska pewność
Zawsze sprawdzaj flagę ukończenia: świeżo skonfigurowany silnik nie ukończył rozpoznawania, nawet jeśli jego domyślny numeryczny status to zero
Uwagi
Raport nie uruchamia ponownie OCR ani nie przełącza wybranej strony
Raporty skonfigurowanego silnika opisują jego ostatnie uruchomienie, więc późniejsza pominięta strona może zachować poprzedni raport silnika; najwyższy poziom z akcją strony wskazuje ostatnią decyzję dotyczącą strony
OCRDocumentEx pozostawia raport dla ostatniej podjętej strony; jego wartość całkowita podaje liczbę przetworzonych stron
errorCode odzwierciedla LastErrorCode; diagnostykę odczytaj bezpośrednio po wywołaniu OCR, ponieważ inne wywołania API mogą zmienić ostatni kod błędu biblioteki
Szeroki wskaźnik DLL podlega cyklowi życia szerokiego bufora zwrotnego instancji; wariant A zwraca UTF-8 i podlega odpowiadającemu mu cyklowi życia bufora zwrotnego ANSI
Zobacz również
OCRPageEx, OCRDocumentEx, ConfigureTesseractOCR, LastOCRError