GetOCRDiagnosticsJSON
OCR, diagnostic
Description
Renvoie un JSON version 1 décrivant la dernière phase OCR et l’action sur le calque, avec les rapports du moteur actuellement attribué et détenu par l’instance lorsqu’ils sont disponibles
Syntaxe
Delphi
Function TPDFlib.GetOCRDiagnosticsJSON: WideString;
ActiveX
Function PDFlib::GetOCRDiagnosticsJSON() As String
DLL
const wchar_t* DLGetOCRDiagnosticsJSON(int InstanceID);
const char* DLGetOCRDiagnosticsJSONA(int InstanceID);
Valeurs de retour
Un objet JSON contenant version, phase, status, complete, errorCode et error, avec les comptages de pages et de mots le cas échéant
État du calque
| notStarted | Aucune opération OCR n’a démarré sur cette instance |
|---|---|
| configured | Une configuration de moteur a été acceptée ; cela ne prouve pas qu’un modèle de données entraînées peut reconnaître une page |
| skipped | La page comporte du texte existant non propriétaire ; reason vaut existingText |
| empty | Aucun mot n’a atteint le seuil ; les anciens calques OCR restent intacts |
| appended | Un nouveau calque OCR propriétaire a été ajouté |
| replaced | Au moins un ancien calque OCR propriétaire a été remplacé |
| error | L’opération a échoué ; examinez les champs d’erreur |
| cancelled | Le fournisseur a annulé l’opération en cours |
Rapports du moteur
L’objet provider optionnel contient son dernier status, complete, exitCode, error et le log du moteur
Les codes d’état du fournisseur sont : 0 succès, 1 indisponible, 2 entrée invalide, 3 sortie invalide, 4 échec, 5 délai dépassé et 6 limite de sortie
L’objet orientation optionnel inclut orientationDegrees, rotateClockwise, confidence ainsi que ses propres champs d’achèvement et d’erreur
Les codes d’état d’orientation sont : 0 succès, 1 indisponible, 2 entrée invalide, 3 sortie invalide, 4 échec, 5 délai dépassé, 6 limite de sortie et 7 confiance faible
Vérifiez toujours le drapeau d’achèvement : un moteur nouvellement configuré n’a pas achevé de reconnaissance, même si son état numérique par défaut vaut zéro
Remarques
Le rapport ne réexécute pas l’OCR et ne change pas la page sélectionnée
Les rapports du moteur configuré décrivent sa dernière exécution, si bien qu’une page ignorée plus tard peut conserver le rapport moteur antérieur ; l’action de page au niveau supérieur identifie la dernière décision prise pour une page
OCRDocumentEx laisse le rapport de sa dernière page tentée ; sa valeur de retour entière fournit le nombre de pages traitées
errorCode reflète LastErrorCode ; lisez les diagnostics immédiatement après l’appel OCR, car d’autres appels API peuvent modifier le dernier code d’erreur de la bibliothèque
Le pointeur large de la DLL suit la durée de vie du tampon de retour large de l’instance ; la variante A renvoie de l’UTF-8 et suit la durée de vie du tampon de retour ANSI correspondant
Voir aussi
OCRPageEx, OCRDocumentEx, ConfigureTesseractOCR, LastOCRError