> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Engine オブジェクトの CleanRecognizerSession メソッド

> ABBYY FineReader Engine API の Engine オブジェクトの CleanRecognizerSession メソッド。このメソッドは現在の認識セッションをクリアし、ページ処理中に蓄積されたチューニング情報を削除します。

このメソッドは、現在の認識セッションをクリアします。ドキュメントの処理時、FineReader Engine は現在のドキュメントタイプの認識に合わせて自動調整を行います (明るさ、テキストの種類、フォントなど) 。この情報は 1 回の認識セッション中に使用され、認識品質の向上に役立ちます。CleanRecognizerSession メソッドを呼び出すと、この自動調整によって取得されたすべての情報が削除されます。

既定では、FineReader Engine は各ページの認識後に認識セッションをクリアします ([IEngine::AutoCleanRecognizerSession](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/properties#autocleanrecognizersession) プロパティは TRUE) 。そのため、ほとんどの場合、CleanRecognizerSession メソッドを手動で呼び出す必要はありません。

以下のような場合には、このメソッドを呼び出す必要があります。

* ページ間で認識セッションを保持する必要がある場合。たとえば、[cache dictionary](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries#cache_dictionary) を使用する場合です。この場合は、AutoCleanRecognizerSession プロパティを FALSE に設定し、必要に応じて CleanRecognizerSession メソッドを呼び出して認識セッションを手動でクリアする必要があります (cache dictionary が不要になった場合、または前のページと比べてパラメーター (明るさ、テキストの種類、フォントなど) が大きく異なるページを処理する場合) 。
* 1 ページの認識中に認識セッションをクリアする必要がある場合。たとえば、そのページに、他のテキストブロックと比べてパラメーター (テキストの種類、フォントなど) が大きく異なるテキストブロックが含まれている場合です。

[AutoCleanRecognizerSession](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/properties#autocleanrecognizersession) プロパティが FALSE の場合でも、FineReader Engine は次の場合に認識セッションを自動的にクリアします。

Windows および Linux

* ページが 1 つのプロセス内で順次認識され、処理対象のページがなくなった場合 (たとえば、[IFRDocument::Close](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/close-method) メソッドが呼び出された場合、またはドキュメントが解放され、ほかにドキュメントがない場合) 。
* 処理対象のページがなくなった場合 (たとえば、[IFRDocument::Close](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/close-method) メソッドが呼び出された場合、またはドキュメントが解放され、ほかにドキュメントがない場合) 。
* ページが並列プロセスで認識される場合 — 各並列プロセスの終了後。
* ページが BatchProcessor を使用する並列プロセスで認識され、処理対象のページがなくなった場合 ([IBatchProcessor::GetNextProcessedPage](/ja/fine-reader/engine/api-reference/batch-processor/batchprocessor/getnextprocessedpage-method) が 0 を返す場合) 。
* Engine オブジェクトの [LoadPredefinedProfile](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/supplementary-methods/loadpredefinedprofile-method) メソッドまたは [LoadProfile](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/supplementary-methods/loadprofile-method) メソッドが呼び出された場合。

macOS

* 処理対象のページがなくなった場合 (たとえば、[IFRDocument::Close](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/close-method) メソッドが呼び出された場合、またはドキュメントが解放され、ほかにドキュメントがない場合) 。

* Engine オブジェクトの [LoadPredefinedProfile](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/supplementary-methods/loadpredefinedprofile-method) メソッドまたは [LoadProfile](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/supplementary-methods/loadprofile-method) メソッドが呼び出された場合。

<div id="syntax">
  ## 構文
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT CleanRecognizerSession();
```

### C\#

```csharp theme={null}
void CleanRecognizerSession();
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub CleanRecognizerSession()
```

<div id="return-values">
  ## 戻り値
</div>

このメソッドに固有の戻り値はありません。[ABBYY FineReader Engine 関数の標準の戻り値](/ja/fine-reader/engine/api-reference/return-codes)を返します。

<div id="remarks">
  ## 備考
</div>

このメソッドを呼び出すと、[cache dictionary](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries#cache_dictionary) は自動的にクリアされます。

<div id="see-also">
  ## 関連項目
</div>

[Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface)