hom_mat3d_translate — Add a translation to a homogeneous 3D transformation matrix.
hom_mat3d_translate( : : HomMat3D, Tx, Ty, Tz : HomMat3DTranslate)
hom_mat3d_translate adds a translation by the vector
t = (Tx,Ty,Tz) to
the homogeneous 3D transformation matrix HomMat3D and returns the
resulting matrix in HomMat3DTranslate. The translation is performed
relative to the global (i.e., fixed) coordinate system; this corresponds to
the following chain of transformation matrices:
To perform the transformation in the local coordinate system, i.e.,
the one described by HomMat3D, use
hom_mat3d_translate_local.
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 returns
2 (H_MSG_TRUE). If necessary, an exception is raised.
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_translate_local,
pose_to_hom_mat3d,
hom_mat3d_to_pose,
hom_mat3d_compose
Foundation