get_region_index ( Regions : : Row, Column : Index )

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


Attention

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.


Parameters

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.


Complexity

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).


Result

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.


Possible Predecessors

threshold__, regiongrowing__, connection


Alternatives

inside_region1


See also

get_mbutton, get_mposition, inside_region2



Copyright © 1996-1997 MVTec Software GmbH