select_xld_pointselect_xld_pointselect_xld_pointSelectXldPointSelectXldPoint (Operator)

Name

select_xld_pointselect_xld_pointselect_xld_pointSelectXldPointSelectXldPoint — Choose all contours or polygons containing a given point.

Signature

Description

The operator select_xld_pointselect_xld_pointselect_xld_pointSelectXldPointSelectXldPoint selects all contours or polygons from XLDsXLDsXLDsXLDsXLDs containing the test point (RowRowRowRowrow,ColumnColumnColumnColumncolumn). If the contours or polygons overlap, more than one contour or polygon might contain the point. In this case, all these contours or polygons are returned. If no contour or polygon contains the indicated point, an empty object is returned. It is assumed that the contours or polygons are closed. If this is not the case, select_xld_pointselect_xld_pointselect_xld_pointSelectXldPointSelectXldPoint will artificially close the contours or polygons. Nevertheless, it is strongly recommended to pass only meaningful and closed contours or polygons in XLDsXLDsXLDsXLDsXLDs by calling select_contours_xldselect_contours_xldselect_contours_xldSelectContoursXldSelectContoursXld with the parameter 'closed'"closed""closed""closed""closed" before calling select_xld_pointselect_xld_pointselect_xld_pointSelectXldPointSelectXldPoint.

Attention

If the test point is on the border of a contour or polygon, select_xld_pointselect_xld_pointselect_xld_pointSelectXldPointSelectXldPoint will deliver unpredictable results, i.e., the contour or polygon may be or may not be added to DestXLDsDestXLDsDestXLDsDestXLDsdestXLDs, depending on arbitrary factors such as how the polygon is oriented with respect to the coordinate system. Note further that for points in the near proximity of the contour or polygon sides, a reliable classification is practically impossible because of numerical inaccuracies.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.

Parameters

Result

The operator select_xld_pointselect_xld_pointselect_xld_pointSelectXldPointSelectXldPoint returns the value 2 (H_MSG_TRUE) if the parameters are correct. The behavior in case of empty input (no input contours or polygons available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary an exception is raised.

Possible Predecessors

select_contours_xldselect_contours_xldselect_contours_xldSelectContoursXldSelectContoursXld, close_contours_xldclose_contours_xldclose_contours_xldCloseContoursXldCloseContoursXld, threshold_sub_pixthreshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPix

Alternatives

test_xld_pointtest_xld_pointtest_xld_pointTestXldPointTestXldPoint

Module

Foundation