get_region_points

Herror ::get_region_points ( Hobject Region, HTuple *Rows, HTuple *Columns ) HTuple HRegion::GetRegionPoints ( HTuple *Columns ) const

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 r1 <= r2

::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 `->` Hobject: HRegion
This region is accessed.

`Rows` (output_control)	coordinates.y-array `->` HTuple.long *
Line numbers of the pixels in the region

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

Result

The operator ::get_region_points normally returns the value 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>).

Possible Predecessors

::sobel_amp, ::threshold, ::connection

Alternatives

::get_region_runs

See also

::copy_obj, ::gen_region_points

Module

Region processing