CoordinatesConverter-Objekt (ICoordinatesConverter-Schnittstelle)

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 Modifikationszustand des Bildes in einen anderen. Sie können dieses Objekt verwenden, um Pixelkoordinaten zwischen beliebigen zwei Stufen der Bildverarbeitung zu konvertieren. Zum Beispiel:

Rufen Sie dieses Objekt direkt nach dem Öffnen des Bildes ab, bei dem die Schieflage des Bildes korrigiert wurde.
Wenden Sie weitere Modifikationen an und rufen Sie eine weitere Instanz dieses Objekts aus dem ImageDocument ab.
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

Name	Typ	Beschreibung
Application	Engine, nur lesbar	Gibt das Engine-Objekt zurück.

Methoden

Name	Beschreibung
ConvertCoordinates	Konvertiert die Koordinaten eines Pixels zwischen verschiedenen Modifikationszuständen oder Bildebenen des ImageDocument.
LoadFromFile	Stellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory	Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her. Nur für Windows.
SaveToFile	Speichert den Inhalt des Objekts in einer Datei auf dem Datenträger.
SaveToMemory	Speichert den Inhalt des Objekts im globalen Speicher. Nur für Windows.

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