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