> ## 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-Objekt (IPagePreprocessingParams-Schnittstelle)

> PagePreprocessingParams-Objekt (IPagePreprocessingParams-Schnittstelle) in der ABBYY FineReader Engine API — Dient zum Anpassen von Parametern der Seiten-Vorverarbeitung (Orientierung, Invertierung, Entfernung geometrischer Verzerrungen); Unterobjekt von PageProcessingParams; persistentes Objekt, das in einer Datei oder im Speicher gespeichert werden kann.

Dieses Objekt dient zum Anpassen verschiedener Parameter der Seitenvorverarbeitung. Die Seitenvorverarbeitung wird vor der Seitenanalyse durchgeführt. Diese Phase umfasst die Korrektur der Seitenausrichtung, die Bildinversion und die Beseitigung geometrischer Verzerrungen. Ein Zeiger auf dieses Objekt wird als Member des Objekts [PageProcessingParams](/de/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams) an Verarbeitungsmethoden übergeben.

Das PagePreprocessingParams-Objekt ist ein persistentes Objekt. Das bedeutet, dass der aktuelle Zustand des Objekts in einem persistenten Speicher abgelegt werden kann. Später kann das Objekt neu erstellt werden, indem sein Zustand aus dem persistenten Speicher gelesen wird. Die folgenden Methoden ermöglichen die Persistenz des Objekts:

Linux: [SaveToFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) und [LoadFromFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows: [SaveToFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) und [LoadFromMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).

<div id="properties">
  ## Eigenschaften
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Name</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Type</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Description</strong>
        </p>
      </th>
    </tr>
  </thead>

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

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

          ,{" "}

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

      <td>
        <p>
          Returns the{" "}

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

            {" "}
          </strong>

          object.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Specifies if image background should be whitened.</p>

        <p>
          This property is TSPV\_Auto by default. In default mode, ABBYY
          FineReader Engine whitens the background.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Specifies whether geometrical distortions (perspective on photos,
          curved lines from scanned books, etc.) should be removed during page
          preprocessing.
        </p>

        <p>
          This property is TSPV\_Auto by default. In default mode, ABBYY
          FineReader Engine corrects geometry for photographs.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Specifies if inverted image should be corrected.</p>

        <p>
          This property is TSPV\_Auto by default. In default mode, ABBYY
          FineReader Engine corrects inverted images.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Specifies how image orientation should be corrected during
          preprocessing.
        </p>

        <p>
          The default value is COM\_Auto, which means orientation will be
          determined and corrected automatically if needed.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          If this property is set to CSM\_Auto or CSM\_Fast, image skew
          will be corrected during page preprocessing.
        </p>

        <Note>
          Skew can be corrected only for angles not greater than 20 degrees.
        </Note>

        <p>
          By default, this property is set to CSM\_Auto, which means precise
          skew correction.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          If this property is set to TSPV\_Yes, during preprocessing ABBYY
          FineReader Engine will detect document edges on the image and crop the
          image accordingly.
        </p>

        <Note>This feature is not supported for black-and-white images.</Note>

        <p>
          The default value of this property is TSPV\_Auto. In the default
          mode, ABBYY FineReader Engine crops the image or skips this step
          automatically, depending on the source of the processed image.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Gibt an, wie der Bildtyp bestimmt wird. Wird in Verbindung mit
          ImageSourceType verwendet.
        </p>

        <p>
          Standard: TSPV\_Auto (nur wirksam, wenn{" "}

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

          ).
        </p>

        <ul>
          <li>
            Wenn{" "}

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

            {" "}

            \= IST\_Auto:
          </li>
        </ul>

        <ul>
          <ul>
            <li>
              TSPV\_Auto/TSPV\_Yes — die Engine erkennt den Bildtyp
              automatisch.
            </li>
          </ul>
        </ul>

        <ul>
          <ul>
            <li>
              TSPV\_No — die Engine erkennt den Typ nicht; stattdessen liest sie den Bildtyp
              aus den Eigenschaften/Metadaten der Datei (schneller, aber abhängig von
              korrekten Metadaten).
            </li>
          </ul>
        </ul>

        <ul>
          <li>
            Wenn{" "}

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

            {" "}

            explizit auf IST\_Photo, IST\_Scan,
            IST\_Screenshot, IST\_SyntheticImage oder
            IST\_SyntheticText, wird keine Erkennung durchgeführt (wird als
            TSPV\_No behandelt) und die Engine liest den Bildtyp aus
            Eigenschaften/Metadaten.
          </li>
        </ul>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Wenn diese Eigenschaft auf TRUE gesetzt ist, weist sie ABBYY FineReader Engine an, im aufbereiteten Bild nur die{" "}

          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white">
            Schwarzweiß-
          </a>

          {" "}

          Ebene beizubehalten. In diesem Fall wird die Bildbinarisierung während der Bildvorverarbeitung durchgeführt.
        </p>

        <p>Standardmäßig ist diese Eigenschaft auf FALSE gesetzt.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Wenn diese Eigenschaft auf ORM\_Auto gesetzt ist, erkennt und überschreibt ABBYY FineReader Engine
          die Bildauflösung automatisch.
        </p>

        <p>
          Wenn sie auf ORM\_Manual gesetzt ist, verwenden Sie die Eigenschaft{" "}

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

          {" "}

          , um die neue Bildauflösung anzugeben.
        </p>

        <p>
          Die neue Auflösung wird vor allen anderen Schritten der Bildaufbereitung
          angewendet (z. B. Binarisierung, Schieflagekorrektur usw.).
        </p>

        <p>Hinweise:</p>

        <ul>
          <li>
            Wenn Sie diese Eigenschaft auf ORM\_No setzen und die Auflösung des
            aufbereiteten Bildes zu niedrig (weniger als 50 dpi), zu hoch (mehr als
            3200 dpi) oder undefiniert ist, wird das Bild nicht geöffnet und ein Fehler tritt auf.
          </li>

          <li>
            Wenn Sie eine PDF-Datei öffnen, wird die neue Auflösung für die
            Bildrasterisierung verwendet; die Bildgröße in Pixeln kann entsprechend
            der erkannten Auflösung und den Seitenabmessungen angepasst werden.
          </li>
        </ul>

        <p>Der Standardwert der Eigenschaft ist ORM\_Auto.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Dieser Wert wird verwendet, um die Auflösung des vorverarbeiteten Bildes
          zu überschreiben, wenn die <strong>OverwriteResolutionMode</strong>-Eigenschaft auf
          ORM\_Manual gesetzt ist.
        </p>

        <p>
          Beachten Sie, dass der Standardwert dieser Eigenschaft 0 ist, sodass Sie den
          gewünschten Wert selbst festlegen müssen. Wenn Sie{" "}
          <strong>OverwriteResolutionMode</strong> auf ORM\_Manual setzen und
          den Wert für diese Eigenschaft nicht festlegen, tritt ein Fehler auf.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Gibt die Parameter für die Seitenaufteilung an.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Gibt an, wie Linien begradigt werden.</p>

        <p>
          Diese Eigenschaft ist standardmäßig SLM\_Auto. In diesem Fall wird ein neuer
          Algorithmus auf Basis neuronaler Netze verwendet.
        </p>
      </td>
    </tr>

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

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

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

      <td>
        <p>
          Wenn diese Eigenschaft TRUE ist, verwendet ABBYY FineReader Engine Algorithmen
          für eine schnelle Bildbinarisierung. Die Binarisierung wird entweder während
          der Vorverarbeitung durchgeführt (wenn <strong>DiscardColorImage</strong> TRUE ist) oder
          zu einem späteren Zeitpunkt, wenn ein Schwarzweißbild erforderlich ist (z. B. wenn Sie die Eigenschaft{" "}

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

          {" "}

          für ein geöffnetes Bilddokument zum ersten Mal aufrufen). Das Setzen dieser Eigenschaft
          auf TRUE beschleunigt die Binarisierung, kann jedoch deren Qualität beeinträchtigen.
        </p>

        <p>Der Standardwert dieser Eigenschaft ist FALSE.</p>
      </td>
    </tr>

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

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

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

      <td>
        <p>Gibt an, wie die Auflösung erkannt wird</p>

        <p>
          Diese Eigenschaft ist standardmäßig RDM\_Auto. In diesem Fall wird ein neuer
          Algorithmus auf Basis neuronaler Netze verwendet.
        </p>
      </td>
    </tr>

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

      <td>
        <br />
      </td>

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

<div id="methods">
  ## Methoden
</div>

| Name                                                                                                                                                          | Beschreibung                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| [CopyFrom](/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                                      | Initialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts. |
| [LoadFromFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                                    | Stellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.                                            |
| [LoadFromMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **Hinweis:** *Nur unter Windows.* | Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her.                                                      |
| [SaveToFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                                        | Speichert den Inhalt des Objekts in einer Datei auf dem Datenträger.                                                     |
| [SaveToMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **Hinweis:** *Nur unter Windows.*     | Speichert den Inhalt des Objekts im globalen Speicher.                                                                   |

<div id="related-objects">
  ## Verwandte Objekte
</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" />[](/de/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams#pagepreprocessingparams)[](/de/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/pageprocessingparams)

[Objektdiagramm](/de/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## Ausgabeparameter
</div>

Dieses Objekt ist der Ausgabeparameter der Methode [CreatePagePreprocessingParams](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) des Objekts [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface).

<div id="input-parameter">
  ## Eingabeparameter
</div>

Dieses Objekt wird als Eingabeparameter an die folgenden Methoden übergeben:

* die Methoden [Preprocess](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/preprocess-method) und [PreprocessPages](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/preprocesspages-method) des Objekts [FRDocument](/de/fine-reader/engine/api-reference/document-related-objects/frdocument)
* die Methode [Preprocess](/de/fine-reader/engine/api-reference/document-related-objects/frpage/preprocess-method) des Objekts [FRPage](/de/fine-reader/engine/api-reference/document-related-objects/frpage)

<div id="samples">
  ## Beispiele
</div>

Das Objekt wird in den folgenden Codebeispielen verwendet:

* Linux: [CommandLineInterface](/de/fine-reader/engine/guided-tour/samples#commandlineinterface)
* Windows: [CommandLineInterface](/de/fine-reader/engine/guided-tour/samples#commandlineinterface); sowie Demotools: [Classification](/de/fine-reader/engine/guided-tour/samples#classification).

<div id="see-also">
  ## Siehe auch
</div>

[Parameter zur Feinabstimmung der Vorverarbeitung, Analyse, Erkennung und Synthese](/de/fine-reader/engine/guided-tour/advanced-techniques/tuning-parameters-of-preprocessing-analysis-recognition-and-synthesis)

[Arbeiten mit Eigenschaften](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)