hom_mat2d_translate_local
— Fügt eine Translation zu einer homogenen 2D-Transformationsmatrix hinzu.
hom_mat2d_translate_local( : : HomMat2D, Tx, Ty : HomMat2DTranslate)
hom_mat2d_translate_local
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. Im
Gegensatz zu hom_mat2d_translate
wird die Translation relativ zum
lokalen Koordinatensystem, das durch HomMat2D
beschrieben ist,
ausgeführt; dies entspricht der folgenden Kette von Transformationsmatrizen:
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_local
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
hom_mat2d_identity
,
hom_mat2d_translate_local
,
hom_mat2d_scale_local
,
hom_mat2d_rotate_local
,
hom_mat2d_slant_local
,
hom_mat2d_reflect_local
hom_mat2d_translate_local
,
hom_mat2d_scale_local
,
hom_mat2d_rotate_local
,
hom_mat2d_slant_local
,
hom_mat2d_reflect_local
Foundation