Methode Modify des ImageDocument-Objekts

Methode Modify des ImageDocument-Objekts in der ABBYY FineReader Engine API — Wendet alle Änderungen an, die durch ein Objekt vom Typ ImageModification definiert sind (Zuschneiden, Zeichnen, Invertieren, Ersetzen von Pixeln, Entfernen von Bildstörungen, Strecken).

Diese Methode ändert das aktuelle ImageDocument. Alle Änderungen, die im Objekt ImageModification definiert sind, können vorgenommen werden.

Gehen Sie wie folgt vor, um Änderungen vorzunehmen:

1. Erstellen Sie mithilfe der Methode CreateImageModification des Engine-Objekts ein Objekt vom Typ ImageModification.
2. Geben Sie die erforderlichen Parameter an.
3. Rufen Sie die Methode Modify mit diesem Objekt als Eingabeparameter auf. Die eigentliche Änderung erfolgt erst, wenn Sie diese Methode aufrufen.
4. Speichern Sie die Änderungen mit der Methode IImageDocument::SaveModified.

Änderungen am Bild werden erst gespeichert, wenn die Methode IImageDocument::SaveModified aufgerufen wird. Wenn das Objekt ImageDocument freigegeben wird, bevor diese Methode aufgerufen wird, werden die Änderungen nicht gespeichert.

Vor dem Aufruf dieser Methode müssen alle Blöcke aus dem Seitenlayout entfernt werden. Rufen Sie die Methode ILayoutBlocks::DeleteAll für die Sammlungen ILayout::Blocks, ILayout::BlackSeparators und ILayout::VisualBlocks (Win) des entsprechenden Layouts auf.

​

Syntax

​

C++

HRESULT Modify( IImageModification* Modification );

​

C#

void Modify( IImageModification Modification );

​

Visual Basic .NET

Sub Modify(Modification As IImageModification)

​

Parameter

Modification

[in] Diese Variable vom Typ ImageModification legt fest, welche Transformationen auf das Objekt ImageDocument angewendet werden.

​

Rückgabewerte

Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die Standardrückgabewerte von ABBYY FineReader Engine-Funktionen zurück.

​

Hinweise

Alle Informationen über das ursprüngliche Bild gehen nach dem Aufruf der Methode verloren.

Diese Methode wendet Änderungen auf die Schwarzweiß-, Graustufen- und Farb-Bildebenen des ImageDocument an. Alle anderen Seiten werden aus dem ImageDocument gelöscht. Sie werden bei Bedarf erstellt.

​

Siehe auch

ImageModification