| Operators |
test_region_point — Test if the region contains a given point.
If an array of regions and one test point is provided, test_region_point tests if at least one input region of Regions contains the single test point given in (Row,Column). If this is the case, IsInside is set to TRUE, else to FALSE. Alternatively, if a single region and several test points are provided, test_region_point tests if at least one of the test points (given in Row,Column) is contained in the input region given in Regions. If this is the case, IsInside is set to TRUE, otherwise it is set to FALSE. If (Row,Column) 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 IsInside is set to FALSE.
In case of an empty input object (empty tuple) Regions and set_system('no_object_result','true'), an empty tuple is returned in IsInside. If set_system('no_object_result','false') was set, an exception is raised.
Region(s) to be examined.
Row index of the test pixel(s).
Default value: 100
Column index of the test pixel(s).
Number of elements: Row == Column
Default value: 100
Boolean result value.
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.
The operator test_region_point returns the value 2 (H_MSG_TRUE) if the parameters are correct. The behavior in case of an empty object is set via the operator set_system('no_object_result',<Result>). If necessary, an exception is raised.
threshold, regiongrowing, connection
union1, intersection, area_center
Foundation
| Operators |