get_region_points ( Region : : : Rows, Columns )

Access the pixels of a region.

The operator get_region_points returns the region data in the form of coordinate lists. The coordinates are sorted in the following order:

          (r1,c1) <= (r2,c2) := r1 < r2 oder r1 = r2 und c1 <= c2
get_region_points returns the coordinates in the form of tuples. An empty region is passed as empty tuple.


Attention

Only one region may be passed.


Parameters

Region (input_object)
region -> object
This region is accessed.

Rows (output_control)
coordinates.y-array -> integer
Line numbers of the pixels in the region

Columns (output_control)
coordinates.x-array -> integer
Column numbers of the pixels in the region.
Number of elements: Columns == Rows


Result

The operator get_region_points normally returns the value 2 (H_MSG_TRUE). If more than one connection component is passed an exception handling is caused. The behavior in case of empty input (no input regions available) is set via the operator set_system('no_object_result',<Result>).


Parallelization Information

get_region_points is reentrant and processed without parallelization.


Possible Predecessors

sobel_amp, threshold, connection


Alternatives

get_region_runs


See also

copy_obj, gen_region_points


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH