Zum Hauptinhalt springen
Dieses Objekt enthält Informationen über die Pixelkoordinaten im Bild zu dem Zeitpunkt, an dem es aus dem Objekt ImageDocument (über die Eigenschaft CoordinatesConverter) abgerufen wurde. Es ermöglicht die Konvertierung von Pixelkoordinaten von einem Bildmodifikationszustand 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 und LoadFromFile Windows: SaveToFile, LoadFromFile, SaveToMemory und LoadFromMemory.

​
Eigenschaften

NameTypBeschreibung
ApplicationEngine, nur lesbarGibt das Engine-Objekt zurück.

​
Methoden

NameBeschreibung
ConvertCoordinatesKonvertiert die Koordinaten eines Pixels zwischen verschiedenen Modifikationszuständen oder Bildebenen des ImageDocument.
LoadFromFileStellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory <Note> Verfügbar für Windows. </Note>Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her.
SaveToFileSpeichert den Inhalt des Objekts in einer Datei auf dem Datenträger.
SaveToMemory <Note> Verfügbar für Windows. </Note>Speichert den Inhalt des Objekts im globalen Speicher.
CoordinatesConverter Objektdiagramm

​
Beispiele

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

​
C#

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

​
Siehe auch

ImageDocument Arbeiten mit Bildern Arbeiten mit Eigenschaften