> ## 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.

# FRDocument ObjectのPreprocessメソッド

> ABBYY FineReader Engine API における FRDocument Object の Preprocessメソッド — すべてのページを前処理します。ページの向きを補正し、反転や幾何学的歪みを修正して、必要に応じてページ分割を実行します。レイアウト解析の前に実行してください。

このメソッドは、ドキュメント内のすべてのページに対して前処理を実行します。具体的には、ページの向きの補正、反転の修正、幾何学的歪みの補正を行い、必要に応じてページ分割も実施します。前処理はレイアウト解析の前に実行されます。

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

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

```cpp theme={null}
HRESULT Preprocess(
  IPagePreprocessingParams* PreprocessingParams,
  IObjectsExtractionParams* ExtractionParams,
  IRecognizerParams*        RecognizerParams
);
```

### C\#

```csharp theme={null}
void Preprocess(
  IPagePreprocessingParams PreprocessingParams,
  IObjectsExtractionParams ExtractionParams,
  IRecognizerParams        RecognizerParams
);
```

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

```vb theme={null}
Sub Preprocess( _
  [PreprocessingParams As IPagePreprocessingParams = Nothing], _
  [ExtractionParams As IObjectsExtractionParams = Nothing], _
  [RecognizerParams As IRecognizerParams = Nothing] _
)
```

<div id="parameters">
  ## Parameters
</div>

PreprocessingParams

\[in] 前処理のパラメータを格納する [PagePreprocessingParams](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams) オブジェクトを参照します。このパラメータには 0 を指定できます。0 を指定した場合、ページはデフォルトのパラメータで前処理されます。[プロファイル](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)が読み込まれている場合は、そのプロファイルで設定されたパラメータが使用されます。

ExtractionParams

\[in] オブジェクト抽出のパラメータを格納する [ObjectsExtractionParams](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/objectsextractionparams) オブジェクトを参照します。このパラメータには 0 を指定できます。0 を指定した場合、オブジェクトはデフォルトのパラメータで抽出されます。[プロファイル](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)が読み込まれている場合は、そのプロファイルで設定されたパラメータが使用されます。

RecognizerParams

\[in] 前処理に必要な認識パラメータ (認識言語など) を格納する [RecognizerParams](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams) オブジェクトを参照します。このパラメータには 0 を指定できます。0 を指定した場合、デフォルトのパラメータが使用されます。[プロファイル](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)が読み込まれている場合は、そのプロファイルで設定されたパラメータが使用されます。

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

ページの前処理がユーザーによって中断された場合、このメソッドはE\_ABORTを返します。また、[ABBYY FineReader Engine関数の標準リターンコード](/ja/fine-reader/engine/api-reference/return-codes)も返します。

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

* このメソッドは、[FRDocument](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument) オブジェクトの IConnectionPointContainer インターフェイスにアタッチされたリスナーにイベントを報告することがあります。
* Linux および Windows の場合: [IEngine::MultiProcessingParams](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/properties#multiprocessingparams) プロパティの値に応じて、ABBYY FineReader Engine は複数ページのドキュメントの前処理を CPU コアに分散して実行できます。

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

[FRDocument](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument)

[前処理、解析、認識、および合成のパラメーターの調整](/ja/fine-reader/engine/guided-tour/advanced-techniques/tuning-parameters-of-preprocessing-analysis-recognition-and-synthesis)

[プロファイルの操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)