Index of all regions containing a given pixel.
The operator get_region_index returns the index of all regions in Regions (range of values: 1 to n) containing the test pixel (Row,Column), i.e.:
|Region[n] intersection {(Row,Column)}| = {(Row,Column)}
The returned indices can be used, e.g., in select_obj to
select the regions containing the test pixel.
If the regions overlap more than one region might contain the pixel. In this case all these regions are returned. If no region contains the indicated pixel the empty tuple (= no region) is returned.
|
Regions (input_object) |
region-array -> object |
| Regions to be examined. | |
|
Row (input_control) |
point.y -> integer |
| Line index of the test pixel. | |
| Default value: 100 | |
| Typical range of values: -oo <= Row <= -oo (lin) | |
|
Column (input_control) |
point.x -> integer |
| Column index of the test pixel. | |
| Default value: 100 | |
| Typical range of values: -oo <= Column <= -oo (lin) | |
|
Index (output_control) |
integer(-array) -> integer |
| Index of the regions containing the test pixel. | |
If F is the area of the region and N is the number of regions the mean runtime complexity is O(ln(sqrt(F)) * N).
The operator get_region_index returns the value 2 (H_MSG_TRUE) if the parameters are correct. The behavior in case of empty input (no input regions available) is set via the operator set_system('no_object_result',<Result>). If necessary an exception handling is raised.
get_region_index is reentrant and automatically parallelized (on tuple level).
threshold, regiongrowing, connection
get_mbutton, get_mposition, test_region_point
Region processing
