select_xld_pointselect_xld_pointSelectXldPointSelectXldPoint (Operator)

Name

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

Signature

Description

The operator select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint 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_pointSelectXldPointSelectXldPointSelectXldPoint 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_xldSelectContoursXldSelectContoursXldSelectContoursXld with the parameter 'closed'"closed""closed""closed""closed" before calling select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint.

Attention

If the test point is on the border of a contour or polygon, select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPoint 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.

Execution Information

• 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_pointSelectXldPointSelectXldPointSelectXldPoint 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>)SetSystem("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_xldSelectContoursXldSelectContoursXldSelectContoursXld, close_contours_xldclose_contours_xldCloseContoursXldCloseContoursXldCloseContoursXld, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPix

Alternatives

test_xld_pointtest_xld_pointTestXldPointTestXldPointTestXldPoint

Module

Foundation