trans_pose_shape_model_3dT_trans_pose_shape_model_3dTransPoseShapeModel3dTransPoseShapeModel3d (Operator)

Name

trans_pose_shape_model_3dT_trans_pose_shape_model_3dTransPoseShapeModel3dTransPoseShapeModel3d — Transform a pose that refers to the coordinate system of a 3D object model to a pose that refers to the reference coordinate system of a 3D shape model and vice versa.

Signature

Description

The operator trans_pose_shape_model_3dtrans_pose_shape_model_3dTransPoseShapeModel3dTransPoseShapeModel3dTransPoseShapeModel3d transforms the pose PoseInPoseInPoseInPoseInposeIn into the pose PoseOutPoseOutPoseOutPoseOutposeOut by using the transformation direction specified in TransformationTransformationTransformationTransformationtransformation. In the majority of cases, the operator will be used to transform a camera pose that is given with respect to the source coordinate system to a camera pose that refers to the target coordinate system.

The pose can be transformed between two coordinate systems. The first coordinate system is the reference coordinate system of the 3D shape model that is passed in ShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DID. The origin of the reference coordinate system lies at the reference point of the underlying 3D object model. The orientation of the reference coordinate system is determined by the reference orientation that was specified when creating the 3D shape model with create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d.

The second coordinate system is the world coordinate system, i.e., the coordinate system of the 3D object model that underlies the 3D shape model. This coordinate system is implicitly determined by the coordinates that are stored in the CAD file that was read by using read_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3dReadObjectModel3d.

If TransformationTransformationTransformationTransformationtransformation is set to 'ref_to_model'"ref_to_model""ref_to_model""ref_to_model""ref_to_model", it is assumed that PoseInPoseInPoseInPoseInposeIn refers to the reference coordinate system of the 3D shape model. The resulting output pose PoseOutPoseOutPoseOutPoseOutposeOut in this case refers to the coordinate system of the 3D object model.

If TransformationTransformationTransformationTransformationtransformation is set to 'model_to_ref'"model_to_ref""model_to_ref""model_to_ref""model_to_ref", it is assumed that PoseInPoseInPoseInPoseInposeIn refers to the coordinate system of the 3D object model. The resulting output pose PoseOutPoseOutPoseOutPoseOutposeOut in this case refers to the reference coordinate system of the 3D shape model.

The relative pose of the two coordinate systems can be queried by passing 'reference_pose'"reference_pose""reference_pose""reference_pose""reference_pose" for GenParamNameGenParamNameGenParamNameGenParamNamegenParamName in the operator get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsGetShapeModel3dParams.

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

Result

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

Possible Predecessors

find_shape_model_3dfind_shape_model_3dFindShapeModel3dFindShapeModel3dFindShapeModel3d

Alternatives

hom_mat3d_translatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslateHomMat3dTranslate, hom_mat3d_rotatehom_mat3d_rotateHomMat3dRotateHomMat3dRotateHomMat3dRotate

Module

3D Metrology