Zum Hauptinhalt springen
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 „verbindbares 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 theobject.

,read-only

Provides access to theblack-and-whiteimage plane of the current ImageDocument object.

,read-only

Provides access to thecolorimage plane of the current ImageDocument object.

,read-only

Provides access to thegrayimage 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 theSaveTomethod the value of this property is not changed. You need to re-load the image document by the call to theLoadImageDocmethod.

, 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 derSaveTo-Methode wird der Wert dieser Eigenschaft nicht aktualisiert. Das Bilddokument muss durch einen Aufruf derLoadImageDoc-Methode neu geladen werden.

,read-only

Returns theobject 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 themethod.

, 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 themethod 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 Methodekorrigiert 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

NameBeschreibung
ApplySigmaFilterDiese Methode wendet einen Filter zur Rauschreduzierung auf das Bild an. Sie ist vor allem für Fotos nützlich.
ChangeResolutionÄndert die Bildauflösung.
CorrectShadowsAndHighlightsKorrigiert übermäßige Schatten und Spitzlichter im Bild.
CorrectSkewKorrigiert die Schieflage des Bildes.
CropImageErmittelt die Ränder eines Dokuments im Bild und schneidet es anschließend zu.
DitherImageWendet auf das Bild entweder den Floyd–Steinberg- oder den Bayer-Algorithmus (geordnetes Dithering) an.
EnhanceLocalContrastErhöht den lokalen Kontrast des Bildes.
EqualizeBrightnessGleicht die Bildhelligkeit aus. Diese Methode kann nur für Graustufen- und Farbbilder verwendet werden.
FindBlackSquaresFindet schwarze Quadrate auf dem Bild.
GetPreviewImageErmö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.
GetPreviewImageSpecificSizeErmö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.
GetTextBackgroundColorErkennt die Farben von Text und Hintergrund im angegebenen Rectangle auf dem Bild.
ModifyErmöglicht das Bearbeiten des Bildes. Diese Methode bietet im Vergleich zur Methode Transform erweiterte Bearbeitungsfunktionen.
RemoveColorObjectsEntfernt angegebene Farbobjekte aus dem gesamten Bild oder aus Teilen davon. Diese Methode kann nur für Farbbilder verwendet werden.
RemoveColorObjectsExEntfernt 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.
RemoveGarbageEntfernt Bildstörungen (zusätzliche Punkte, die eine bestimmte Größe unterschreiten) aus dem Bild.
RemoveGeometricalDistortionsEntfernt geometrische Verzerrungen im Bild (z. B. gekrümmte Linien nahe dem Rand einer Seite).
RemoveMotionBlurEntfernt Bewegungsunschärfe im Bild.
RemoveNoiseReduziert das Rauschen im Bild.
SaveImageRegionToSpeichert Teile des Bildes in einem Ordner auf dem Datenträger. Das gespeicherte Bild liegt im internen Format von ABBYY FineReader Engine vor.
SaveModifiedSpeichert alle am aktuellen ImageDocument-Objekt vorgenommenen Änderungen in dem Ordner auf dem Datenträger.
SaveToSpeichert den Inhalt des ImageDocument-Objekts in einem Ordner auf dem Datenträger. Das Bild wird im internen Format von ABBYY FineReader Engine gespeichert.
SaveToFileSpeichert den Inhalt des ImageDocument-Objekts in einer Datei.
SaveToMemory <Note> Nur unter Windows. </Note>Speichert den Inhalt des ImageDocument-Objekts im globalen Speicher.
SmoothImageGlättet das Bild. Diese Methode kann nur für Graustufen- und Farbbilder verwendet werden.
SmoothTextureGlä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.
TransformWendet einen begrenzten Satz von Transformationen auf das Bild an.
ImageDocument 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:

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