hom_mat3d_scale
— Fügt eine Skalierung zu einer homogenen 3D-Transformationsmatrix hinzu.
hom_mat3d_scale
fügt zur homogenen 3D-Transformationsmatrix
HomMat3D
eine Skalierung um die Skalierungsfaktoren Sx
,
Sy
und Sz
hinzu und liefert die resultierende Matrix in
HomMat3DScale
zurück. Die Skalierung wird beschrieben durch die
3×3 Skalierungsmatrix S. Sie
wird relativ zum globalen (d.h. feststehenden) Koordinatensystem
ausgeführt; dies entspricht der folgenden Kette von Transformationsmatrizen:
Der Punkt (Px
,Py
,Pz
) ist dabei der Fixpunkt der
Skalierung, d.h. dieser Punkt bleibt unverändert, wenn man ihn mit
HomMat3DScale
transformiert. Dieses Verhalten wird erreicht, indem
zur Eingabe-Transformationsmatrix zuerst eine Translation hinzugefügt wird,
die den Fixpunkt in den Ursprung des globalen Koordinatensystems
verschiebt. Dann wird die Skalierung hinzugefügt, und zuletzt eine
Translation, die den Fixpunkt wieder zurück in seine Ausgangsposition
verschiebt. Dies entspricht der folgenden Kette von Transformationsmatrizen:
Um die Transformation im lokalen Koordinatensystem, das durch
HomMat3D
beschrieben ist, durchzuführen, kann
hom_mat3d_scale_local
verwendet 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, rc, td, re, rf, rg, th, ri, rj, rk, tl] gespeichert. Es ist aber auch möglich, volle 4×4 Matrizen, die eine projektive 3D-Transformation darstellen können, zu verarbeiten.
HomMat3D
(input_control) hom_mat3d →
(real)
Eingabe-Transformationsmatrix.
Sx
(input_control) number →
(real / integer)
Skalierungsfaktor in x-Richtung.
Defaultwert: 2
Wertevorschläge: 0.125, 0.25, 0.5, 1, 2, 4, 8, 112
Restriktion: Sx != 0
Sy
(input_control) number →
(real / integer)
Skalierungsfaktor in y-Richtung.
Defaultwert: 2
Wertevorschläge: 0.125, 0.25, 0.5, 1, 2, 4, 8, 112
Restriktion: Sy != 0
Sz
(input_control) number →
(real / integer)
Skalierungsfaktor in z-Richtung.
Defaultwert: 2
Wertevorschläge: 0.125, 0.25, 0.5, 1, 2, 4, 8, 112
Restriktion: Sz != 0
Px
(input_control) point3d.x →
(real / integer)
Fixpunkt der Transformation (x-Koordinate).
Defaultwert: 0
Wertevorschläge: 0, 16, 32, 64, 128, 256, 512, 1024
Py
(input_control) point3d.y →
(real / integer)
Fixpunkt der Transformation (y-Koordinate).
Defaultwert: 0
Wertevorschläge: 0, 16, 32, 64, 128, 256, 512, 1024
Pz
(input_control) point3d.z →
(real / integer)
Fixpunkt der Transformation (z-Koordinate).
Defaultwert: 0
Wertevorschläge: 0, 16, 32, 64, 128, 256, 512, 1024
HomMat3DScale
(output_control) hom_mat3d →
(real)
Ausgabe-Transformationsmatrix.
hom_mat3d_scale
liefert den Wert 2 (H_MSG_TRUE), falls alle drei
Skalierungsfaktoren verschieden von 0 sind. Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
hom_mat3d_identity
,
hom_mat3d_translate
,
hom_mat3d_scale
,
hom_mat3d_rotate
hom_mat3d_translate
,
hom_mat3d_scale
,
hom_mat3d_rotate
hom_mat3d_invert
,
hom_mat3d_identity
,
hom_mat3d_scale_local
,
pose_to_hom_mat3d
,
hom_mat3d_to_pose
,
hom_mat3d_compose
Foundation