HALCON Reference Manual 10.0.2

get_region_pointsT_get_region_pointsget_region_pointsGetRegionPointsGetRegionPoints (Operator)

Name

get_region_pointsT_get_region_pointsget_region_pointsGetRegionPointsGetRegionPoints — Access the pixels of a region.

Signature

get_region_points(Region : : : Rows, Columns)

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

          (r1,c1) <= (r2,c2) := r1 < r2 or r1 = r2 and c1 <= c2

get_region_pointsget_region_pointsget_region_pointsGetRegionPointsGetRegionPoints returns the coordinates in the form of tuples. An empty region is passed as empty tuple.

Attention

Only one region may be passed.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

RegionRegionRegionRegionregion (input_object) region → object

This region is accessed.

RowsRowsRowsRowsrows (output_control) coordinates.y-array → (integer)

Line numbers of the pixels in the region

ColumnsColumnsColumnsColumnscolumns (output_control) coordinates.x-array → (integer)

Column numbers of the pixels in the region.

Number of elements: Columns == Rows

Result

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