> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Arbeiten mit Bildern
> Laden Sie Bilder mit CreateFRDocumentFromImage oder AddImageFile in ein FRDocument von ABBYY FineReader Engine und passen Sie PrepareImageMode für die Bildvorverarbeitung an.
ABBYY FineReader Engine verarbeitet Bilder, indem sie in ein [FRDocument](/de/fine-reader/engine/api-reference/document-related-objects/frdocument)-Objekt geladen werden, das das zu verarbeitende Dokument repräsentiert.
## Bilder öffnen
Gehen Sie folgendermaßen vor, um Bilder in das Dokument zu laden:
* Verwenden Sie die Methode [CreateFRDocumentFromImage](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createfrdocumentfromimage-method) des Objekts [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface), um ein FRDocument-Objekt zu erstellen.
* Fügen Sie Bilder aus einer Datei zu einem vorhandenen FRDocument-Objekt hinzu. Verwenden Sie dazu die Methode [AddImageFile](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefile-method), [AddImageFileFromMemory](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefrommemory-method), [AddImageFileFromStream](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilefromstream-method), [AddImageFileWithPassword](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpassword-method) oder [AddImageFileWithPasswordCallback](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagefilewithpasswordcallback-method).
Alle diese Methoden verwenden das Objekt [PrepareImageMode](/de/fine-reader/engine/api-reference/image-related-objects/prepareimagemode) als Parameter, mit dem Sie verschiedene Parameter für die Bildvorverarbeitung festlegen können. Rufen Sie die Methode [IEngine::CreatePrepareImageMode](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) auf, um dieses Objekt zu erstellen, ändern Sie seine Eigenschaften nach Bedarf und übergeben Sie es dann an eine der oben genannten Methoden.
Sie können auch ein vorhandenes ImageDocument-Objekt hinzufügen (z. B. eines, das aus einer Datei im internen Format geladen wurde), und zwar mit der Methode [AddImageDocument](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/addimagedocument-method) des FRDocument-Objekts.
## ImageDocument-Struktur
Sobald das Bild einer Seite in das Dokument geladen wurde, kann über die Eigenschaft [IFRPage::ImageDocument](/de/fine-reader/engine/api-reference/document-related-objects/frpage) darauf zugegriffen werden. Jedes geöffnete Bild in ABBYY FineReader Engine wird durch ein [ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument)-Objekt dargestellt. Das ImageDocument speichert das Bild im sogenannten „internen Format“, das 4 Bildebenen umfasst, die durch [Image](/de/fine-reader/engine/api-reference/image-related-objects/image)-Objekte repräsentiert werden:
* Schwarzweißebene. Sie ist die Schwarzweißkopie des Quellbilds.
* Grauebene. Sie ist die Graustufenkopie des Quellbilds. Wenn das Quellbild schwarzweiß war, ist diese Ebene identisch mit der Schwarzweißebene.
* Farbebene. Sie ist die Farbkopie des Quellbilds. Wenn das Quellbild schwarzweiß war, ist diese Ebene identisch mit der Schwarzweißebene; wenn es ein Graustufenbild war, ist diese Ebene identisch mit der Grauebene.
* Vorschau. Ein kleines Farbbild, das zur Anzeige eines Vorschaubilds in der Benutzeroberfläche verwendet wird. Die Vorschau wird beim Aufruf der Methode [GetPreviewImage](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/getpreviewimage-method) oder [GetPreviewImageSpecificSize](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/getpreviewimagespecificsize-method) erstellt. Jede Änderung des Bilds, ob automatisch oder manuell, kann die erstellte Vorschau zurücksetzen, sodass sie erneut erstellt werden muss.
Größe und Auflösung von Schwarzweiß-, Grau- und Farbbildern sind identisch. Das Vorschaubild ist in der Regel kleiner.
Die Bilder können beim Öffnen entzerrt werden. Um die Koordinaten auf dem Originalbild den Koordinaten nach dem Öffnen oder nach weiteren Änderungen zuzuordnen, verwenden Sie das Objekt [CoordinatesConverter](/de/fine-reader/engine/api-reference/image-related-objects/coordinatesconverter). Es speichert den Zustand der Koordinaten zu dem Zeitpunkt, zu dem es abgerufen wurde. Sie können dieses Objekt verwenden, um Pixelkoordinaten zwischen beliebigen zwei Phasen der Bildverarbeitung zu konvertieren. Zum Beispiel:
1. Rufen Sie dieses Objekt direkt nach dem Öffnen des Bilds, bei dem die Schieflage des Bilds korrigiert wurde, über die Eigenschaft [IImageDocument::CoordinatesConverter](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument#coordinatesconverter) ab.
2. Rufen Sie nach weiteren Änderungen eine weitere Instanz dieses Objekts aus dem ImageDocument ab.
3. Jetzt können Sie Pixelkoordinaten zwischen der anfänglich entzerrten Bildebene und der geänderten Bildebene konvertieren, indem Sie die Methode [ConvertCoordinates](/de/fine-reader/engine/api-reference/image-related-objects/coordinatesconverter/convertcoordinates-method) zweimal anwenden:
1. Konvertieren Sie mithilfe der ersten Instanz des CoordinatesConverter von der entzerrten Bildebene zum Original.
2. Konvertieren Sie das Ergebnis mithilfe der zweiten Instanz des CoordinatesConverter von der ursprünglichen Bildebene zur geänderten Bildebene.
Mit derselben Methode können Sie Pixelkoordinaten von einer der Bildebenen in voller Größe zur Vorschaubildebene und zurück konvertieren. Die Pixelkoordinaten auf den Schwarzweiß-, Grau- und Farbbildebenen sind identisch.
Eine Bildänderung, ob automatisch oder manuell, kann die zuvor erstellte Vorschaubildebene zurücksetzen, und Sie können dann keine Koordinaten zu oder von dieser Vorschau konvertieren. Bevor Sie Koordinaten konvertieren, rufen Sie die Methode [GetPreviewImage](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/getpreviewimage-method) erneut auf, wenn das Bild geändert wurde.
## Bildbearbeitung
Die automatische Vorverarbeitung eignet sich am besten, um das Bild für Optical Character Recognition (OCR) vorzubereiten. Das Programm bestimmt die Herkunft des Bildes und den Dokumenttyp, erkennt eine falsche Ausrichtung, Auflösung oder Schieflage des Bildes und berücksichtigt all diese Faktoren, um das Bild zu verbessern. Wir empfehlen, zusätzliche Bildbearbeitungen nur dann vorzunehmen, wenn Sie nach der automatischen Vorverarbeitung mit dem Ergebnis nicht zufrieden sind.
Bearbeitungen beim Öffnen des Bildes werden über das Objekt [PrepareImageMode](/de/fine-reader/engine/api-reference/image-related-objects/prepareimagemode) gesteuert.
Nach dem Öffnen kann das Bild wie folgt geändert werden:
* mithilfe der Methoden des Objekts [ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument)
* mit dem Objekt [ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification), das an die Methode [IImageDocument::Modify](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/modify-method) übergeben wird
* mithilfe der Methoden der Objekte [FRPage](/de/fine-reader/engine/api-reference/document-related-objects/frpage) und [FRDocument](/de/fine-reader/engine/api-reference/document-related-objects/frdocument)
## Speichern von Bildern
Sie können die aktuelle Bildebene mit der [WriteToFile](/de/fine-reader/engine/api-reference/image-related-objects/image/writetofile-method)-Methode des Image-Objekts in einem angegebenen Format in eine Bilddatei speichern.
ABBYY FineReader Engine bietet auch die Möglichkeit, mehrere Bilder in einer einzigen Bilddatei zu speichern. Verwenden Sie zum Speichern einer mehrseitigen Bilddatei das [MultipageImageWriter](/de/fine-reader/engine/api-reference/image-related-objects/multipageimagewriter)-Objekt:
1. Erstellen Sie ein MultipageImageWriter-Objekt mit der [CreateMultipageImageWriter](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createmultipageimagewriter-method)-Methode des [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface)-Objekts.
2. Fügen Sie Bilder mit der [AddPage](/de/fine-reader/engine/api-reference/image-related-objects/multipageimagewriter/addpage-method)-Methode des MultipageImageWriter-Objekts am Ende der mehrseitigen Bilddatei hinzu. Jedes Bild wird als einzelne Seite hinzugefügt.
3. Bevor die neu erstellte Bilddatei verwendet werden kann, müssen alle Verweise auf das MultipageImageWriter-Objekt freigegeben werden.
Beachten Sie, dass das ImageDocument-Objekt zwar mehrere Speichermethoden bereitstellt ([SaveTo](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/saveto-method), [SaveToFile](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/savetofile-method), [SaveToMemory](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument/savetomemory-method)), diese Methoden jedoch nicht zum Speichern eines Bildes in einem externen Format verwendet werden können. Diese Methoden speichern den Inhalt des ImageDocument-Objekts im internen Format von ABBYY FineReader Engine, das in keinem externen Programm angezeigt werden kann.
## Siehe auch
[Unterstützte Bildformate](/de/fine-reader/engine/specifications/supported-image-formats)