メインコンテンツへスキップ
このメソッドは、現在の認識セッションをクリアします。ドキュメントの処理時、FineReader Engine は現在のドキュメントタイプの認識に合わせて自動調整を行います (明るさ、テキストの種類、フォントなど) 。この情報は 1 回の認識セッション中に使用され、認識品質の向上に役立ちます。CleanRecognizerSession メソッドを呼び出すと、この自動調整によって取得されたすべての情報が削除されます。 既定では、FineReader Engine は各ページの認識後に認識セッションをクリアします (IEngine::AutoCleanRecognizerSession プロパティは TRUE) 。そのため、ほとんどの場合、CleanRecognizerSession メソッドを手動で呼び出す必要はありません。 以下のような場合には、このメソッドを呼び出す必要があります。
  • ページ間で認識セッションを保持する必要がある場合。たとえば、cache dictionary を使用する場合です。この場合は、AutoCleanRecognizerSession プロパティを FALSE に設定し、必要に応じて CleanRecognizerSession メソッドを呼び出して認識セッションを手動でクリアする必要があります (cache dictionary が不要になった場合、または前のページと比べてパラメーター (明るさ、テキストの種類、フォントなど) が大きく異なるページを処理する場合) 。
  • 1 ページの認識中に認識セッションをクリアする必要がある場合。たとえば、そのページに、他のテキストブロックと比べてパラメーター (テキストの種類、フォントなど) が大きく異なるテキストブロックが含まれている場合です。
AutoCleanRecognizerSession プロパティが FALSE の場合でも、FineReader Engine は次の場合に認識セッションを自動的にクリアします。 Windows および Linux
  • ページが 1 つのプロセス内で順次認識され、処理対象のページがなくなった場合 (たとえば、IFRDocument::Close メソッドが呼び出された場合、またはドキュメントが解放され、ほかにドキュメントがない場合) 。
  • 処理対象のページがなくなった場合 (たとえば、IFRDocument::Close メソッドが呼び出された場合、またはドキュメントが解放され、ほかにドキュメントがない場合) 。
  • ページが並列プロセスで認識される場合 — 各並列プロセスの終了後。
  • ページが BatchProcessor を使用する並列プロセスで認識され、処理対象のページがなくなった場合 (IBatchProcessor::GetNextProcessedPage が 0 を返す場合) 。
  • Engine オブジェクトの LoadPredefinedProfile メソッドまたは LoadProfile メソッドが呼び出された場合。
macOS
  • 処理対象のページがなくなった場合 (たとえば、IFRDocument::Close メソッドが呼び出された場合、またはドキュメントが解放され、ほかにドキュメントがない場合) 。
  • Engine オブジェクトの LoadPredefinedProfile メソッドまたは LoadProfile メソッドが呼び出された場合。

構文

C++

HRESULT CleanRecognizerSession();

C#

void CleanRecognizerSession();

Visual Basic .NET

Sub CleanRecognizerSession()

戻り値

このメソッドに固有の戻り値はありません。ABBYY FineReader Engine 関数の標準の戻り値を返します。

備考

このメソッドを呼び出すと、cache dictionary は自動的にクリアされます。

関連項目

Engine