GetOCRDiagnosticsJSON
OCR, диагностика
Описание
Возвращает JSON версии 1 с описанием последней фазы OCR и действия над слоем, а при наличии — отчёты назначенного принадлежащего экземпляру движка
Синтаксис
Delphi
Function TPDFlib.GetOCRDiagnosticsJSON: WideString;ActiveX
Function PDFlib::GetOCRDiagnosticsJSON() As StringDLL
const wchar_t* DLGetOCRDiagnosticsJSON(int InstanceID);
const char* DLGetOCRDiagnosticsJSONA(int InstanceID);Возвращаемые значения
JSON-объект с полями version, phase, status, complete, errorCode и error, а при применимости — с числом страниц и слов
Статусы слоя
| notStarted | На этом экземпляре не начиналась ни одна операция OCR |
|---|---|
| configured | Конфигурация движка принята; это не доказывает, что модель обученных данных способна распознать страницу |
| skipped | На странице есть существующий текст, не принадлежащий библиотеке; reason равен existingText |
| empty | Ни одно слово не прошло порог; старые слои OCR остаются нетронутыми |
| appended | Добавлен новый слой OCR, принадлежащий библиотеке |
| replaced | Заменён хотя бы один старый слой OCR, принадлежавший библиотеке |
| error | Операция не удалась; проверьте поля ошибки |
| cancelled | Провайдер отменил текущую операцию |
Отчёты движка
Опциональный объект provider содержит его последние status, complete, exitCode, error и log движка
Коды статуса провайдера: 0 — успех, 1 — недоступен, 2 — недопустимый вход, 3 — недопустимый вывод, 4 — сбой, 5 — тайм-аут, 6 — лимит вывода
Опциональный объект orientation включает orientationDegrees, rotateClockwise, confidence и собственные поля завершения и ошибки
Коды статуса ориентации: 0 — успех, 1 — недоступен, 2 — недопустимый вход, 3 — недопустимый вывод, 4 — сбой, 5 — тайм-аут, 6 — лимит вывода, 7 — низкая уверенность
Всегда проверяйте флаг завершения: только что настроенный движок ещё не завершил распознавание, даже если его числовой статус по умолчанию равен нулю
Примечания
Отчёт не перезапускает OCR и не переключает выбранную страницу
Отчёты настроенного движка описывают его последний запуск, поэтому на более поздней пропущенной странице может удерживаться прежний отчёт движка; действие верхнего уровня определяет последнее решение по странице
OCRDocumentEx оставляет отчёт для своей последней попытки страницы; его целочисленное возвращаемое значение даёт число обработанных страниц
errorCode отражает LastErrorCode; читайте диагностику сразу после вызова OCR, потому что другие вызовы API могут изменить последний код ошибки библиотеки
Широкий указатель DLL следует времени жизни широкого буфера возврата экземпляра; вариант A возвращает UTF-8 и следует времени жизни соответствующего ANSI-буфера возврата
См. также
OCRPageEx, OCRDocumentEx, ConfigureTesseractOCR, LastOCRError