intersection_line_contour_xldintersection_line_contour_xldIntersectionLineContourXldIntersectionLineContourXld (Operator)
Name
intersection_line_contour_xldintersection_line_contour_xldIntersectionLineContourXldIntersectionLineContourXld
— Calculate the intersection points of a line and an XLD contour
Signature
Herror intersection_line_contour_xld(const Hobject Contour, double LineRow1, double LineColumn1, double LineRow2, double LineColumn2, double* Row, double* Column, Hlong* IsOverlapping)
Herror T_intersection_line_contour_xld(const Hobject Contour, const Htuple LineRow1, const Htuple LineColumn1, const Htuple LineRow2, const Htuple LineColumn2, Htuple* Row, Htuple* Column, Htuple* IsOverlapping)
Description
intersection_line_contour_xldintersection_line_contour_xldIntersectionLineContourXldIntersectionLineContourXldIntersectionLineContourXld
calculates the intersection points
of a line and an XLD ContourContourContourContourcontour
. The line is defined by the points
(LineRow1LineRow1LineRow1LineRow1lineRow1
,LineColumn1LineColumn1LineColumn1LineColumn1lineColumn1
) and
(LineRow2LineRow2LineRow2LineRow2lineRow2
,LineColumn2LineColumn2LineColumn2LineColumn2lineColumn2
).
The intersection points, if any, are returned in
(RowRowRowRowrow
,ColumnColumnColumnColumncolumn
).
If a part of the XLD contour lies on the line
IsOverlappingIsOverlappingIsOverlappingIsOverlappingisOverlapping
returns the value 1, otherwise 0 is returned.
In this case the endpoints of the XLD segment
are returned in (RowRowRowRowrow
,ColumnColumnColumnColumncolumn
).
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
ContourContourContourContourcontour
(input_object) xld_cont →
objectHXLDContHXLDContHobject
XLD contour.
LineRow1LineRow1LineRow1LineRow1lineRow1
(input_control) point.y →
HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Row coordinate of the first point of the line.
LineColumn1LineColumn1LineColumn1LineColumn1lineColumn1
(input_control) point.x →
HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Column coordinate of the first point of the line.
LineRow2LineRow2LineRow2LineRow2lineRow2
(input_control) point.y →
HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Row coordinate of the second point of the line.
LineColumn2LineColumn2LineColumn2LineColumn2lineColumn2
(input_control) point.x →
HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Column coordinate of the second point of the line.
RowRowRowRowrow
(output_control) point.y(-array) →
HTupleHTupleHtuple (real) (double) (double) (double)
Row coordinates of the intersection points.
ColumnColumnColumnColumncolumn
(output_control) point.x(-array) →
HTupleHTupleHtuple (real) (double) (double) (double)
Column coordinates of the intersection points.
IsOverlappingIsOverlappingIsOverlappingIsOverlappingisOverlapping
(output_control) integer →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Does a part of the XLD contour lies on the line?
Result
If the parameters are valid, the operator
intersection_line_contour_xldintersection_line_contour_xldIntersectionLineContourXldIntersectionLineContourXldIntersectionLineContourXld
returns the value 2 (H_MSG_TRUE).
Alternatives
intersection_segment_lineintersection_segment_lineIntersectionSegmentLineIntersectionSegmentLineIntersectionSegmentLine
See also
intersection_segmentsintersection_segmentsIntersectionSegmentsIntersectionSegmentsIntersectionSegments
,
intersection_linesintersection_linesIntersectionLinesIntersectionLinesIntersectionLines
,
intersection_segment_contour_xldintersection_segment_contour_xldIntersectionSegmentContourXldIntersectionSegmentContourXldIntersectionSegmentContourXld
,
intersection_contours_xldintersection_contours_xldIntersectionContoursXldIntersectionContoursXldIntersectionContoursXld
Module
Foundation