intersection_contours_xldintersection_contours_xldIntersectionContoursXldIntersectionContoursXld (Operator)

Name

intersection_contours_xldintersection_contours_xldIntersectionContoursXldIntersectionContoursXld — Calculate the intersection points of two XLD contours

Signature

intersection_contours_xld(Contour1, Contour2 : : IntersectionType : Row, Column, 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 → object

First XLD contour.

Contour2Contour2Contour2Contour2contour2 (input_object) xld_cont → object

Second XLD contour.

IntersectionTypeIntersectionTypeIntersectionTypeIntersectionTypeintersectionType (input_control) string → (string)

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) → (real)

Row coordinates of the intersection points.

ColumnColumnColumnColumncolumn (output_control) point.x(-array) → (real)

Column coordinates of the intersection points.

IsOverlappingIsOverlappingIsOverlappingIsOverlappingisOverlapping (output_control) integer → (integer)

Does a part of a contour lies 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

Module

Foundation

Operators