GetOCRDiagnosticsJSON
OCR、診断
説明
最新の OCR フェーズとレイヤー操作を表すバージョン 1 の JSON を返します。利用可能な場合は、現在割り当てられているインスタンス所有エンジンのレポートも含まれます
構文
Delphi
Function TPDFlib.GetOCRDiagnosticsJSON: WideString;ActiveX
Function PDFlib::GetOCRDiagnosticsJSON() As StringDLL
const wchar_t* DLGetOCRDiagnosticsJSON(int InstanceID);
const char* DLGetOCRDiagnosticsJSONA(int InstanceID);戻り値
version、phase、status、complete、errorCode、error を含む JSON オブジェクトを返します。該当する場合はページ数と単語数も含まれます
レイヤーステータス
| notStarted | このインスタンスでは OCR 操作がまだ開始されていません |
|---|---|
| configured | エンジン構成は受け付けられました。ただし、学習済みデータのモデルがページを認識できることは保証されません |
| skipped | ページに所有権のない既存テキストがあります。reason は existingText です |
| empty | しきい値を満たす単語がありません。既存の OCR レイヤーはそのまま維持されます |
| appended | 新しい所有 OCR レイヤーが追加されました |
| replaced | 少なくとも 1 つの所有済み旧 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 が信頼度不足です
必ず完了フラグを確認してください。新しく構成したエンジンは、既定の数値ステータスが 0 でも認識は完了していません
備考
レポートは OCR を再実行せず、選択されたページも切り替えません
構成済みエンジンのレポートは最新の実行結果を表すため、後でページがスキップされた場合でも前回のエンジンレポートが残ることがあります。最新のページ判定は、トップレベルのページ操作で識別してください
OCRDocumentEx は最後に試行したページのレポートを残します。処理したページ数は整数の戻り値で分かります
errorCode は LastErrorCode を反映します。他の API 呼び出しでもライブラリの最終エラーコードは変わるため、診断は OCR 呼び出しの直後に読み取ってください
DLL のワイドポインターは、そのインスタンスのワイド戻りバッファーの寿命に従います。A 系は UTF-8 を返し、対応する ANSI 戻りバッファーの寿命に従います