affine_trans_object_model_3dT_affine_trans_object_model_3daffine_trans_object_model_3dAffineTransObjectModel3dAffineTransObjectModel3d (Operator)

Name

affine_trans_object_model_3dT_affine_trans_object_model_3daffine_trans_object_model_3dAffineTransObjectModel3dAffineTransObjectModel3d — Apply an arbitrary affine 3D transformation to a 3D object model.

Signature

Description

affine_trans_object_model_3daffine_trans_object_model_3daffine_trans_object_model_3dAffineTransObjectModel3dAffineTransObjectModel3d applies an arbitrary affine 3D transformation, i.e., scaling, rotation, and translation, to a 3D object model and returns the handle of the transformed 3D object model. The affine transformation is described by the homogeneous transformation matrix given in HomMat3DHomMat3DHomMat3DHomMat3DhomMat3D.

The transformation matrix can be created using the operators hom_mat3d_identityhom_mat3d_identityhom_mat3d_identityHomMat3dIdentityHomMat3dIdentity, hom_mat3d_scalehom_mat3d_scalehom_mat3d_scaleHomMat3dScaleHomMat3dScale, hom_mat3d_rotatehom_mat3d_rotatehom_mat3d_rotateHomMat3dRotateHomMat3dRotate, hom_mat3d_translatehom_mat3d_translatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslate, etc., or be the result of pose_to_hom_mat3dpose_to_hom_mat3dpose_to_hom_mat3dPoseToHomMat3dPoseToHomMat3d (see affine_trans_point_3daffine_trans_point_3daffine_trans_point_3dAffineTransPoint3dAffineTransPoint3d).

In general, the operator affine_trans_object_model_3daffine_trans_object_model_3daffine_trans_object_model_3dAffineTransObjectModel3dAffineTransObjectModel3d is not necessary in the context of 3D matching. If a rotation of the 3D object model into a reference orientation should be performed, instead appropriate values for the parameters RefRotXRefRotXRefRotXRefRotXrefRotX, RefRotYRefRotYRefRotYRefRotYrefRotY, RefRotZRefRotZRefRotZRefRotZrefRotZ, and OrderOfRotationOrderOfRotationOrderOfRotationOrderOfRotationorderOfRotation should be passed to the operator create_shape_model_3dcreate_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3d.

Parallelization

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

Parameters

Result

affine_trans_object_model_3daffine_trans_object_model_3daffine_trans_object_model_3dAffineTransObjectModel3dAffineTransObjectModel3d returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Possible Predecessors

read_object_model_3dread_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3d, xyz_to_object_model_3dxyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d

Possible Successors

project_object_model_3dproject_object_model_3dproject_object_model_3dProjectObjectModel3dProjectObjectModel3d, object_model_3d_to_xyzobject_model_3d_to_xyzobject_model_3d_to_xyzObjectModel3dToXyzObjectModel3dToXyz

See also

affine_trans_point_3daffine_trans_point_3daffine_trans_point_3dAffineTransPoint3dAffineTransPoint3d

Module

3D Metrology