hom_mat3d_translate_localT_hom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocal (Operator)

Name

hom_mat3d_translate_localT_hom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocal — Add a translation to a homogeneous 3D transformation matrix.

Signature

Description

hom_mat3d_translate_localhom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocal adds a translation by the vector t = (TxTxTxTxtx,TyTyTyTyty,TzTzTzTztz) to the homogeneous 3D transformation matrix HomMat3DHomMat3DHomMat3DHomMat3DhomMat3D and returns the resulting matrix in HomMat3DTranslateHomMat3DTranslateHomMat3DTranslateHomMat3DTranslatehomMat3DTranslate. In contrast to hom_mat3d_translatehom_mat3d_translatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslate, the translation is performed relative to the local coordinate system, i.e., the coordinate system described by HomMat3DHomMat3DHomMat3DHomMat3DhomMat3D; this corresponds to the following chain of transformation matrices:

                                   / 1 0 0    \         / Tx \
  HomMat3DTranslate  =  HomMat3D * | 0 1 0  t |     t = | Ty |
                                   | 0 0 1    |         \ Tz /
                                   \ 0 0 0  1 /

Attention

Note that homogeneous matrices are stored row-by-row as a tuple; the last row is not stored because it is identical for all homogeneous matrices that describe an affine transformation. For example, the homogeneous matrix

    / ra rb rc td \
    | re rf rg th |
    | ri rj rk tl |
    \ 0  0  0  1  /

is stored as the tuple [ra, rb, rc, td, re, rf, rg, th, ri, rj, rk, tl].

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

If the parameters are valid, the operator hom_mat3d_translate_localhom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocal returns 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

hom_mat3d_identityhom_mat3d_identityhom_mat3d_identityHomMat3dIdentityHomMat3dIdentity, hom_mat3d_translate_localhom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocal, hom_mat3d_scale_localhom_mat3d_scale_localhom_mat3d_scale_localHomMat3dScaleLocalHomMat3dScaleLocal, hom_mat3d_rotate_localhom_mat3d_rotate_localhom_mat3d_rotate_localHomMat3dRotateLocalHomMat3dRotateLocal

Possible Successors

hom_mat3d_translate_localhom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocal, hom_mat3d_scale_localhom_mat3d_scale_localhom_mat3d_scale_localHomMat3dScaleLocalHomMat3dScaleLocal, hom_mat3d_rotate_localhom_mat3d_rotate_localhom_mat3d_rotate_localHomMat3dRotateLocalHomMat3dRotateLocal

See also

hom_mat3d_inverthom_mat3d_inverthom_mat3d_invertHomMat3dInvertHomMat3dInvert, hom_mat3d_identityhom_mat3d_identityhom_mat3d_identityHomMat3dIdentityHomMat3dIdentity, hom_mat3d_translatehom_mat3d_translatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslate, pose_to_hom_mat3dpose_to_hom_mat3dpose_to_hom_mat3dPoseToHomMat3dPoseToHomMat3d, hom_mat3d_to_posehom_mat3d_to_posehom_mat3d_to_poseHomMat3dToPoseHomMat3dToPose, hom_mat3d_composehom_mat3d_composehom_mat3d_composeHomMat3dComposeHomMat3dCompose

Module

Foundation