hom_mat3d_translate_local
— Add a translation to a homogeneous 3D transformation matrix.
hom_mat3d_translate_local( : : HomMat3D, Tx, Ty, Tz : HomMat3DTranslate)
hom_mat3d_translate_local
adds a translation by the vector
t = (Tx
,Ty
,Tz
) to
the homogeneous 3D transformation matrix HomMat3D
and returns the
resulting matrix in HomMat3DTranslate
. In contrast to
hom_mat3d_translate
, the translation is performed relative to the
local coordinate system, i.e., the coordinate system described by
HomMat3D
; this corresponds to the following chain of transformation
matrices:
Note that homogeneous matrices are stored row-by-row as a tuple; the last row is usually not stored because it is identical for all homogeneous matrices that describe an affine transformation. For example, the homogeneous matrix is stored as the tuple [ra, rb, rc, td, re, rf, rg, th, ri, rj, rk, tl]. However, it is also possible to process full 4×4 matrices, which represent a projective 4D transformation.
HomMat3D
(input_control) hom_mat3d →
(real)
Input transformation matrix.
Tx
(input_control) point3d.x →
(real / integer)
Translation along the x-axis.
Default value: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Ty
(input_control) point3d.y →
(real / integer)
Translation along the y-axis.
Default value: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Tz
(input_control) point3d.z →
(real / integer)
Translation along the z-axis.
Default value: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
HomMat3DTranslate
(output_control) hom_mat3d →
(real)
Output transformation matrix.
If the parameters are valid, the operator
hom_mat3d_translate_local
returns 2 (H_MSG_TRUE). If necessary, an
exception is raised.
hom_mat3d_identity
,
hom_mat3d_translate_local
,
hom_mat3d_scale_local
,
hom_mat3d_rotate_local
hom_mat3d_translate_local
,
hom_mat3d_scale_local
,
hom_mat3d_rotate_local
hom_mat3d_invert
,
hom_mat3d_identity
,
hom_mat3d_translate
,
pose_to_hom_mat3d
,
hom_mat3d_to_pose
,
hom_mat3d_compose
Foundation