intersect_plane_object_model_3dT_intersect_plane_object_model_3dIntersectPlaneObjectModel3dIntersectPlaneObjectModel3dintersect_plane_object_model_3d (Operator)
Name
intersect_plane_object_model_3dT_intersect_plane_object_model_3dIntersectPlaneObjectModel3dIntersectPlaneObjectModel3dintersect_plane_object_model_3d — Intersect a 3D object model with a plane.
Signature
def intersect_plane_object_model_3d(object_model_3d: MaybeSequence[HHandle], plane: Sequence[Union[int, float]]) -> Sequence[HHandle]
def intersect_plane_object_model_3d_s(object_model_3d: MaybeSequence[HHandle], plane: Sequence[Union[int, float]]) -> HHandle
Description
intersect_plane_object_model_3dintersect_plane_object_model_3dIntersectPlaneObjectModel3dIntersectPlaneObjectModel3dIntersectPlaneObjectModel3dintersect_plane_object_model_3d intersects a 3D object model with
a plane that is defined by the x-y plane of the pose that is specified with
the parameter PlanePlanePlanePlaneplaneplane. The z-axis of the pose corresponds to the normal
of the plane.
The result is a set of 3D points connected by lines that is returned as 3D object model in
ObjectModel3DIntersectionObjectModel3DIntersectionObjectModel3DIntersectionObjectModel3DIntersectionobjectModel3DIntersectionobject_model_3dintersection.
Every triangle that intersects with the
plane creates two intersection points and a line between the two points.
The resulting set of lines is coplanar.
The lines can be displayed with disp_object_model_3ddisp_object_model_3dDispObjectModel3dDispObjectModel3dDispObjectModel3ddisp_object_model_3d and queried
with get_object_model_3d_paramsget_object_model_3d_paramsGetObjectModel3dParamsGetObjectModel3dParamsGetObjectModel3dParamsget_object_model_3d_params
using the parameter 'lines'"lines""lines""lines""lines""lines".
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on internal data level.
Parameters
ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3Dobject_model_3d (input_control) object_model_3d(-array) → HObjectModel3D, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the 3D object model.
PlanePlanePlanePlaneplaneplane (input_control) pose(-array) → HPose, HTupleSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Pose of the plane.
Default value: [0,0,0,0,0,0,0]
ObjectModel3DIntersectionObjectModel3DIntersectionObjectModel3DIntersectionObjectModel3DIntersectionobjectModel3DIntersectionobject_model_3dintersection (output_control) object_model_3d(-array) → HObjectModel3D, HTupleSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the 3D object model that describes
the intersection as a set of lines.
Example (HDevelop)
gen_object_model_3d_from_points (rand(20)-0.5, rand(20)-0.5,\
rand(20)-0.5, ObjectModel3D)
convex_hull_object_model_3d (ObjectModel3D, ObjectModel3DConvexHull)
intersect_plane_object_model_3d (ObjectModel3DConvexHull, [0,0,0,0,0,0,0], \
ObjectModel3DIntersection)
dev_get_window (WindowHandle)
visualize_object_model_3d (WindowHandle, [ObjectModel3DIntersection, \
ObjectModel3DConvexHull], [], [], \
['alpha_1'], [0.5], [], [], [], PoseOut)
Result
intersect_plane_object_model_3dintersect_plane_object_model_3dIntersectPlaneObjectModel3dIntersectPlaneObjectModel3dIntersectPlaneObjectModel3dintersect_plane_object_model_3d returns 2 (H_MSG_TRUE) if all parameters
are correct. If necessary, an exception is raised.
Possible Predecessors
read_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3dReadObjectModel3dread_object_model_3d,
select_points_object_model_3dselect_points_object_model_3dSelectPointsObjectModel3dSelectPointsObjectModel3dSelectPointsObjectModel3dselect_points_object_model_3d
Possible Successors
connection_object_model_3dconnection_object_model_3dConnectionObjectModel3dConnectionObjectModel3dConnectionObjectModel3dconnection_object_model_3d
See also
reduce_object_model_3d_by_viewreduce_object_model_3d_by_viewReduceObjectModel3dByViewReduceObjectModel3dByViewReduceObjectModel3dByViewreduce_object_model_3d_by_view
Module
3D Metrology