test_xld_pointtest_xld_pointTestXldPointTestXldPointtest_xld_point (算子)

名称

test_xld_pointtest_xld_pointTestXldPointTestXldPointtest_xld_point — 测试一个或多个轮廓或多边形是否包围了给定点。

签名

描述

test_xld_pointtest_xld_pointTestXldPointTestXldPointTestXldPointtest_xld_point tests whether a test point (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn) is enclosed by a contour or polygon XLDXLDXLDXLDXLDxld and returns the result in IsInsideIsInsideIsInsideIsInsideisInsideis_inside. If the input point is enclosed by the contour or polygon, the return value is 1, otherwise 0. In the case of a single test point and multiple contours or polygons, the (i-1)-th element of the resulting tuple IsInsideIsInsideIsInsideIsInsideisInsideis_inside indicates, whether the point is enclosed by the i-th contour or polygon. In the case of multiple test points and a single contour or polygon, the i-th element of the resulting tuple IsInsideIsInsideIsInsideIsInsideisInsideis_inside indicates, whether the i-th point is enclosed by the contour or polygon. In the case of multiple test points and multiple contours or polygons, the (i-1)-th element of the resulting tuple IsInsideIsInsideIsInsideIsInsideisInsideis_inside indicates, whether the (i-1)-th point is enclosed by the i-th contour or polygon (the subscription differs, because the indexing of the results tuple starts with 0 in contrast to the indexing of object tuples). In this case the number of input points must be equal to the number of contours or polygons.假设轮廓或多边形是闭合的。 If this is not the case test_xld_pointtest_xld_pointTestXldPointTestXldPointTestXldPointtest_xld_point will artificially close the contour. Nevertheless it is strongly recommended to pass only meaningful and closed contours or polygons in XLDXLDXLDXLDXLDxld。

注意

If a test point is on the border of the contour or polygon, test_xld_pointtest_xld_pointTestXldPointTestXldPointTestXldPointtest_xld_point will deliver unpredictable results, i.e. the result may be 0 or 1 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.

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

参数

结果

test_xld_pointtest_xld_pointTestXldPointTestXldPointTestXldPointtest_xld_point 在输入不为空时返回 2 ( H_MSG_TRUE )。如果输入为空则可设置行为通过 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

模块

基础