hom_mat3d_translate_local T_hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal hom_mat3d_translate_local (Operator)
Name
hom_mat3d_translate_local T_hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal hom_mat3d_translate_local
— Add a translation to a homogeneous 3D transformation matrix.
Signature
def hom_mat3d_translate_local (hom_mat_3d : Sequence[float], tx : Union[float, int], ty : Union[float, int], tz : Union[float, int]) -> Sequence[float]
Description
hom_mat3d_translate_local hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal HomMat3dTranslateLocal hom_mat3d_translate_local
adds a translation by the vector
t = (Tx Tx Tx Tx tx tx
,Ty Ty Ty Ty ty ty
,Tz Tz Tz Tz tz tz
) to
the homogeneous 3D transformation matrix HomMat3D HomMat3D HomMat3D HomMat3D homMat3D hom_mat_3d
and returns the
resulting matrix in HomMat3DTranslate HomMat3DTranslate HomMat3DTranslate HomMat3DTranslate homMat3DTranslate hom_mat_3dtranslate
. In contrast to
hom_mat3d_translate hom_mat3d_translate HomMat3dTranslate HomMat3dTranslate HomMat3dTranslate hom_mat3d_translate
, the translation is performed relative to the
local coordinate system, i.e., the coordinate system described by
HomMat3D HomMat3D HomMat3D HomMat3D homMat3D hom_mat_3d
; 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 hom_mat_3d
(input_control) hom_mat3d →
HHomMat3D , HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Input transformation matrix.
Tx Tx Tx Tx tx tx
(input_control) point3d.x →
HTuple Union[float, int] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Translation along the x-axis.
Default:
64
Suggested values:
0, 16, 32, 64, 128, 256, 512, 1024
Ty Ty Ty Ty ty ty
(input_control) point3d.y →
HTuple Union[float, int] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Translation along the y-axis.
Default:
64
Suggested values:
0, 16, 32, 64, 128, 256, 512, 1024
Tz Tz Tz Tz tz tz
(input_control) point3d.z →
HTuple Union[float, int] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Translation along the z-axis.
Default:
64
Suggested values:
0, 16, 32, 64, 128, 256, 512, 1024
HomMat3DTranslate HomMat3DTranslate HomMat3DTranslate HomMat3DTranslate homMat3DTranslate hom_mat_3dtranslate
(output_control) hom_mat3d →
HHomMat3D , HTuple Sequence[float] 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 hom_mat3d_translate_local
returns 2 (
H_MSG_TRUE )
. If necessary, an
exception is raised.
Possible Predecessors
hom_mat3d_identity hom_mat3d_identity HomMat3dIdentity HomMat3dIdentity HomMat3dIdentity hom_mat3d_identity
,
hom_mat3d_translate_local hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal HomMat3dTranslateLocal hom_mat3d_translate_local
,
hom_mat3d_scale_local hom_mat3d_scale_local HomMat3dScaleLocal HomMat3dScaleLocal HomMat3dScaleLocal hom_mat3d_scale_local
,
hom_mat3d_rotate_local hom_mat3d_rotate_local HomMat3dRotateLocal HomMat3dRotateLocal HomMat3dRotateLocal hom_mat3d_rotate_local
Possible Successors
hom_mat3d_translate_local hom_mat3d_translate_local HomMat3dTranslateLocal HomMat3dTranslateLocal HomMat3dTranslateLocal hom_mat3d_translate_local
,
hom_mat3d_scale_local hom_mat3d_scale_local HomMat3dScaleLocal HomMat3dScaleLocal HomMat3dScaleLocal hom_mat3d_scale_local
,
hom_mat3d_rotate_local hom_mat3d_rotate_local HomMat3dRotateLocal HomMat3dRotateLocal HomMat3dRotateLocal hom_mat3d_rotate_local
See also
hom_mat3d_invert hom_mat3d_invert HomMat3dInvert HomMat3dInvert HomMat3dInvert hom_mat3d_invert
,
hom_mat3d_identity hom_mat3d_identity HomMat3dIdentity HomMat3dIdentity HomMat3dIdentity hom_mat3d_identity
,
hom_mat3d_translate hom_mat3d_translate HomMat3dTranslate HomMat3dTranslate HomMat3dTranslate hom_mat3d_translate
,
pose_to_hom_mat3d pose_to_hom_mat3d PoseToHomMat3d PoseToHomMat3d PoseToHomMat3d pose_to_hom_mat3d
,
hom_mat3d_to_pose hom_mat3d_to_pose HomMat3dToPose HomMat3dToPose HomMat3dToPose hom_mat3d_to_pose
,
hom_mat3d_compose hom_mat3d_compose HomMat3dCompose HomMat3dCompose HomMat3dCompose hom_mat3d_compose
Module
Foundation