hom_mat2d_translate
— Fügt eine Translation zu einer homogenen 2D-Transformationsmatrix hinzu.
hom_mat2d_translate( : : HomMat2D, Tx, Ty : HomMat2DTranslate)
hom_mat2d_translate
fügt zur homogenen 2D-Transformationsmatrix
HomMat2D
eine Translation um den Vektor
t = (Tx
,Ty
) hinzu und
liefert die resultierende Matrix in HomMat2DTranslate
zurück. Die
Translation wird relativ zum globalen (d.h. feststehenden) Koordinatensystem
ausgeführt; dies entspricht der folgenden Kette von Transformationsmatrizen:
Um die Transformation im lokalen Koordinatensystem, das durch
HomMat2D
beschrieben ist, durchzuführen, kann
hom_mat2d_translate_local
verwendet werden.
Es ist zu beachten, dass homogene Transformationsmatrizen sich auf
ein allgemeines rechtshändiges mathematisches Koordinatensystem
beziehen. Falls eine homogene Transformationsmatrix zur
Transformation von Bildern, Regionen, XLD-Konturen oder anderen
Daten, die aus Bildern extrahiert wurden, verwendet werden soll, ist
zu beachten, dass die Zeilenkoordinaten in den x-Koordinaten und die
Spaltenkoordinaten in den y-Koordinaten übergeben werden müssen.
Die Übergabereihenfolge von Zeilen- und Spaltenkoordinaten
entspricht also der üblichen Reihenfolge
(Row
,Column
). Diese Konvention ist
unerlässlich, um bei der Transformation von Bilddaten ein
rechtshändiges Koordinatensystem zu erhalten, so dass
z.B. insbesondere Rotationen in der mathematisch korrekten
Drehrichtung ausgeführt werden.
Homogene Transformationsmatrizen werden zeilenweise in Form eines Tupels abgespeichert; die letzte Zeile wird im Normalfall nicht gespeichert, da sie für alle affinen Transformationsmatrizen identisch ist. Zum Beispiel wird die Matrix als das Tupel [ra, rb, tc, rd, re, tf] gespeichert. Es ist aber auch möglich, volle 3×3 Matrizen, die eine projektive 2D-Transformation darstellen können, zu verarbeiten.
HomMat2D
(input_control) hom_mat2d →
(real)
Eingabe-Transformationsmatrix.
Tx
(input_control) point.x →
(real / integer)
Verschiebung in x-Richtung.
Defaultwert: 64
Wertevorschläge: 0, 16, 32, 64, 128, 256, 512, 1024
Ty
(input_control) point.y →
(real / integer)
Verschiebung in y-Richtung.
Defaultwert: 64
Wertevorschläge: 0, 16, 32, 64, 128, 256, 512, 1024
HomMat2DTranslate
(output_control) hom_mat2d →
(real)
Ausgabe-Transformationsmatrix.
Sind die Parameterwerte korrekt, dann liefert
hom_mat2d_translate
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
hom_mat2d_identity
,
hom_mat2d_translate
,
hom_mat2d_scale
,
hom_mat2d_rotate
,
hom_mat2d_slant
,
hom_mat2d_reflect
hom_mat2d_translate
,
hom_mat2d_scale
,
hom_mat2d_rotate
,
hom_mat2d_slant
,
hom_mat2d_reflect
Foundation