FRDocument ObjectのPreprocessメソッド

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

​

構文

​

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

前処理、解析、認識、および合成のパラメーターの調整

プロファイルの操作