メインコンテンツへスキップ
このオブジェクトは、ページの前処理に関するさまざまなパラメーターを調整するために使用します。ページの前処理は、ページ解析の前に実行されます。この段階では、ページの向きの補正、画像の反転、幾何学的なゆがみの除去が行われます。このオブジェクトへのポインターは、PageProcessingParams オブジェクトのメンバーとして処理メソッドに渡されます。 PagePreprocessingParams オブジェクトは永続オブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み込むことで、オブジェクトを再作成できます。次のメソッドを使用すると、オブジェクトを永続化できます。 Linux: SaveToFile および LoadFromFile Windows: SaveToFileLoadFromFileSaveToMemory、および LoadFromMemory

プロパティ

,read-only

オブジェクトを返します。

画像の背景を白くするかどうかを指定します。

このプロパティのデフォルト値は TSPV_Auto です。デフォルトモードでは、ABBYY FineReader Engine が背景を白くします。

ページの前処理中に、幾何学的な歪み (写真のパースペクティブ、スキャンした書籍の曲線など) を除去するかどうかを指定します。

このプロパティのデフォルト値は TSPV_Auto です。デフォルトモードでは、ABBYY FineReader Engine が写真の幾何学的歪みを補正します。

反転した画像を補正するかどうかを指定します。

このプロパティのデフォルト値は TSPV_Auto です。デフォルトモードでは、ABBYY FineReader Engine が反転した画像を補正します。

前処理中に画像の向きをどのように補正するかを指定します。

デフォルト値は COM_Auto で、必要に応じて向きが自動的に検出・補正されます。

このプロパティが CSM_Auto または CSM_Fast に設定されている場合、ページの前処理中に画像の傾きが補正されます。

傾きの補正は、20度以下の角度にのみ対応しています。

デフォルトでは、このプロパティは CSM_Auto に設定されており、精密な傾き補正が行われます。

このプロパティが TSPV_Yes に設定されている場合、前処理中に ABBYY FineReader Engine が画像上のドキュメントの端を検出し、それに応じて画像をトリミングします。

この機能は白黒画像には対応していません。

このプロパティのデフォルト値は TSPV_Auto です。デフォルトモードでは、ABBYY FineReader Engine は処理対象画像のソースに応じて、自動的に画像をトリミングするかこのステップをスキップします。

画像の種類をどのように判定するかを指定します。ImageSourceType と連携して動作します。

デフォルト: TSPV_Auto (ImageSourceType = IST_Autoの場合のみ有効) 。

    • TSPV_Auto/TSPV_Yes — Engine が画像の種類を自動的に検出します。
    • TSPV_No — Engine は検出を行わず、ファイルのプロパティ/メタデータから画像の種類を読み取ります (高速ですが、正確なメタデータが必要です) 。
  • ImageSourceTypeが IST_Photo、IST_Scan に明示的に設定されている場合、 IST_Screenshot、IST_SyntheticImage、または IST_SyntheticText の場合、検出は実行されず (TSPV_No として扱われます) 、エンジンは プロパティ/メタデータから画像タイプを読み取ります。

このプロパティを TRUE に設定すると、ABBYY FineReader Engine は準備済み画像に白黒プレーンのみを残します。この場合、画像の二値化は画像前処理中に実行されます。

デフォルトでは、このプロパティは FALSE に設定されています。

このプロパティが ORM_Auto に設定されている場合、ABBYY FineReader Engine は 画像の解像度を自動的に検出して上書きします。

ORM_Manual に設定されている場合は、プロパティを使用して新しい画像解像度を指定してください。

新しい解像度は、画像準備の他のすべての段階 (二値化、傾き補正など) の前に適用されます。

注意:

  • このプロパティを ORM_No に設定し、準備済み画像の解像度が低すぎる (50 dpi 未満) 、高すぎる (3200 dpi 超) 、または未定義の場合、画像は開かれずエラーが発生します。
  • PDF ファイルを開く場合、新しい解像度が画像のラスタライズに使用されます。ピクセル単位の画像サイズは、検出された解像度とページの寸法に応じて変更される場合があります。

デフォルトでは、プロパティの値は ORM_Auto です。

この値は、OverwriteResolutionMode プロパティが ORM_Manual の場合に、前処理済み画像の解像度を上書きするために使用されます。

このプロパティのデフォルト値は 0 であるため、必要な値を手動で設定する必要があります。 OverwriteResolutionMode を ORM_Manual に設定し、このプロパティの値を設定しない場合、エラーが発生します。

ページ分割のパラメーターを指定します。

行の補正方法を指定します。

このプロパティはデフォルトで SLM_Auto です。この場合、新しいニューラルネットワークアルゴリズムが使用されます。

このプロパティが TRUE の場合、ABBYY FineReader Engine は高速画像二値化のアルゴリズムを使用します。二値化は、前処理中 (DiscardColorImage が TRUE の場合) 、またはその後に白黒画像が必要になったとき (例:開いている画像ドキュメントに対して初めてプロパティを呼び出す場合) に実行されます。このプロパティを TRUE に設定すると二値化が高速化されますが、品質が低下する場合があります。

デフォルトでは、このプロパティの値は FALSE です。

解像度の検出方法を指定します。

このプロパティはデフォルトで RDM_Auto です。この場合、新しいニューラルネットワークアルゴリズムが使用されます。




メソッド

名前説明
CopyFrom現在のオブジェクトのプロパティを、別のオブジェクトの対応するプロパティの値で初期化します。
LoadFromFileディスク上のファイルからオブジェクトの内容を復元します。
LoadFromMemory <Note> : Windows のみ。 </Note>グローバルメモリからオブジェクトの内容を復元します。
SaveToFileオブジェクトの内容をディスク上のファイルに保存します。
SaveToMemory <Note> : Windows のみ。 </Note>オブジェクトの内容をグローバルメモリに保存します。
PagePreprocessingParams オブジェクト図

出力パラメーター

このオブジェクトは、Engineオブジェクトの CreatePagePreprocessingParams メソッドの出力パラメーターです。

入力パラメーター

このオブジェクトは、以下のメソッドに入力パラメーターとして渡されます。

サンプル

このオブジェクトが使用されているコードサンプルは次のとおりです。

関連項目

前処理、解析、認識、合成のパラメーター調整 プロパティ の扱い