GetOCRDiagnosticsJSON
OCR, diagnósticos
Descrição
Retorna um JSON versão 1 descrevendo a fase de OCR mais recente e a ação da camada, com relatórios do engine próprio da instância atualmente atribuído quando disponível
Sintaxe
Delphi
Function TPDFlib.GetOCRDiagnosticsJSON: WideString;ActiveX
Function PDFlib::GetOCRDiagnosticsJSON() As StringDLL
const wchar_t* DLGetOCRDiagnosticsJSON(int InstanceID);
const char* DLGetOCRDiagnosticsJSONA(int InstanceID);Valores retornados
Um objeto JSON contendo version, phase, status, complete, errorCode e error, com contagens de páginas e de palavras quando aplicável
Status da camada
| notStarted | Nenhuma operação de OCR começou nesta instância |
|---|---|
| configured | Uma configuração de engine foi aceita; isso não prova que um modelo de trained data consegue reconhecer uma página |
| skipped | A página tem texto existente que não é próprio; reason é existingText |
| empty | Nenhuma palavra atingiu o limite; as camadas de OCR antigas permanecem intactas |
| appended | Uma nova camada de OCR própria foi adicionada |
| replaced | Pelo menos uma camada de OCR antiga própria foi substituída |
| error | A operação falhou; examine os campos de erro |
| cancelled | O provider cancelou a operação atual |
Relatórios do engine
O objeto opcional provider contém o status, o complete, o exitCode, o error e o log do engine mais recentes
Os códigos de status do provider são: 0 sucesso, 1 indisponível, 2 entrada inválida, 3 saída inválida, 4 falhou, 5 timeout e 6 limite de saída
O objeto opcional orientation inclui orientationDegrees, rotateClockwise, confidence e os próprios campos de conclusão e de erro
Os códigos de status de orientação são: 0 sucesso, 1 indisponível, 2 entrada inválida, 3 saída inválida, 4 falhou, 5 timeout, 6 limite de saída e 7 confiança baixa
Sempre cheque a flag de conclusão: um engine recém-configurado não concluiu reconhecimento algum mesmo que o status numérico padrão dele seja zero
Observações
O relatório não reexecuta OCR nem troca a página selecionada
Os relatórios do engine configurado descrevem a execução mais recente dele, então uma página pulada depois pode reter o relatório anterior do engine; a ação de página no nível mais alto identifica a decisão mais recente sobre páginas
A OCRDocumentEx deixa o relatório da última página tentada por ela; o valor de retorno inteiro dela fornece o número de páginas processadas
errorCode reflete a LastErrorCode; leia os diagnósticos logo depois da chamada de OCR, porque outras chamadas de API podem mudar o código do último erro da biblioteca
O ponteiro wide da DLL segue o tempo de vida do buffer de retorno wide da instância; a variante A retorna UTF-8 e segue o tempo de vida do buffer de retorno ANSI correspondente
Veja também
OCRPageEx, OCRDocumentEx, ConfigureTesseractOCR, LastOCRError