select_xld_pointselect_xld_pointSelectXldPointSelectXldPointselect_xld_point (算子)

名称

select_xld_pointselect_xld_pointSelectXldPointSelectXldPointselect_xld_point — 选择包含给定点的所有轮廓或多边形。

签名

描述

算子 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.假设轮廓或多边形是闭合的。 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.

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 在元组级别上自动并行化。

参数

结果

算子 select_xld_pointselect_xld_pointSelectXldPointSelectXldPointSelectXldPointselect_xld_point 在参数正确时返回值 2 ( H_MSG_TRUE )。 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>)。如有必要，则抛出异常。

可能的前趋

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

模块

基础