test_self_intersection_xld (Operator)

Name

test_self_intersection_xld — Test XLD contours or polygons for self intersection.

Synopsis

test_self_intersection_xld(XLD : : CloseXLD : DoesIntersect)

Description

test_self_intersection_xld tests whether the input contours or polygons in XLD intersect themselves. The output array DoesIntersect contains a 1 if the corresponding input contour or polygon intersects itself and 0 otherwise.

If the input parameter CloseXLD is set to 'true', open contours or polygons are closed before the check is performed by simply connecting the first and the last contour or polygon point with a line segment.

If a contour or polygon only touches itself, it is not considered as self intersecting.

Attention

A contour or polygon touches itself if a contour or polygon point lies exactly on a contour or polygon segment. However, whether a point lies exactly on a contour or polygon segment or not can practically not be decided because of numerical reasons.

Parameters

XLD (input_object)	xld(-array) → object
Input contours or polygons.

CloseXLD (input_control)	string → (string)
Should the input contours or polygons be closed first?
Default value: 'true'
List of values: 'true', 'false'

DoesIntersect (output_control)	number(-array) → (integer)
1 for contours or polygons with self intersection and 0 otherwise.

Parallelization Information

test_self_intersection_xld is reentrant and automatically parallelized (on tuple level).

Module

Foundation