ImageDocument-Objekt (IImageDocument-Schnittstelle)

ImageDocument-Objekt (IImageDocument-Schnittstelle) in der ABBYY FineReader Engine API — stellt ein geöffnetes Bild dar, bildet die Wurzel der vier Bildebenen (Schwarz-Weiß, Grau, Farbe, Vorschau) und stellt ein umfassendes Set an Methoden zur Bildvorverarbeitung bereit, um die Erkennungsqualität oder die visuelle Darstellung zu verbessern.

Dieses Objekt entspricht einem geöffneten Bild bzw. einem „Bilddokument“. Seine Attribute entsprechen den Attributen eines Bildes. Das ImageDocument-Objekt ist das Stammelement einer Sammlung von Image-Objekten bzw. „Bildebenen“. Jedes Bilddokument enthält 4 „Bildebenen“: Schwarz-Weiß, Grau, Farbe und Vorschau. Auf sie kann über die entsprechenden Eigenschaften zugegriffen werden.

Das Objekt enthält eine Reihe von Methoden zur Bildvorverarbeitung. Einige dieser Methoden eignen sich nur für Fotos, andere können für alle Dokumenttypen verwendet werden. Einige der Methoden verbessern die Erkennungsqualität, andere verbessern nur die visuelle Darstellung von Bildern, können jedoch die Erkennungsqualität verschlechtern. Letztere sollten nur nach der Erkennung verwendet werden. Lesen Sie die Beschreibung jeder Methode sorgfältig, um festzustellen, ob die Methode in Ihrem Szenario verwendet werden kann. Nachstehend finden Sie die Reihenfolge, in der wir die Anwendung von Bildvorverarbeitungsmethoden empfehlen (verwenden Sie nur die Methoden aus der Liste, die für Ihr Szenario geeignet sind):

• Zur Verbesserung der Erkennungsqualität:
  1. Bild zuschneiden
  2. Lokalen Kontrast verbessern
  3. Orientierung korrigieren (verwenden Sie die Methode Transform mit den erforderlichen Parametern)
  4. Bild invertieren oder spiegeln (verwenden Sie die Methode Transform mit den erforderlichen Parametern)
  5. Schieflage korrigieren
  6. Doppelseite aufteilen (verwenden Sie die Methode SplitPages des FRDocument-Objekts)
  7. Geometrische Verzerrungen entfernen
  8. Bildstörungen entfernen
  9. Rauschen entfernen
  10. Bewegungsunschärfe entfernen
  11. Farbige Objekte unterdrücken
  12. Farbige Objekte entfernen
• Zur Verbesserung des Erscheinungsbilds des Bildes:
  1. Helligkeit ausgleichen und den Hintergrund weiß machen
  2. Bildtextur glätten
  3. Bild rastern

Beachten Sie, dass alle diese Vorverarbeitungsmethoden auf ein geöffnetes Bild angewendet werden müssen. Einige Bildänderungen können bereits früher, beim Öffnen, angewendet werden. In den Beschreibungen der Objekte PrepareImageMode und PagePreprocessingParams finden Sie weitere Informationen zur Bildvorverarbeitung beim Öffnen.

Das ImageDocument-Objekt ist ein sogenanntes „verknüpfbares Objekt.“ Für Visual Basic in FRE für Windows kann es mit WithEvents deklariert werden. Für C++ (alle unterstützten Betriebssysteme) bedeutet dies, dass es die Schnittstelle IConnectionPointContainer unterstützt. Um während der Verarbeitung Benachrichtigungsereignisse zu empfangen, sollten C++-Benutzer ein Objekt erstellen, das von der Schnittstelle IImageDocumentEvents abgeleitet ist, und dann Folgendes tun:

• Unter Linux und macOS: das Objekt beim ImageDocument-Objekt anmelden, indem die globale Funktion AdviseFREngineObject aufgerufen wird.
• Unter Windows: die Verbindung zwischen dem Objekt und der im ImageDocument-Objekt implementierten Ereignisquelle mit den Standardmitteln von COM einrichten.

Unter Windows: Die Methoden des ImageDocument-Objekts melden Informationen über den Fortschritt der Seitenverarbeitung über spezielle ausgehende Schnittstellen. Diese Schnittstellen sind IImageDocumentEvents (für C++) und die dispinterface DIImageDocumentEvents (für Visual Basic). Visual-Basic-Benutzer müssen sich nicht um die Details der Implementierung von Ereignisschnittstellen kümmern, da diese Entwicklungsplattform dafür einfache Mittel bereitstellt.”

​

Eigenschaften

	, read-only	Returns the object.
	, read-only	Provides access to the black-and-white image plane of the current ImageDocument object.
	, read-only	Provides access to the color image plane of the current ImageDocument object.
	, read-only	Provides access to the gray image plane of the current ImageDocument object.
	, read-only	Stores the ID of the image document.
	, read-only	Each color plane of the image document is characterized by its own color type. This property specifies the color type for the whole image document as the maximum of the corresponding values for its color planes (black-and-white, gray, color).
	, read-only	Specifies if the image document is stored in memory only or it is also represented as a folder on disk. After the call to the SaveTo method the value of this property is not changed. You need to re-load the image document by the call to the LoadImageDoc method.
	, nur lesbar	Speichert den Pfad zum Ordner mit der internen Darstellung des Objekts auf dem Datenträger. Die Eigenschaft enthält eine leere Zeichenfolge, wenn der Wert der Eigenschaft IsInMemory TRUE ist. Nach dem Aufruf der SaveTo -Methode wird der Wert dieser Eigenschaft nicht aktualisiert. Das Bilddokument muss durch einen Aufruf der LoadImageDoc -Methode neu geladen werden.
	, read-only	Returns the object that contains information about pixel coordinates in the current modification state. This property is useful whenever you need to convert coordinates between two states during image processing.
	, read-only	Specifies if any modifications were made upon the ImageDocument object since it was loaded in memory or from the last call of the method.
	, read-only	Specifies rotation that was performed upon the image since opening.
	, read-only	This property set to TRUE specifies that the image colors were inverted since opening.
	, read-only	This property set to TRUE specifies that the image was mirrored around the vertical axis since opening.
	, read-only	This property provides information about whether the image skew was fully corrected during opening, preprocessing or the method call. The tangent of skew angle which was corrected is stored in the SkewAngle property.
	, read-only	Speichert den Tangens des Schieflage-Winkels, der für das Bild erkannt und beim Öffnen, bei der Vorverarbeitung oder beim Aufruf der Methode korrigiert wurde. Ist der Schieflage-Winkel negativ, wird das Bild im Uhrzeigersinn gedreht; ist er positiv, wird es gegen den Uhrzeigersinn gedreht. Das Bild kann um einen beliebigen Punkt gedreht werden. Die Größe des entzerrten Bildes ist stets größer als die des Originalbildes. When you perform further modifications of the image, this property value is reset to 0. Save the value of corrected skew angle, if you need it, before calling any other methods to edit the image.
	, read-only	Tells you if the ImageDocument object was created from a file which contains text. For example, PDF files can have text layer.
	, read-only	Tells you if the ImageDocument object was created from a file which is a photo.
	, nur lesbar	Enthält Informationen über das Format der Quellbilddatei des aktuellen ImageDocument-Objekts. Wenn diese Informationen nicht verfügbar sind oder das Bild von einem Scanner eingelesen wurde, ist der Wert dieser Eigenschaft IFF_UnknownFormat.
	, nur lesbar	Enthält Informationen über den Scanner, mit dem das Bild erfasst wurde. Wenn Informationen über die Quellbildparameter nicht verfügbar sind oder das Bild aus einer Datei geladen wurde, ist der Wert dieser Eigenschaft eine leere Zeichenfolge.
	, nur lesbar	Enthält Informationen über den Schwellenwert für die Scanintensität des aktuellen ImageDocument-Objekts. Wenn Informationen über die Quellbildparameter nicht verfügbar sind oder das Bild aus einer Datei geladen wurde, ist der Wert dieser Eigenschaft -1.
	, nur lesbar	Enthält Informationen über die horizontale Auflösung des Quellbilds des aktuellen ImageDocument-Objekts. Wenn Informationen über die Quellbildparameter nicht verfügbar sind, ist der Wert dieser Eigenschaft 0.
	, nur lesbar	Enthält Informationen über die vertikale Auflösung des Quellbilds des aktuellen ImageDocument-Objekts. Wenn Informationen über die Quellbildparameter nicht verfügbar sind, ist der Wert dieser Eigenschaft 0.

​

Methoden

Name	Beschreibung
ApplySigmaFilter	Diese Methode wendet einen Filter zur Rauschreduzierung auf das Bild an. Sie ist vor allem für Fotos nützlich.
ChangeResolution	Ändert die Bildauflösung.
CorrectShadowsAndHighlights	Korrigiert übermäßige Schatten und Spitzlichter im Bild.
CorrectSkew	Korrigiert die Schieflage des Bildes.
CropImage	Ermittelt die Ränder eines Dokuments im Bild und schneidet es anschließend zu.
DitherImage	Wendet auf das Bild entweder den Floyd–Steinberg- oder den Bayer-Algorithmus (geordnetes Dithering) an.
EnhanceLocalContrast	Erhöht den lokalen Kontrast des Bildes.
EqualizeBrightness	Gleicht die Bildhelligkeit aus. Diese Methode kann nur für Graustufen- und Farbbilder verwendet werden.
FindBlackSquares	Findet schwarze Quadrate auf dem Bild.
GetPreviewImage	Ermöglicht den Zugriff auf die 94 * 60 große Vorschau-Bildebene des aktuellen ImageDocument-Objekts. Wenn die Vorschau in dieser Größe noch nicht erstellt wurde, wird sie bei diesem Aufruf erstellt, was einige Zeit in Anspruch nehmen kann.
GetPreviewImageSpecificSize	Ermöglicht den Zugriff auf die Vorschau-Bildebene des aktuellen ImageDocument-Objekts und erlaubt die Angabe der Größe. Falls die Vorschau in dieser Größe noch nicht erstellt wurde, wird sie während dieses Aufrufs erstellt, was einige Zeit dauern kann.
GetTextBackgroundColor	Erkennt die Farben von Text und Hintergrund im angegebenen Rectangle auf dem Bild.
Modify	Ermöglicht das Bearbeiten des Bildes. Diese Methode bietet im Vergleich zur Methode Transform erweiterte Bearbeitungsfunktionen.
RemoveColorObjects	Entfernt angegebene Farbobjekte aus dem gesamten Bild oder aus Teilen davon. Diese Methode kann nur für Farbbilder verwendet werden.
RemoveColorObjectsEx	Entfernt alle Farbobjekte in den angegebenen Farbtönen aus dem Bild und ersetzt sie durch die angegebene Farbe. Die entfernten Objekte können in einem separaten Bild gespeichert werden.
RemoveGarbage	Entfernt Bildstörungen (zusätzliche Punkte, die eine bestimmte Größe unterschreiten) aus dem Bild.
RemoveGeometricalDistortions	Entfernt geometrische Verzerrungen im Bild (z. B. gekrümmte Linien nahe dem Rand einer Seite).
RemoveMotionBlur	Entfernt Bewegungsunschärfe im Bild.
RemoveNoise	Reduziert das Rauschen im Bild.
SaveImageRegionTo	Speichert Teile des Bildes in einem Ordner auf dem Datenträger. Das gespeicherte Bild liegt im internen Format von ABBYY FineReader Engine vor.
SaveModified	Speichert alle am aktuellen ImageDocument-Objekt vorgenommenen Änderungen in dem Ordner auf dem Datenträger.
SaveTo	Speichert den Inhalt des ImageDocument-Objekts in einem Ordner auf dem Datenträger. Das Bild wird im internen Format von ABBYY FineReader Engine gespeichert.
SaveToFile	Speichert den Inhalt des ImageDocument-Objekts in einer Datei.
SaveToMemory Hinweis: Nur unter Windows.	Speichert den Inhalt des ImageDocument-Objekts im globalen Speicher.
SmoothImage	Glättet das Bild. Diese Methode kann nur für Graustufen- und Farbbilder verwendet werden.
SmoothTexture	Glättet das Bild mit einem nichtlinearen Filter. Nützlich für Bilder mit Textur. Diese Methode kann nur für Graustufen- und Farbbilder verwendet werden, die in jeder Dimension mindestens 3 Pixel groß sind.
Transform	Wendet einen begrenzten Satz von Transformationen auf das Bild an.

​

Verwandte Objekte

Objektdiagramm

​

Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der folgenden Methoden des Engine-Objekts: LoadImageDocFromFile, LoadImageDocFromMemory (nur unter Windows), LoadImageDoc, OpenBitmap, OpenDib, OpenBitmapBits, OpenImageFileFromMemory.

​

Eingabeparameter

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

• die Methode AddImageDocument des Objekts FRDocument
• die Methode SetImageData des Objekts TrainingImage

​

Beispiele

Dieses Objekt wird in den Codebeispielen verwendet:

Linux: CommandLineInterface und BCR

macOS: Visitenkartenerkennung

Windows: CommandLineInterface; und Demo-Tools: Vordefinierte Verarbeitungsprofile der Engine

​

Siehe auch

IImageDocumentEvents

Arbeiten mit Bildern

Arbeiten mit verknüpfbaren Objekten

Arbeiten mit Eigenschaften