Operator Reference

get_region_pointsT_get_region_pointsGetRegionPointsGetRegionPointsget_region_points (Operator)

get_region_pointsT_get_region_pointsGetRegionPointsGetRegionPointsget_region_points — 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)

def get_region_points(region: HObject) -> Tuple[Sequence[int], Sequence[int]]

Description

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

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

Execution Information

  • 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 objectHRegionHObjectHObjectHobject

This region is accessed.

RowsRowsRowsrowsrows (output_control)  coordinates.y-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Line numbers of the pixels in the region

ColumnsColumnsColumnscolumnscolumns (output_control)  coordinates.x-array HTupleSequence[int]HTupleHtuple (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_pointsGetRegionPointsGetRegionPointsget_region_points 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>)set_system("no_object_result",<Result>).

Possible Predecessors

sobel_ampsobel_ampSobelAmpSobelAmpsobel_amp, thresholdthresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionconnection

Alternatives

get_region_runsget_region_runsGetRegionRunsGetRegionRunsget_region_runs

See also

copy_objcopy_objCopyObjCopyObjcopy_obj, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsgen_region_points

Module

Foundation