gen_plane_object_model_3d — Create a 3D object model that represents a plane.
gen_plane_object_model_3d creates a planar 3D primitive, i.e., a 3D object model that represents a plane. The plane is described by its center and rotation. The normal vector of the plane is aligned to the z-axis of the rotated coordinate system. The center and the rotation is set with the parameter Pose. Additionally, the plane can be limited by a polygon, that is defined by points with the coordinates XExtent and YExtent. The handle of the 3D object model is returned by the parameter ObjectModel3D.
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.
This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.
The center and the rotation of the plane.
Number of elements: Pose == 7
x coordinates specifying the extent of the plane.
y coordinates specifying the extent of the plane.
Number of elements: XExtent == YExtent
Handle of the resulting 3D object model.
gen_plane_object_model_3d returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.
get_object_model_3d_params, sample_object_model_3d, clear_object_model_3d
gen_cylinder_object_model_3d, gen_sphere_object_model_3d, gen_sphere_object_model_3d_center, gen_box_object_model_3d