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

# PagePreprocessingParams オブジェクト（IPagePreprocessingParams インターフェイス）

> ABBYY FineReader Engine API の PagePreprocessingParams オブジェクト（IPagePreprocessingParams インターフェイス）— ページ前処理（向き、反転、幾何学的ゆがみの除去）を調整します。PageProcessingParams のサブオブジェクトであり、ファイルまたはメモリに保存可能な永続オブジェクトです。

このオブジェクトは、ページの前処理に関するさまざまなパラメーターを調整するために使用します。ページの前処理は、ページ解析の前に実行されます。この段階では、ページの向きの補正、画像の反転、幾何学的なゆがみの除去が行われます。このオブジェクトへのポインターは、[PageProcessingParams](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams) オブジェクトのメンバーとして処理メソッドに渡されます。

PagePreprocessingParams オブジェクトは永続オブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み込むことで、オブジェクトを再作成できます。次のメソッドを使用すると、オブジェクトを永続化できます。

Linux: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) および [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows: [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)、[LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)、[SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)、および [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)。

<div id="properties">
  ## プロパティ
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>名前</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>型</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>説明</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <strong>Application</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/engine-object-iengine-interface">
              Engine
            </a>
          </strong>

          ,{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            read-only
          </a>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/engine-object-iengine-interface">
              Engine
            </a>

            {" "}
          </strong>

          オブジェクトを返します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="backgroundwhitening" />

          <strong>BackgroundWhitening</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/threestatepropertyvalueenum">
              ThreeStatePropertyValueEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>画像の背景を白くするかどうかを指定します。</p>

        <p>
          このプロパティのデフォルト値は TSPV\_Auto です。デフォルトモードでは、ABBYY
          FineReader Engine が背景を白くします。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="correctgeometry" />

          <strong>CorrectGeometry</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/threestatepropertyvalueenum">
              ThreeStatePropertyValueEnum
            </a>
          </strong>
        </p>
      </td>

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

        <p>
          このプロパティのデフォルト値は TSPV\_Auto です。デフォルトモードでは、ABBYY
          FineReader Engine が写真の幾何学的歪みを補正します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="correctinvertedimage" />

          <strong>CorrectInvertedImage</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/threestatepropertyvalueenum">
              ThreeStatePropertyValueEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>反転した画像を補正するかどうかを指定します。</p>

        <p>
          このプロパティのデフォルト値は TSPV\_Auto です。デフォルトモードでは、ABBYY
          FineReader Engine が反転した画像を補正します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="correctorientationmode" />

          <strong>CorrectOrientationMode</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/correctorientationmodeenum">
              CorrectOrientationModeEnum
            </a>
          </strong>
        </p>
      </td>

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

        <p>
          デフォルト値は COM\_Auto で、必要に応じて向きが自動的に検出・補正されます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="correctskew" />

          <strong>CorrectSkewMode</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/correctskewmodeenum">
              CorrectSkewModeEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティが CSM\_Auto または CSM\_Fast に設定されている場合、ページの前処理中に画像の傾きが補正されます。
        </p>

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

        <p>
          デフォルトでは、このプロパティは CSM\_Auto に設定されており、精密な傾き補正が行われます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="cropimage" />

          <strong>CropImage</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/threestatepropertyvalueenum">
              ThreeStatePropertyValueEnum
            </a>
          </strong>
        </p>
      </td>

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

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

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

    <tr>
      <td>
        <p>
          <a name="detectimagetype" />

          <strong>DetectImageType</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/threestatepropertyvalueenum">
              ThreeStatePropertyValueEnum
            </a>
          </strong>
        </p>
      </td>

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

        <p>
          デフォルト: TSPV\_Auto ({" "}

          <a href="/ja/fine-reader/engine/api-reference/image-related-objects/prepareimagemode">
            ImageSourceType = IST\_Auto
          </a>

          の場合のみ有効) 。
        </p>

        <ul>
          <li>
            {" "}

            <a href="/ja/fine-reader/engine/api-reference/enumerations/imagesourcetypeenum">
              ImageSourceType
            </a>

            {" "}

            \= IST\_Auto の場合:
          </li>
        </ul>

        <ul>
          <ul>
            <li>
              TSPV\_Auto/TSPV\_Yes — Engine が画像の種類を自動的に検出します。
            </li>
          </ul>
        </ul>

        <ul>
          <ul>
            <li>
              TSPV\_No — Engine は検出を行わず、ファイルのプロパティ/メタデータから画像の種類を読み取ります (高速ですが、正確なメタデータが必要です) 。
            </li>
          </ul>
        </ul>

        <ul>
          <li>
            {" "}

            <a href="/ja/fine-reader/engine/api-reference/enumerations/imagesourcetypeenum">
              ImageSourceType
            </a>

            {" "}

            が IST\_Photo、IST\_Scan に明示的に設定されている場合、
            IST\_Screenshot、IST\_SyntheticImage、または
            IST\_SyntheticText の場合、検出は実行されず (TSPV\_No として扱われます) 、エンジンは
            プロパティ/メタデータから画像タイプを読み取ります。
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="discardcolorimage" />

          <strong>DiscardColorImage</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティを TRUE に設定すると、ABBYY FineReader Engine は準備済み画像に{" "}

          <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white">
            白黒
          </a>

          {" "}

          プレーンのみを残します。この場合、画像の二値化は画像前処理中に実行されます。
        </p>

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

    <tr>
      <td>
        <p>
          <a name="overwriteresolutionmode" />

          <strong>OverwriteResolutionMode</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/overwriteresolutionmodeenum">
              OverwriteResolutionEnum
            </a>
          </strong>
        </p>
      </td>

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

        <p>
          ORM\_Manual に設定されている場合は、{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pagepreprocessingparams#resolutiontooverwrite">
              ResolutionToOverwrite
            </a>
          </strong>

          {" "}

          プロパティを使用して新しい画像解像度を指定してください。
        </p>

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

        <p>注意：</p>

        <ul>
          <li>
            このプロパティを ORM\_No に設定し、準備済み画像の解像度が低すぎる (50 dpi 未満) 、高すぎる (3200 dpi 超) 、または未定義の場合、画像は開かれずエラーが発生します。
          </li>

          <li>
            PDF ファイルを開く場合、新しい解像度が画像のラスタライズに使用されます。ピクセル単位の画像サイズは、検出された解像度とページの寸法に応じて変更される場合があります。
          </li>
        </ul>

        <p>デフォルトでは、プロパティの値は ORM\_Auto です。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="resolutiontooverwrite" />

          <strong>ResolutionToOverwrite</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              int
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          この値は、<strong>OverwriteResolutionMode</strong> プロパティが
          ORM\_Manual の場合に、前処理済み画像の解像度を上書きするために使用されます。
        </p>

        <p>
          このプロパティのデフォルト値は 0 であるため、必要な値を手動で設定する必要があります。{" "}
          <strong>OverwriteResolutionMode</strong> を ORM\_Manual に設定し、このプロパティの値を設定しない場合、エラーが発生します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="splittingparams" />

          <strong>SplitType</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/pagesplittypeenum">
              PageSplitTypeEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>ページ分割のパラメーターを指定します。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="straightenlinesmode" />

          <strong>StraightenLinesMode</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/straightenlinesmodeenum">
              StraightenLinesModeEnum
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>行の補正方法を指定します。</p>

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

    <tr>
      <td>
        <p>
          <a name="usefastbinarization" />

          <strong>UseFastBinarization</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          このプロパティが TRUE の場合、ABBYY FineReader Engine は高速画像二値化のアルゴリズムを使用します。二値化は、前処理中 (<strong>DiscardColorImage</strong> が TRUE の場合) 、またはその後に白黒画像が必要になったとき (例：開いている画像ドキュメントに対して初めて{" "}

          <strong>
            <a href="/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument#blackwhiteimage">
              IImageDocument::BlackWhiteImage
            </a>
          </strong>

          {" "}

          プロパティを呼び出す場合) に実行されます。このプロパティを TRUE に設定すると二値化が高速化されますが、品質が低下する場合があります。
        </p>

        <p>デフォルトでは、このプロパティの値は FALSE です。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="resolutiondetectionmode" />

          <strong>ResolutionDetectionMode</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/ja/fine-reader/engine/api-reference/enumerations/resolutiondetectionmode">
              ResolutionDetectionMode
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>解像度の検出方法を指定します。</p>

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

    <tr>
      <td>
        <br />
      </td>

      <td>
        <br />
      </td>

      <td>
        <br />
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## メソッド
</div>

| 名前                                                                                                                                               | 説明                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------- |
| [CopyFrom](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                         | 現在のオブジェクトのプロパティを、別のオブジェクトの対応するプロパティの値で初期化します。 |
| [LoadFromFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                       | ディスク上のファイルからオブジェクトの内容を復元します。                  |
| [LoadFromMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **注:** *Windows のみ。* | グローバルメモリからオブジェクトの内容を復元します。                    |
| [SaveToFile](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                           | オブジェクトの内容をディスク上のファイルに保存します。                   |
| [SaveToMemory](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **注:** *Windows のみ。*     | オブジェクトの内容をグローバルメモリに保存します。                     |

<div id="related-objects">
  ## 関連オブジェクト
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/pagepreprocessingparams.gif?s=7cbf0fd96e282b322f8996026b76398a" alt="PagePreprocessingParams" width="270" height="66" data-path="images/fine-reader/engine/pagepreprocessingparams.gif" />[](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams#pagepreprocessingparams)[](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams)

[オブジェクト図](/ja/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## 出力パラメーター
</div>

このオブジェクトは、[Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface)オブジェクトの [CreatePagePreprocessingParams](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) メソッドの出力パラメーターです。

<div id="input-parameter">
  ## 入力パラメーター
</div>

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

* [FRDocument](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument) オブジェクトの [Preprocess](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/preprocess-method) メソッド、および [PreprocessPages](/ja/fine-reader/engine/api-reference/document-related-objects/frdocument/preprocesspages-method) メソッド
* [FRPage](/ja/fine-reader/engine/api-reference/document-related-objects/frpage) オブジェクトの [Preprocess](/ja/fine-reader/engine/api-reference/document-related-objects/frpage/preprocess-method) メソッド

<div id="samples">
  ## サンプル
</div>

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

* Linux: [CommandLineInterface](/ja/fine-reader/engine/guided-tour/samples#commandlineinterface)
* Windows: [CommandLineInterface](/ja/fine-reader/engine/guided-tour/samples#commandlineinterface)、およびデモツール: [Classification](/ja/fine-reader/engine/guided-tour/samples#classification)。

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

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

[プロパティ の扱い](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)