ClassesClassesClassesClasses | | | | Operators

gen_region_pointsgen_region_pointsGenRegionPointsgen_region_pointsGenRegionPointsGenRegionPoints (Operator)

Name

gen_region_pointsgen_region_pointsGenRegionPointsgen_region_pointsGenRegionPointsGenRegionPoints — Store individual pixels as image region.

Signature

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)

Herror gen_region_points(Hobject* Region, const HTuple& Rows, const HTuple& Columns)

HRegion HRegion::GenRegionPoints(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)

void HOperatorSetX.GenRegionPoints(
[out] IHUntypedObjectX*Region, [in] VARIANT Rows, [in] VARIANT Columns)

void HRegionX.GenRegionPoints(
[in] VARIANT Rows, [in] VARIANT 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)

Description

The operator gen_region_pointsgen_region_pointsGenRegionPointsgen_region_pointsGenRegionPointsGenRegionPoints 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.

Parallelization

Parameters

RegionRegionRegionRegionRegionregion (output_object)  region objectHRegionHRegionHRegionHRegionXHobject *

Created region.

RowsRowsRowsRowsRowsrows (input_control)  coordinates.y(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / 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 rows (lin)

Minimum increment: 1

Recommended increment: 1

ColumnsColumnsColumnsColumnsColumnscolumns (input_control)  coordinates.x(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / 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 columns (lin)

Minimum increment: 1

Recommended increment: 1

Complexity

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

Result

The operator gen_region_pointsgen_region_pointsGenRegionPointsgen_region_pointsGenRegionPointsGenRegionPoints 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">)set_system("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">)set_system("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

get_region_pointsget_region_pointsGetRegionPointsget_region_pointsGetRegionPointsGetRegionPoints

Possible Successors

paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain

Alternatives

gen_region_polygongen_region_polygonGenRegionPolygongen_region_polygonGenRegionPolygonGenRegionPolygon, gen_region_runsgen_region_runsGenRegionRunsgen_region_runsGenRegionRunsGenRegionRuns, gen_region_linegen_region_lineGenRegionLinegen_region_lineGenRegionLineGenRegionLine

See also

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain

Module

Foundation


ClassesClassesClassesClasses | | | | Operators