ClassesClassesClassesClasses | | | | Operators

hom_mat3d_translateT_hom_mat3d_translateHomMat3dTranslatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslate (Operator)


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


hom_mat3d_translate( : : HomMat3D, Tx, Ty, Tz : HomMat3DTranslate)

Herror T_hom_mat3d_translate(const Htuple HomMat3D, const Htuple Tx, const Htuple Ty, const Htuple Tz, Htuple* HomMat3DTranslate)

Herror hom_mat3d_translate(const HTuple& HomMat3D, const HTuple& Tx, const HTuple& Ty, const HTuple& Tz, HTuple* HomMat3DTranslate)

void HomMat3dTranslate(const HTuple& HomMat3D, const HTuple& Tx, const HTuple& Ty, const HTuple& Tz, HTuple* HomMat3DTranslate)

HHomMat3D HHomMat3D::HomMat3dTranslate(const HTuple& Tx, const HTuple& Ty, const HTuple& Tz) const

HHomMat3D HHomMat3D::HomMat3dTranslate(double Tx, double Ty, double Tz) const

void HOperatorSetX.HomMat3dTranslate(
[in] VARIANT HomMat3d, [in] VARIANT Tx, [in] VARIANT Ty, [in] VARIANT Tz, [out] VARIANT* HomMat3dTranslate)

IHHomMat3DX* HHomMat3DX.HomMat3dTranslate(
[in] VARIANT Tx, [in] VARIANT Ty, [in] VARIANT Tz)

static void HOperatorSet.HomMat3dTranslate(HTuple homMat3D, HTuple tx, HTuple ty, HTuple tz, out HTuple homMat3DTranslate)

HHomMat3D HHomMat3D.HomMat3dTranslate(HTuple tx, HTuple ty, HTuple tz)

HHomMat3D HHomMat3D.HomMat3dTranslate(double tx, double ty, double tz)


hom_mat3d_translatehom_mat3d_translateHomMat3dTranslatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslate adds a translation by the vector t = (TxTxTxTxTxtx,TyTyTyTyTyty,TzTzTzTzTztz) to the homogeneous 3D transformation matrix HomMat3DHomMat3DHomMat3DHomMat3DHomMat3DhomMat3D and returns the resulting matrix in HomMat3DTranslateHomMat3DTranslateHomMat3DTranslateHomMat3DTranslateHomMat3DTranslatehomMat3DTranslate. The translation is performed relative to the global (i.e., fixed) coordinate system; this corresponds to the following chain of transformation matrices:

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

To perform the transformation in the local coordinate system, i.e., the one described by HomMat3DHomMat3DHomMat3DHomMat3DHomMat3DhomMat3D, use hom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocal.


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

    / 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]. However, it is also possible to process full 4×4 matrices, which represent a projective 4D transformation.



HomMat3DHomMat3DHomMat3DHomMat3DHomMat3DhomMat3D (input_control)  hom_mat3d HHomMat3D, HTupleHTupleHTupleHHomMat3DX, VARIANTHtuple (real) (double) (double) (double) (double) (double)

Input transformation matrix.

TxTxTxTxTxtx (input_control)  point3d.x HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Translation along the x-axis.

Default value: 64

Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024

TyTyTyTyTyty (input_control)  point3d.y HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Translation along the y-axis.

Default value: 64

Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024

TzTzTzTzTztz (input_control)  point3d.z HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Translation along the z-axis.

Default value: 64

Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024

HomMat3DTranslateHomMat3DTranslateHomMat3DTranslateHomMat3DTranslateHomMat3DTranslatehomMat3DTranslate (output_control)  hom_mat3d HHomMat3D, HTupleHTupleHTupleHHomMat3DX, VARIANTHtuple (real) (double) (double) (double) (double) (double)

Output transformation matrix.


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

Possible Predecessors

hom_mat3d_identityhom_mat3d_identityHomMat3dIdentityhom_mat3d_identityHomMat3dIdentityHomMat3dIdentity, hom_mat3d_translatehom_mat3d_translateHomMat3dTranslatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslate, hom_mat3d_scalehom_mat3d_scaleHomMat3dScalehom_mat3d_scaleHomMat3dScaleHomMat3dScale, hom_mat3d_rotatehom_mat3d_rotateHomMat3dRotatehom_mat3d_rotateHomMat3dRotateHomMat3dRotate

Possible Successors

hom_mat3d_translatehom_mat3d_translateHomMat3dTranslatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslate, hom_mat3d_scalehom_mat3d_scaleHomMat3dScalehom_mat3d_scaleHomMat3dScaleHomMat3dScale, hom_mat3d_rotatehom_mat3d_rotateHomMat3dRotatehom_mat3d_rotateHomMat3dRotateHomMat3dRotate

See also

hom_mat3d_inverthom_mat3d_invertHomMat3dInverthom_mat3d_invertHomMat3dInvertHomMat3dInvert, hom_mat3d_identityhom_mat3d_identityHomMat3dIdentityhom_mat3d_identityHomMat3dIdentityHomMat3dIdentity, hom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocal, pose_to_hom_mat3dpose_to_hom_mat3dPoseToHomMat3dpose_to_hom_mat3dPoseToHomMat3dPoseToHomMat3d, hom_mat3d_to_posehom_mat3d_to_poseHomMat3dToPosehom_mat3d_to_poseHomMat3dToPoseHomMat3dToPose, hom_mat3d_composehom_mat3d_composeHomMat3dComposehom_mat3d_composeHomMat3dComposeHomMat3dCompose



ClassesClassesClassesClasses | | | | Operators