Index of all regions containing a given pixel.
The operator get_region_index returns the index of all regions in Regions (value range 0 to n-1) containing the test pixel (Row,Column), i.e.:
|Region[n] intersection {(Row,Column)}| = 1
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 |
| Region to be examined. | |
|
Row (input_control) |
point.y -> integer |
| Line index of the test pixel. | |
| Default value: 100 | |
| Range of values: 0 <= Row <= 512 (lin) | |
| Minimum increment: 1 | |
|
Recommended increment: 1 | |
|
Column (input_control) |
point.x -> integer |
| Column index of the test pixel. | |
| Default value: 100 | |
| Range of values: 0 <= Column <= 512 (lin) | |
| Minimum increment: 1 | |
|
Recommended increment: 1 | |
|
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 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 is raised.
threshold__, regiongrowing__, connection
get_mbutton, get_mposition, inside_region2