get_region_pointsT_get_region_pointsGetRegionPointsGetRegionPoints (Operator)

Name

get_region_pointsT_get_region_pointsGetRegionPointsGetRegionPoints — Access the pixels of a region.

Signature

get_region_points(Region : : : Rows, Columns)

Herror T_get_region_points(const Hobject Region, Htuple* Rows, Htuple* Columns)

void GetRegionPoints(const HObject& Region, HTuple* Rows, HTuple* Columns)

void HRegion::GetRegionPoints(HTuple* Rows, HTuple* Columns) const

static void HOperatorSet.GetRegionPoints(HObject region, out HTuple rows, out HTuple columns)

void HRegion.GetRegionPoints(out HTuple rows, out HTuple columns)

Description

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

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

Attention

Only one region may be passed.

Execution Information

Parameters

RegionRegionRegionRegionregion (input_object)  region objectHRegionHRegionHobject

This region is accessed.

RowsRowsRowsRowsrows (output_control)  coordinates.y-array HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Line numbers of the pixels in the region

ColumnsColumnsColumnsColumnscolumns (output_control)  coordinates.x-array HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column numbers of the pixels in the region.

Number of elements: Columns == Rows

Result

The operator get_region_pointsget_region_pointsGetRegionPointsGetRegionPointsGetRegionPoints 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>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>).

Possible Predecessors

sobel_ampsobel_ampSobelAmpSobelAmpSobelAmp, thresholdthresholdThresholdThresholdThreshold, connectionconnectionConnectionConnectionConnection

Alternatives

get_region_runsget_region_runsGetRegionRunsGetRegionRunsGetRegionRuns

See also

copy_objcopy_objCopyObjCopyObjCopyObj, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints

Module

Foundation