Zum Hauptinhalt springen
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 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 und LoadFromFile Windows: SaveToFile, LoadFromFile, SaveToMemory und LoadFromMemory.

Eigenschaften

,read-only

Returns theobject.

Specifies if image background should be whitened.

This property is TSPV_Auto by default. In default mode, ABBYY FineReader Engine whitens the background.

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

This property is TSPV_Auto by default. In default mode, ABBYY FineReader Engine corrects geometry for photographs.

Specifies if inverted image should be corrected.

This property is TSPV_Auto by default. In default mode, ABBYY FineReader Engine corrects inverted images.

Specifies how image orientation should be corrected during preprocessing.

The default value is COM_Auto, which means orientation will be determined and corrected automatically if needed.

If this property is set to CSM_Auto or CSM_Fast, image skew will be corrected during page preprocessing.

Skew can be corrected only for angles not greater than 20 degrees.

By default, this property is set to CSM_Auto, which means precise skew correction.

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.

This feature is not supported for black-and-white images.

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.

Gibt an, wie der Bildtyp bestimmt wird. Wird in Verbindung mit ImageSourceType verwendet.

Standard: TSPV_Auto (nur wirksam, wennImageSourceType = IST_Auto).

    • TSPV_Auto/TSPV_Yes — die Engine erkennt den Bildtyp automatisch.
    • 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).
  • WennImageSourceTypeexplizit 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.

Wenn diese Eigenschaft auf TRUE gesetzt ist, weist sie ABBYY FineReader Engine an, im aufbereiteten Bild nur dieSchwarzweiß-Ebene beizubehalten. In diesem Fall wird die Bildbinarisierung während der Bildvorverarbeitung durchgeführt.

Standardmäßig ist diese Eigenschaft auf FALSE gesetzt.

Wenn diese Eigenschaft auf ORM_Auto gesetzt ist, erkennt und überschreibt ABBYY FineReader Engine die Bildauflösung automatisch.

Wenn sie auf ORM_Manual gesetzt ist, verwenden Sie die Eigenschaft, um die neue Bildauflösung anzugeben.

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

Hinweise:

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

Der Standardwert der Eigenschaft ist ORM_Auto.

Dieser Wert wird verwendet, um die Auflösung des vorverarbeiteten Bildes zu überschreiben, wenn die OverwriteResolutionMode-Eigenschaft auf ORM_Manual gesetzt ist.

Beachten Sie, dass der Standardwert dieser Eigenschaft 0 ist, sodass Sie den gewünschten Wert selbst festlegen müssen. Wenn Sie OverwriteResolutionMode auf ORM_Manual setzen und den Wert für diese Eigenschaft nicht festlegen, tritt ein Fehler auf.

Gibt die Parameter für die Seitenaufteilung an.

Gibt an, wie Linien begradigt werden.

Diese Eigenschaft ist standardmäßig SLM_Auto. In diesem Fall wird ein neuer Algorithmus auf Basis neuronaler Netze verwendet.

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 DiscardColorImage TRUE ist) oder zu einem späteren Zeitpunkt, wenn ein Schwarzweißbild erforderlich ist (z. B. wenn Sie die Eigenschaftfü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.

Der Standardwert dieser Eigenschaft ist FALSE.

Gibt an, wie die Auflösung erkannt wird

Diese Eigenschaft ist standardmäßig RDM_Auto. In diesem Fall wird ein neuer Algorithmus auf Basis neuronaler Netze verwendet.




Methoden

NameBeschreibung
CopyFromInitialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts.
LoadFromFileStellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory <Note> : Nur unter Windows. </Note>Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her.
SaveToFileSpeichert den Inhalt des Objekts in einer Datei auf dem Datenträger.
SaveToMemory <Note> : Nur unter Windows. </Note>Speichert den Inhalt des Objekts im globalen Speicher.
PagePreprocessingParams Objektdiagramm

Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der Methode CreatePagePreprocessingParams des Objekts Engine.

Eingabeparameter

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

Beispiele

Das Objekt wird in den folgenden Codebeispielen verwendet:

Siehe auch

Parameter zur Feinabstimmung der Vorverarbeitung, Analyse, Erkennung und Synthese Arbeiten mit Eigenschaften