> ## 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.

# CoordinatesConverter-Objekt (ICoordinatesConverter-Schnittstelle)

> CoordinatesConverter-Objekt (ICoordinatesConverter-Schnittstelle) in der ABBYY FineReader Engine API — enthält Informationen zu den Pixelkoordinaten eines Bildes zu dem Zeitpunkt, als sie aus einem ImageDocument abgerufen wurden; ermöglicht die Konvertierung von Pixelkoordinaten zwischen Modifikationszuständen oder Bildebenen.

Dieses Objekt enthält Informationen über die Pixelkoordinaten im Bild zu dem Zeitpunkt, an dem es aus dem Objekt [ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument) (über die Eigenschaft [CoordinatesConverter](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument#coordinatesconverter)) abgerufen wurde. Es ermöglicht die Konvertierung von Pixelkoordinaten von einem Modifikationszustand des Bildes in einen anderen.

Sie können dieses Objekt verwenden, um Pixelkoordinaten zwischen beliebigen zwei Stufen der Bildverarbeitung zu konvertieren. Zum Beispiel:

1. Rufen Sie dieses Objekt direkt nach dem Öffnen des Bildes ab, bei dem die Schieflage des Bildes korrigiert wurde.
2. Wenden Sie weitere Modifikationen an und rufen Sie eine weitere Instanz dieses Objekts aus dem ImageDocument ab.
3. Nun können Sie Pixelkoordinaten zwischen der anfangs entzerrten Bildebene und der modifizierten Bildebene konvertieren, indem Sie die Methode `ConvertCoordinates` zweimal anwenden:
   * Konvertieren Sie mit der ersten Instanz von CoordinatesConverter von der entzerrten Bildebene zum Original.
   * Konvertieren Sie mit der zweiten Instanz von CoordinatesConverter das Ergebnis von der ursprünglichen Bildebene in die modifizierte Bildebene.

Das CoordinatesConverter-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 der Zustand des Objekts aus dem persistenten Speicher gelesen wird. Die folgenden Methoden ermöglichen die Persistenz des Objekts:

Linux: [SaveToFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) und [LoadFromFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows: [SaveToFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) und [LoadFromMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).

<div id="properties">
  ## Eigenschaften
</div>

| Name        | Typ                                                                                                                                                                                                                  | Beschreibung                   |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| Application | [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface), [nur lesbar](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Gibt das Engine-Objekt zurück. |

<div id="methods">
  ## Methoden
</div>

| Name                                                                                                                            | Beschreibung                                                                                                                                                                                          |
| ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [ConvertCoordinates](/de/fine-reader/engine/api-reference/image-related-objects/coordinatesconverter/convertcoordinates-method) | Konvertiert die Koordinaten eines Pixels zwischen verschiedenen Modifikationszuständen oder Bildebenen des [ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument). |
| [LoadFromFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                      | Stellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.                                                                                                                         |
| [LoadFromMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method)                  | Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her. <Note> *Nur für Windows.*</Note>                                                                                                  |
| [SaveToFile](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                          | Speichert den Inhalt des Objekts in einer Datei auf dem Datenträger.                                                                                                                                  |
| [SaveToMemory](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method)                      | Speichert den Inhalt des Objekts im globalen Speicher. <Note> *Nur für Windows.*</Note>                                                                                                               |

<div id="related-objects">
  ## Zugehörige Objekte
</div>

<img src="https://mintcdn.com/abbyy/6udH-pkk8zkVafYH/images/fine-reader/engine/coordinatesconverter.gif?s=569f3a2af2749c842aa6594c093cc407" alt="CoordinatesConverter" width="141" height="57" data-path="images/fine-reader/engine/coordinatesconverter.gif" />[](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument#coordinatesconverter)[](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument)

[Objektdiagramm](/de/fine-reader/engine/api-reference/object-diagram)

<div id="samples">
  ## Beispiele
</div>

Im folgenden Windows-Beispiel wird dieses Objekt verwendet, um Koordinaten zwischen zwei verschiedenen Modifikationszuständen umzurechnen:

<div id="c">
  ### C\#
</div>

```csharp theme={null}
FREngine.IEngine engine;
FREngine.IFRDocument frDoc;
// Schieflagenkorrektur wird standardmäßig beim Hinzufügen der Bilder zum Dokument durchgeführt
frDoc.AddImageFile ("D:\\Sample.tif", null, null);
// ImageDocument der ersten Seite öffnen
FREngine.IImageDocument imageDoc = frDoc.Pages[0].ImageDocument; 
// Momentaufnahme der Koordinaten nach dem Öffnen erstellen
FREngine.ICoordinatesConverter convAfterOpening = imageDoc.CoordinatesConverter;
// Bild weiter transformieren
imageDoc.Transform(FREngine.RotationTypeEnum.RT_Counterclockwise, false, false);
// Momentaufnahme der Koordinaten nach der Transformation erstellen
FREngine.ICoordinatesConverter convAfterModification = imageDoc.CoordinatesConverter;
...
// Nach weiterer Verarbeitung wird ein Pixel auf der modifizierten Bildebene gefunden, dessen Koordinaten konvertiert werden müssen
int x, y;
convAfterModification.ConvertCoordinates(FREngine.ImageTypeEnum.IT_Base, FREngine.ImageTypeEnum.IT_Modified, ref x, ref y);
convAfterOpening.ConvertCoordinates(FREngine.ImageTypeEnum.IT_Modified, FREngine.ImageTypeEnum.IT_Base, ref x, ref y);
// x, y enthalten nun die Koordinaten des gesuchten Punktes auf der entzerrten Bildebene
```

Dieses Objekt wird auch im macOS-Codebeispiel [Visitenkartenerkennung](/de/fine-reader/engine/guided-tour/samples#bcr_mac) verwendet.

<div id="see-also">
  ## Siehe auch
</div>

[ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument)

[Arbeiten mit Bildern](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images)

[Arbeiten mit Eigenschaften](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)