intersect_line_plane_object_model_3dT_intersect_line_plane_object_model_3dIntersectLinePlaneObjectModel3dIntersectLinePlaneObjectModel3dintersect_line_plane_object_model_3d (Operator)
Name
intersect_line_plane_object_model_3dT_intersect_line_plane_object_model_3dIntersectLinePlaneObjectModel3dIntersectLinePlaneObjectModel3dintersect_line_plane_object_model_3d — Intersect a line with a plane.
Signature
intersect_line_plane_object_model_3d( : : ObjectModel3DPlane, PX, PY, PZ, QX, QY, QZ, GenParamName, GenParamValue : X, Y, Z, Index)
Herror T_intersect_line_plane_object_model_3d(const Htuple ObjectModel3DPlane, const Htuple PX, const Htuple PY, const Htuple PZ, const Htuple QX, const Htuple QY, const Htuple QZ, const Htuple GenParamName, const Htuple GenParamValue, Htuple* X, Htuple* Y, Htuple* Z, Htuple* Index)
void IntersectLinePlaneObjectModel3d(const HTuple& ObjectModel3DPlane, const HTuple& PX, const HTuple& PY, const HTuple& PZ, const HTuple& QX, const HTuple& QY, const HTuple& QZ, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* X, HTuple* Y, HTuple* Z, HTuple* Index)
static void HObjectModel3D::IntersectLinePlaneObjectModel3d(const HObjectModel3DArray& ObjectModel3DPlane, const HTuple& PX, const HTuple& PY, const HTuple& PZ, const HTuple& QX, const HTuple& QY, const HTuple& QZ, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* X, HTuple* Y, HTuple* Z, HTuple* Index)
void HObjectModel3D::IntersectLinePlaneObjectModel3d(double PX, double PY, double PZ, double QX, double QY, double QZ, const HTuple& GenParamName, const HTuple& GenParamValue, double* X, double* Y, double* Z, Hlong* Index) const
static void HOperatorSet.IntersectLinePlaneObjectModel3d(HTuple objectModel3DPlane, HTuple PX, HTuple PY, HTuple PZ, HTuple QX, HTuple QY, HTuple QZ, HTuple genParamName, HTuple genParamValue, out HTuple x, out HTuple y, out HTuple z, out HTuple index)
static void HObjectModel3D.IntersectLinePlaneObjectModel3d(HObjectModel3D[] objectModel3DPlane, HTuple PX, HTuple PY, HTuple PZ, HTuple QX, HTuple QY, HTuple QZ, HTuple genParamName, HTuple genParamValue, out HTuple x, out HTuple y, out HTuple z, out HTuple index)
void HObjectModel3D.IntersectLinePlaneObjectModel3d(double PX, double PY, double PZ, double QX, double QY, double QZ, HTuple genParamName, HTuple genParamValue, out double x, out double y, out double z, out int index)
def intersect_line_plane_object_model_3d(object_model_3dplane: MaybeSequence[HHandle], px: MaybeSequence[Union[int, float]], py: MaybeSequence[Union[int, float]], pz: MaybeSequence[Union[int, float]], qx: MaybeSequence[Union[int, float]], qy: MaybeSequence[Union[int, float]], qz: MaybeSequence[Union[int, float]], gen_param_name: Sequence[str], gen_param_value: Sequence[str]) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[int]]
def intersect_line_plane_object_model_3d_s(object_model_3dplane: MaybeSequence[HHandle], px: MaybeSequence[Union[int, float]], py: MaybeSequence[Union[int, float]], pz: MaybeSequence[Union[int, float]], qx: MaybeSequence[Union[int, float]], qy: MaybeSequence[Union[int, float]], qz: MaybeSequence[Union[int, float]], gen_param_name: Sequence[str], gen_param_value: Sequence[str]) -> Tuple[float, float, float, int]
Description
intersect_line_plane_object_model_3dintersect_line_plane_object_model_3dIntersectLinePlaneObjectModel3dIntersectLinePlaneObjectModel3dintersect_line_plane_object_model_3d intersects a line with
a plane given as a 3D object model that is specified by the parameter ObjectModel3DPlaneObjectModel3DPlaneObjectModel3DPlaneobjectModel3DPlaneobject_model_3dplane.
A plane can be created using gen_plane_object_model_3dgen_plane_object_model_3dGenPlaneObjectModel3dGenPlaneObjectModel3dgen_plane_object_model_3d.
The line is defined by a starting point P (PXPXPXPXpx, PYPYPYPYpy, PZPZPZPZpz)
and end point Q (QXQXQXQXqx, QYQYQYQYqy, QZQZQZQZqz).
The following generic parameters GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name and the
corresponding values GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value are supported:
- 'plane_mode'"plane_mode""plane_mode""plane_mode""plane_mode":
-
Specifies the plane mode.
The modes 'extent'"extent""extent""extent""extent" and
'infinite'"infinite""infinite""infinite""infinite" are supported.
Default:
'extent'"extent""extent""extent""extent".
The result is a 3D point XXXxx, YYYyy, ZZZzz, as well as an index IndexIndexIndexindexindex
which contains the indices of the input lines or planes which that have intersections.
Parameter Broadcasting
This operator supports parameter broadcasting.
This means that each parameter can be given as a tuple of length
1 or N.
Parameters with tuple length 1 will be repeated internally
such that the number of created items is always N.
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
ObjectModel3DPlaneObjectModel3DPlaneObjectModel3DPlaneobjectModel3DPlaneobject_model_3dplane (input_control) object_model_3d(-array) → HObjectModel3D, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of plane as 3D object model.
PXPXPXPXpx (input_control) point3d.x(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
X coordinate of the first point of the line.
PYPYPYPYpy (input_control) point3d.y(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Y coordinate of the first point of the line.
PZPZPZPZpz (input_control) point3d.z(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Z coordinate of the first point of the line.
QXQXQXQXqx (input_control) point3d.x(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
X coordinate of the second point of the line.
QYQYQYQYqy (input_control) point3d.y(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Y coordinate of the second point of the line.
QZQZQZQZqz (input_control) point3d.z(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Z coordinate of the second point of the line.
GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name-array → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Names of the generic parameters.
Default:
[]
List of values:
'plane_mode'"plane_mode""plane_mode""plane_mode""plane_mode"
GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.value-array → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Values of the generic parameters.
Default:
[]
Suggested values:
'extent'"extent""extent""extent""extent", 'infinite'"infinite""infinite""infinite""infinite"
XXXxx (output_control) point3d.x(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Resulting X coordinate of the intersection point.
YYYyy (output_control) point3d.y(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Resulting Y coordinate of the intersection point.
ZZZzz (output_control) point3d.z(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Resulting Z coordinate of the intersection point.
IndexIndexIndexindexindex (output_control) number(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the intersection point.
Example (HDevelop)
gen_plane_object_model_3d ([0.1,0.2,0.3,110,110,0,0], [30, 0, -30, 0], [0, 30, 0, -30], Plane)
P:= [10.2,0.3,30]
Q:= [-10.2,0.3,-30]
intersect_line_plane_object_model_3d( Plane,P[0], P[1], P[2], Q[0], Q[1], Q[2],[], [], X, Y, Z, Index)
gen_object_model_3d_from_points ([P[0], Q[0]],[P[1], Q[1]],[P[2], Q[2]], LineModel3D)
set_object_model_3d_attrib_mod (LineModel3D, 'lines', [], [2,0,1])
gen_sphere_object_model_3d_center (X, Y, Z, 0.5, IntersectionModel3D)
dev_get_window (WindowHandle)
visualize_object_model_3d (WindowHandle, [Plane, LineModel3D, IntersectionModel3D], [], [], [], \
[], [], [], [], PoseOut)
Result
intersect_line_plane_object_model_3dintersect_line_plane_object_model_3dIntersectLinePlaneObjectModel3dIntersectLinePlaneObjectModel3dintersect_line_plane_object_model_3d returns 2 (
H_MSG_TRUE)
if all parameters
are correct. If necessary, an exception is raised.
Possible Predecessors
gen_plane_object_model_3dgen_plane_object_model_3dGenPlaneObjectModel3dGenPlaneObjectModel3dgen_plane_object_model_3d,
get_line_of_sightget_line_of_sightGetLineOfSightGetLineOfSightget_line_of_sight,
affine_trans_point_3daffine_trans_point_3dAffineTransPoint3dAffineTransPoint3daffine_trans_point_3d
Possible Successors
gen_object_model_3d_from_pointsgen_object_model_3d_from_pointsGenObjectModel3dFromPointsGenObjectModel3dFromPointsgen_object_model_3d_from_points
See also
intersect_plane_object_model_3dintersect_plane_object_model_3dIntersectPlaneObjectModel3dIntersectPlaneObjectModel3dintersect_plane_object_model_3d
Module
3D Metrology