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 lie 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