hom_mat3d_translate_local T_hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal (Operator)
Name
hom_mat3d_translate_local T_hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal — Add a translation to a homogeneous 3D transformation matrix.
Signature
Description
hom_mat3d_translate_local hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal HomMat3dTranslateLocal adds a translation by the vector
t = (Tx Tx Tx Tx tx ,Ty Ty Ty Ty ty ,Tz Tz Tz Tz tz ) to
the homogeneous 3D transformation matrix HomMat3D HomMat3D HomMat3D HomMat3D homMat3D and returns the
resulting matrix in HomMat3DTranslate HomMat3DTranslate HomMat3DTranslate HomMat3DTranslate homMat3DTranslate . In contrast to
hom_mat3d_translate hom_mat3d_translate HomMat3dTranslate HomMat3dTranslate HomMat3dTranslate , the translation is performed relative to the
local coordinate system, i.e., the coordinate system described by
HomMat3D HomMat3D HomMat3D HomMat3D homMat3D ; this corresponds to the following chain of transformation
matrices:
Attention
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.
Execution Information
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.
Parameters
HomMat3D HomMat3D HomMat3D HomMat3D homMat3D (input_control) hom_mat3d → HHomMat3D , HTuple HTuple Htuple (real) (double ) (double ) (double )
Input transformation matrix.
Tx Tx Tx Tx tx (input_control) point3d.x → HTuple HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Translation along the x-axis.
Default value: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Ty Ty Ty Ty ty (input_control) point3d.y → HTuple HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Translation along the y-axis.
Default value: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Tz Tz Tz Tz tz (input_control) point3d.z → HTuple HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Translation along the z-axis.
Default value: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
HomMat3DTranslate HomMat3DTranslate HomMat3DTranslate HomMat3DTranslate homMat3DTranslate (output_control) hom_mat3d → HHomMat3D , HTuple HTuple Htuple (real) (double ) (double ) (double )
Output transformation matrix.
Result
If the parameters are valid, the operator
hom_mat3d_translate_local hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal HomMat3dTranslateLocal returns 2 (H_MSG_TRUE). If necessary, an
exception is raised.
Possible Predecessors
hom_mat3d_identity hom_mat3d_identity HomMat3dIdentity HomMat3dIdentity HomMat3dIdentity ,
hom_mat3d_translate_local hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal HomMat3dTranslateLocal ,
hom_mat3d_scale_local hom_mat3d_scale_local HomMat3dScaleLocal HomMat3dScaleLocal HomMat3dScaleLocal ,
hom_mat3d_rotate_local hom_mat3d_rotate_local HomMat3dRotateLocal HomMat3dRotateLocal HomMat3dRotateLocal
Possible Successors
hom_mat3d_translate_local hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal HomMat3dTranslateLocal ,
hom_mat3d_scale_local hom_mat3d_scale_local HomMat3dScaleLocal HomMat3dScaleLocal HomMat3dScaleLocal ,
hom_mat3d_rotate_local hom_mat3d_rotate_local HomMat3dRotateLocal HomMat3dRotateLocal HomMat3dRotateLocal
See also
hom_mat3d_invert hom_mat3d_invert HomMat3dInvert HomMat3dInvert HomMat3dInvert ,
hom_mat3d_identity hom_mat3d_identity HomMat3dIdentity HomMat3dIdentity HomMat3dIdentity ,
hom_mat3d_translate hom_mat3d_translate HomMat3dTranslate HomMat3dTranslate HomMat3dTranslate ,
pose_to_hom_mat3d pose_to_hom_mat3d PoseToHomMat3d PoseToHomMat3d PoseToHomMat3d ,
hom_mat3d_to_pose hom_mat3d_to_pose HomMat3dToPose HomMat3dToPose HomMat3dToPose ,
hom_mat3d_compose hom_mat3d_compose HomMat3dCompose HomMat3dCompose HomMat3dCompose
Module
Foundation