test_region_pointtest_region_pointTestRegionPointTestRegionPointtest_region_point (算子名称)
名称
test_region_pointtest_region_pointTestRegionPointTestRegionPointtest_region_point — Test if the region contains a given point.
参数签名
Herror test_region_point(const Hobject 区域, const Hlong Row, const Hlong Column, Hlong* IsInside)
Herror T_test_region_point(const Hobject 区域, const Htuple Row, const Htuple Column, Htuple* IsInside)
def test_region_point(区域: HObject, row: MaybeSequence[Union[int, float]], column: MaybeSequence[Union[int, float]]) -> int
描述
If an array of regions and one test point is provided,
test_region_pointtest_region_pointTestRegionPointTestRegionPointTestRegionPointtest_region_point tests if at least one input region of
区域区域区域区域区域区域 contains the single test point given in
(RowRowRowRowrowrow,ColumnColumnColumnColumncolumncolumn). If this is the case, IsInsideIsInsideIsInsideIsInsideisInsideis_inside is
set to TRUE, else to FALSE. Alternatively, if a single region and several
test points are provided, test_region_pointtest_region_pointTestRegionPointTestRegionPointTestRegionPointtest_region_point tests if at least
one of the test points (given in RowRowRowRowrowrow,ColumnColumnColumnColumncolumncolumn) is contained
in the input region given in 区域区域区域区域区域区域.
If this is the case, IsInsideIsInsideIsInsideIsInsideisInsideis_inside is set to TRUE, otherwise it is set
to FALSE. If (RowRowRowRowrowrow,ColumnColumnColumnColumncolumncolumn) are real-valued, rounding is
performed internally since regions are pixel precise.
注意
The test pixel is not contained in an empty region
(no pixel of the region corresponds to the pixel).
If all regions are empty IsInsideIsInsideIsInsideIsInsideisInsideis_inside is set to
FALSE.
In case of an empty input object (empty tuple) 区域区域区域区域区域区域 and
set_system('no_object_result','true')set_system("no_object_result","true")SetSystem("no_object_result","true")SetSystem("no_object_result","true")SetSystem("no_object_result","true")set_system("no_object_result","true"), an empty tuple is
returned in IsInsideIsInsideIsInsideIsInsideisInsideis_inside. If
set_system('no_object_result','false')set_system("no_object_result","false")SetSystem("no_object_result","false")SetSystem("no_object_result","false")SetSystem("no_object_result","false")set_system("no_object_result","false") was set, an exception is
raised.
运行信息
- 多线程类型:可重入(与非独占操作符并行运行)。
- 多线程作用域:全局(可以从任何线程调用)。
- 未经并行化处理。
参数表
区域区域区域区域区域区域 (input_object) region(-array) → objectHRegionHObjectHRegionHobject
Region(s) to be examined.
RowRowRowRowrowrow (input_control) point.y(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Row index of the test pixel(s).
Default:
100
ColumnColumnColumnColumncolumncolumn (input_control) point.x(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Column index of the test pixel(s).
Number of elements:
Row == Column
Default:
100
IsInsideIsInsideIsInsideIsInsideisInsideis_inside (output_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Boolean result value.
Complexity
If F is the area of one region, N is the number of regions, and M is
the number of test points, the runtime complexity is
O(ln(sqrt(F)) * N) in the case of one test point and several regions and
O(ln(sqrt(F)) * M) in the case of one region and several test points.
结果
该算子 test_region_pointtest_region_pointTestRegionPointTestRegionPointTestRegionPointtest_region_point 返回值 2 (
H_MSG_TRUE)
如果参数都是正确的。
The behavior in case of an empty object is
set via 该算子 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>).
如有必要，将引发异常。
可能的前置算子
thresholdthresholdThresholdThresholdThresholdthreshold,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing,
connectionconnectionConnectionConnectionConnectionconnection
可替代算子
union1union1Union1Union1Union1union1,
intersectionintersectionIntersectionIntersectionIntersectionintersection,
area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center
参考其它
select_region_pointselect_region_pointSelectRegionPointSelectRegionPointSelectRegionPointselect_region_point
模块
Foundation