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

​
構文

​
C++

HRESULT Preprocess(
  IPagePreprocessingParams* PreprocessingParams,
  IObjectsExtractionParams* ExtractionParams,
  IRecognizerParams*        RecognizerParams
);

​
C#

void Preprocess(
  IPagePreprocessingParams PreprocessingParams,
  IObjectsExtractionParams ExtractionParams,
  IRecognizerParams        RecognizerParams
);

​
Visual Basic .NET

Sub Preprocess( _
  [PreprocessingParams As IPagePreprocessingParams = Nothing], _
  [ExtractionParams As IObjectsExtractionParams = Nothing], _
  [RecognizerParams As IRecognizerParams = Nothing] _
)

​
Parameters

PreprocessingParams [in] 前処理のパラメータを格納する PagePreprocessingParams オブジェクトを参照します。このパラメータには 0 を指定できます。0 を指定した場合、ページはデフォルトのパラメータで前処理されます。プロファイルが読み込まれている場合は、そのプロファイルで設定されたパラメータが使用されます。 ExtractionParams [in] オブジェクト抽出のパラメータを格納する ObjectsExtractionParams オブジェクトを参照します。このパラメータには 0 を指定できます。0 を指定した場合、オブジェクトはデフォルトのパラメータで抽出されます。プロファイルが読み込まれている場合は、そのプロファイルで設定されたパラメータが使用されます。 RecognizerParams [in] 前処理に必要な認識パラメータ (認識言語など) を格納する RecognizerParams オブジェクトを参照します。このパラメータには 0 を指定できます。0 を指定した場合、デフォルトのパラメータが使用されます。プロファイルが読み込まれている場合は、そのプロファイルで設定されたパラメータが使用されます。

​
戻り値

ページの前処理がユーザーによって中断された場合、このメソッドはE_ABORTを返します。また、ABBYY FineReader Engine関数の標準リターンコードも返します。

​
備考

  • このメソッドは、FRDocument オブジェクトの IConnectionPointContainer インターフェイスにアタッチされたリスナーにイベントを報告することがあります。
  • Linux および Windows の場合: IEngine::MultiProcessingParams プロパティの値に応じて、ABBYY FineReader Engine は複数ページのドキュメントの前処理を CPU コアに分散して実行できます。

​
関連項目

FRDocument 前処理、解析、認識、および合成のパラメーターの調整 プロファイルの操作