intersection_contours_xldintersection_contours_xldIntersectionContoursXldIntersectionContoursXld (Operator)
Name
intersection_contours_xldintersection_contours_xldIntersectionContoursXldIntersectionContoursXld — Calculate the intersection points of two XLD contours
Signature
Herror intersection_contours_xld(const Hobject Contour1, const Hobject Contour2, const char* IntersectionType, double* Row, double* Column, Hlong* IsOverlapping)
Herror T_intersection_contours_xld(const Hobject Contour1, const Hobject Contour2, const Htuple IntersectionType, Htuple* Row, Htuple* Column, Htuple* IsOverlapping)
Description
intersection_contours_xldintersection_contours_xldIntersectionContoursXldIntersectionContoursXldIntersectionContoursXld calculates the intersection points of the
XLD Contour1Contour1Contour1Contour1contour1 and XLD Contour2Contour2Contour2Contour2contour2 which, if any, are returned
in (RowRowRowRowrow,ColumnColumnColumnColumncolumn). The value in
IntersectionTypeIntersectionTypeIntersectionTypeIntersectionTypeintersectionType defines the way to calculate the
intersections points. By setting
IntersectionTypeIntersectionTypeIntersectionTypeIntersectionTypeintersectionType = 'self'"self""self""self""self", only the self intersections
within both contours are returned, i.e., the intersections within
Contour1Contour1Contour1Contour1contour1 and XLD Contour2Contour2Contour2Contour2contour2. For
IntersectionTypeIntersectionTypeIntersectionTypeIntersectionTypeintersectionType = 'mutual'"mutual""mutual""mutual""mutual", only the intersections
between both contours are taken into account. The default value is
IntersectionTypeIntersectionTypeIntersectionTypeIntersectionTypeintersectionType = 'all'"all""all""all""all". In this case both, the self
and the mutual intersections are returned in RowRowRowRowrow,ColumnColumnColumnColumncolumn).
If parts of the contours overlap in more than one point
IsOverlappingIsOverlappingIsOverlappingIsOverlappingisOverlapping returns the value 1, otherwise 0 is returned.
IsOverlappingIsOverlappingIsOverlappingIsOverlappingisOverlapping is set with regard to both the self and mutual
overlap, regardless of the setting in IntersectionTypeIntersectionTypeIntersectionTypeIntersectionTypeintersectionType.
In case of a mutual overlap, the endpoints of the mutual 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
Contour1Contour1Contour1Contour1contour1 (input_object) xld_cont → objectHXLDContHXLDContHobject
First XLD contour.
Contour2Contour2Contour2Contour2contour2 (input_object) xld_cont → objectHXLDContHXLDContHobject
Second XLD contour.
IntersectionTypeIntersectionTypeIntersectionTypeIntersectionTypeintersectionType (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Intersection points to be returned.
Default value:
'all'
"all"
"all"
"all"
"all"
List of values: 'all'"all""all""all""all", 'mutual'"mutual""mutual""mutual""mutual", 'self'"self""self""self""self"
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 a contour lie above another contour part?
Result
If the parameters are valid, the operator intersection_contours_xldintersection_contours_xldIntersectionContoursXldIntersectionContoursXldIntersectionContoursXld
returns the value 2 (H_MSG_TRUE).
Alternatives
intersection_segmentsintersection_segmentsIntersectionSegmentsIntersectionSegmentsIntersectionSegments,
intersection_segment_contour_xldintersection_segment_contour_xldIntersectionSegmentContourXldIntersectionSegmentContourXldIntersectionSegmentContourXld
See also
intersection_segment_lineintersection_segment_lineIntersectionSegmentLineIntersectionSegmentLineIntersectionSegmentLine,
intersection_linesintersection_linesIntersectionLinesIntersectionLinesIntersectionLines,
intersection_line_contour_xldintersection_line_contour_xldIntersectionLineContourXldIntersectionLineContourXldIntersectionLineContourXld
Module
Foundation