hom_mat3d_scalehom_mat3d_scaleHomMat3dScaleHomMat3dScalehom_mat3d_scale fügt zur homogenen 3D-Transformationsmatrix
HomMat3DHomMat3DHomMat3DhomMat3Dhom_mat_3d eine Skalierung um die Skalierungsfaktoren SxSxSxsxsx,
SySySysysy und SzSzSzszsz hinzu und liefert die resultierende Matrix in
HomMat3DScaleHomMat3DScaleHomMat3DScalehomMat3DScalehom_mat_3dscale 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 (PxPxPxpxpx,PyPyPypypy,PzPzPzpzpz) ist dabei der Fixpunkt der
Skalierung, d.h. dieser Punkt bleibt unverändert, wenn man ihn mit
HomMat3DScaleHomMat3DScaleHomMat3DScalehomMat3DScalehom_mat_3dscale 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:
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.
Ausführungsinformationen
Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
hom_mat3d_scalehom_mat3d_scaleHomMat3dScaleHomMat3dScalehom_mat3d_scale liefert den Wert 2 (
H_MSG_TRUE)
, falls alle drei
Skalierungsfaktoren verschieden von 0 sind. Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.