select_xld_pointselect_xld_pointSelectXldPointSelectXldPointselect_xld_point (算子名称)

名称

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

参数签名

描述

The operator select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPointselect_xld_point selects all contours or polygons from XLDsXLDsXLDsXLDsXLDsxlds containing the test point (RowRowRowRowrowrow,ColumnColumnColumnColumncolumncolumn). 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_pointSelectXldPointSelectXldPointSelectXldPointselect_xld_point will artificially close the contours or polygons. Nevertheless, it is strongly recommended to pass only meaningful and closed contours or polygons in XLDsXLDsXLDsXLDsXLDsxlds by calling select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXldselect_contours_xld with the parameter 'closed'"closed""closed""closed""closed""closed" before calling select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPointselect_xld_point.

注意

If the test point is on the border of a contour or polygon, select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPointselect_xld_point will deliver unpredictable results, i.e., the contour or polygon may be or may not be added to DestXLDsDestXLDsDestXLDsDestXLDsdestXLDsdest_xlds, 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.

运行信息

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

参数表

结果

The operator select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPointselect_xld_point 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>)set_system("no_object_result",<Result>). If necessary an exception is raised.

可能的前置算子

select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXldselect_contours_xld, close_contours_xldclose_contours_xldCloseContoursXldCloseContoursXldCloseContoursXldclose_contours_xld, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPixthreshold_sub_pix

可替代算子

test_xld_pointtest_xld_pointTestXldPointTestXldPointTestXldPointtest_xld_point

模块

Foundation

---