PrepareImageMode-Objekt (IPrepareImageMode-Schnittstelle)

PrepareImageMode-Objekt (IPrepareImageMode-Schnittstelle) in der ABBYY FineReader Engine API — Attribute, die steuern, wie ein Bild bei der Konvertierung in das interne Format vorbereitet wird (zuerst Drehung, dann Spiegelung); persistentes Objekt, das in Datei/Speicher gespeichert werden kann.

Dieses Objekt enthält verschiedene Attribute, die festlegen, wie ein Bild bei der Konvertierung in das interne Format vorbereitet wird. Alle Eigenschaften eines neu erstellten Objekts dieses Typs sind auf sinnvolle Standardwerte gesetzt. Den Standardwert einer bestimmten Eigenschaft finden Sie in ihrer Beschreibung. Die Reihenfolge der Transformationen für das vorbereitete Bild ist wie folgt: Zuerst wird die Drehung ausgeführt, anschließend wird das Bild gespiegelt.

Das PrepareImageMode-Objekt ist ein persistentes Objekt. Das bedeutet, dass der aktuelle Zustand des Objekts in persistentem Speicher gespeichert 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

Name	Typ	Beschreibung
Application	Engine, nur lesbar	Gibt das Engine-Objekt zurück.
CompressImageMode	CompressImageModeEnum	Gibt an, ob das Bild bei der Konvertierung in das interne Format komprimiert werden soll. Gilt nur für Farb- und Graustufenbilder; Schwarzweißbilder werden immer verlustfrei komprimiert. Standardmäßig ist diese Eigenschaft auf CIM_Auto gesetzt. Das bedeutet derzeit, dass digital erzeugte Bilder (z. B. aus PDF-Dateien) verlustfrei verarbeitet werden, während für andere Bilder die maximale Komprimierung verwendet wird.
DocumentType	DocumentTypeEnum	Gibt den Dokumenttyp des Bildes an. Wenn Sie den Dokumenttyp sicher kennen, können Sie diese Eigenschaft festlegen, um den Dokumentklassifikator zu umgehen und Zeit zu sparen. Standardmäßig ist diese Eigenschaft DT_Auto, was bedeutet, dass FineReader Engine den Dokumentklassifikator ausführt, um den Dokumenttyp zu bestimmen.
ImageSourceType	ImageSourceTypeEnum	Gibt die Herkunft des Bildes an. Beispielsweise erfordern ein Foto und ein Screenshot mit etwas Text unterschiedliche Vorverarbeitungstechniken. Standardmäßig ist diese Eigenschaft IST_Auto, was bedeutet, dass FineReader Engine die Bildherkunft automatisch erkennt.
OfficeConversionSettings	OfficeConversionSettings, nur lesbar	Ermöglicht den Zugriff auf die Einstellungen zum Import digitaler Dokumente mit denselben Methoden, mit denen auch Bilder geöffnet werden. Nur Linux und Windows.
EnforceOwnerRestrictions	VARIANT_BOOL	Gibt an, ob die in einem PDF-Dokument festgelegten Eigentümerbeschränkungen (Berechtigungen) durchgesetzt werden. PDF-Dokumente können Berechtigungs-Flags enthalten, die bestimmte Vorgänge einschränken, ohne dass zum Öffnen der Datei ein Kennwort erforderlich ist. Wenn diese Eigenschaft auf TRUE gesetzt ist (Standard), setzt die Engine diese Beschränkungen durch und gibt einen Fehler zurück, wenn sie vorhanden sind. Wenn sie auf FALSE gesetzt ist, werden die Beschränkungen ignoriert und das Dokument wird normal verarbeitet. Setzen Sie diese Eigenschaft nur dann auf FALSE, wenn Ihre Anwendung bereits zur Verarbeitung der übermittelten Dateien berechtigt ist.
RasterizeFreeText	VARIANT_BOOL	Gibt an, ob Freitextanmerkungen im Eingabe-PDF-Dokument beibehalten werden sollen. Standardmäßig ist diese Eigenschaft auf TRUE gesetzt. Nur Linux und Windows. Stellen Sie unter Linux vor der Verwendung dieser Eigenschaft sicher, dass die Schriftart Arial oder Liberation Sans auf Ihrer Workstation verfügbar ist.

​

Methoden

Name	Beschreibung
CopyFrom	Initialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts.
LoadFromFile	Stellt den Objektinhalt aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory	Stellt den Objektinhalt aus dem globalen Speicher wieder her. Nur unter Windows.
SaveToFile	Speichert den Objektinhalt in einer Datei auf dem Datenträger.
SaveToMemory	Speichert den Objektinhalt im globalen Speicher. Nur unter Windows.

​

Verwandte Objekte

​

Linux und Windows

Objektdiagramm

​

Ausgabeparameter

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

​

Eingabeparameter

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

• die Methoden AddImageFile, AddImageFileFromAttachment, AddImageFileWithPassword, AddImageFileWithPasswordCallback und AddImageFileFromMemory des Objekts FRDocument
• die Methoden CreateFRDocumentFromImage, PrepareBitmapBits, OpenImageFileFromMemory, OpenBitmapBits, OpenBitmap, OpenDib, PrepareBitmap, PrepareDib und InjectTextLayer des Objekts Engine
• die Methode Start des Objekts BatchProcessor unter Linux und Windows

​

Beispiele

Das Objekt wird in den folgenden Codebeispielen verwendet:

• Linux: CommandLineInterface
• Windows: CommandLineInterface; und Demo Tools: Vordefinierte Verarbeitungsprofile der Engine

​

Siehe auch

Arbeiten mit Bildern

Arbeiten mit Eigenschaften