projective_trans_object_model_3dT_projective_trans_object_model_3dProjectiveTransObjectModel3dProjectiveTransObjectModel3d (Operator)
Name
projective_trans_object_model_3dT_projective_trans_object_model_3dProjectiveTransObjectModel3dProjectiveTransObjectModel3d — Apply an arbitrary projective 3D transformation to 3D object models.
Signature
Description
projective_trans_object_model_3dprojective_trans_object_model_3dProjectiveTransObjectModel3dProjectiveTransObjectModel3dProjectiveTransObjectModel3d 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 HomMat3DHomMat3DHomMat3DHomMat3DhomMat3D (see
projective_trans_point_3dprojective_trans_point_3dProjectiveTransPoint3dProjectiveTransPoint3dProjectiveTransPoint3d).
The transformation matrix can be created, e.g., using the operator
vector_to_hom_mat3dvector_to_hom_mat3dVectorToHomMat3dVectorToHomMat3dVectorToHomMat3d.
Attention
projective_trans_object_model_3dprojective_trans_object_model_3dProjectiveTransObjectModel3dProjectiveTransObjectModel3dProjectiveTransObjectModel3d 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_3drigid_trans_object_model_3dRigidTransObjectModel3dRigidTransObjectModel3dRigidTransObjectModel3d must be used.
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
ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D (input_control) object_model_3d(-array) → HObjectModel3D, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handles of the 3D object models.
HomMat3DHomMat3DHomMat3DHomMat3DhomMat3D (input_control) hom_mat3d → HHomMat3D, HTupleHTupleHtuple (real) (double) (double) (double)
Homogeneous projective transformation matrix.
ObjectModel3DProjectiveTransObjectModel3DProjectiveTransObjectModel3DProjectiveTransObjectModel3DProjectiveTransobjectModel3DProjectiveTrans (output_control) object_model_3d(-array) → HObjectModel3D, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handles of the transformed 3D object models.
Result
If the parameters are valid, the operator
projective_trans_object_model_3dprojective_trans_object_model_3dProjectiveTransObjectModel3dProjectiveTransObjectModel3dProjectiveTransObjectModel3d returns the value 2 (H_MSG_TRUE).
If necessary, an exception is raised.
Possible Predecessors
read_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3dReadObjectModel3d,
xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3dXyzToObjectModel3d
Possible Successors
project_object_model_3dproject_object_model_3dProjectObjectModel3dProjectObjectModel3dProjectObjectModel3d,
object_model_3d_to_xyzobject_model_3d_to_xyzObjectModel3dToXyzObjectModel3dToXyzObjectModel3dToXyz
See also
affine_trans_point_3daffine_trans_point_3dAffineTransPoint3dAffineTransPoint3dAffineTransPoint3d,
rigid_trans_object_model_3drigid_trans_object_model_3dRigidTransObjectModel3dRigidTransObjectModel3dRigidTransObjectModel3d,
affine_trans_object_model_3daffine_trans_object_model_3dAffineTransObjectModel3dAffineTransObjectModel3dAffineTransObjectModel3d
Module
3D Metrology