gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPoints (Operator)


gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPoints — Store individual pixels as image region.


gen_region_points( : Region : Rows, Columns : )

Herror gen_region_points(Hobject* Region, const Hlong Rows, const Hlong Columns)

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

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

void HRegion::GenRegionPoints(const HTuple& Rows, const HTuple& Columns)

void HRegion::GenRegionPoints(Hlong Rows, Hlong Columns)

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

void HRegion.GenRegionPoints(HTuple rows, HTuple columns)

void HRegion.GenRegionPoints(int rows, int columns)


The operator gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints creates a region described by a number of pixels. The pixels do not have to be stored in a fixed order, but the best runtime behavior is obtained when the pixels are stored in ascending order. The order is as follows:

The indicated coordinates stand for two consecutive pixels in the tupel.

Execution Information


RegionRegionRegionRegionregion (output_object)  region objectHRegionHRegionHobject *

Created region.

RowsRowsRowsRowsrows (input_control)  coordinates.y(-array) HTupleHTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Lines of the pixels in the region.

Default value: 100

Suggested values: 0, 10, 30, 50, 100, 200, 300, 500

Typical range of values: Rows Rows Rows Rows rows (lin)

Minimum increment: 1

Recommended increment: 1

ColumnsColumnsColumnsColumnscolumns (input_control)  coordinates.x(-array) HTupleHTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Columns of the pixels in the region.

Number of elements: Columns == Rows

Default value: 100

Suggested values: 0, 10, 30, 50, 100, 200, 300, 500

Typical range of values: Columns Columns Columns Columns columns (lin)

Minimum increment: 1

Recommended increment: 1


F shall be the number of pixels. If the pixels are sorted in ascending order the runtime complexity is: O(F), otherwise O(log(F)*F).


The operator gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints returns the value 2 (H_MSG_TRUE) if the pixels are located within the image format. Otherwise an exception is raised. The clipping according to the current image format is set via the operator set_system('clip_region',<'true'/'false'>)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">). If an empty region is created (by the clipping or by an empty input) the operator set_system('store_empty_region',<'true'/'false'>)set_system("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">) determines whether the region is returned or an empty object tuple.

Possible Predecessors


Possible Successors

paint_regionpaint_regionPaintRegionPaintRegionPaintRegion, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain


gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygon, gen_region_runsgen_region_runsGenRegionRunsGenRegionRunsGenRegionRuns, gen_region_linegen_region_lineGenRegionLineGenRegionLineGenRegionLine

See also