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

affine_trans_object_model_3d 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 HomMat3D.

The transformation matrix can be created using the operators hom_mat3d_identity, hom_mat3d_scale, hom_mat3d_rotate, hom_mat3d_translate, etc., or be the result of pose_to_hom_mat3d (see affine_trans_point_3d).

In general, the operator affine_trans_object_model_3d 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 RefRotX, RefRotY, RefRotZ, and OrderOfRotation should be passed to the operator create_shape_model_3d.

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

affine_trans_object_model_3d is processed completely exclusively without parallelization.

read_object_model_3d_dxf

project_object_model_3d

affine_trans_point_3d

3D Metrology