projective_trans_object_model_3d — Apply an arbitrary projective 3D transformation to 3D object models.
projective_trans_object_model_3d applies an arbitrary projective 3D transformation to the points of 3D object models and returns the handles of the transformed 3D object models. The projective transformation is described by the homogeneous transformation matrix given in HomMat3D (see projective_trans_point_3d).
The transformation matrix can be created, e.g., using the operator vector_to_hom_mat3d.
Note that if a 3D object model is no longer needed or should be overwritten, the memory has to be freed first by calling the operator clear_object_model_3d.
projective_trans_object_model_3d transforms the attributes of type 3D points. Attributes of type shape model for shape-based 3D matching, of type 3D primitive, and of type normals are not transformed. Therefore, these attributes do not exist in the transformed 3D object model. All other attributes are copied without modification. To transform 3D primitives, the operator rigid_trans_object_model_3d must be used.
Handles of the 3D object models.
Homogeneous projective transformation matrix.
Handles of the transformed 3D object models.
If the parameters are valid, the operator projective_trans_object_model_3d returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.
affine_trans_point_3d, rigid_trans_object_model_3d, affine_trans_object_model_3d