gen_region_polygon_filledT_gen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilled (Operator)

Name

gen_region_polygon_filledT_gen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilled — Store a polygon as a “filled” region.

Signature

gen_region_polygon_filled( : Region : Rows, Columns : )

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

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

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

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

void HRegion.GenRegionPolygonFilled(HTuple rows, HTuple columns)

Description

The operator gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilledGenRegionPolygonFilled creates a region from a polygon containing the corner points of the region (line and column coordinates) either clockwise or anti-clockwise. Contrary to gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygon a “filled” region is returned here.

Execution Information

Parameters

RegionRegionRegionRegionregion (output_object)  region objectHRegionHRegionHobject *

Created region.

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

Line indices of the base points of the region contour.

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)  polygon.x-array HTupleHTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)

Column indices of the base points of the region contour.

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

Example (C)

/* Polygon approximation */
T_get_region_polygon(Region,7,&Row,&Column);
T_gen_region_polygon_filled(&Pol,Row,Column);
/* fill up with original gray value */
reduce_domain(Image,Pol,&New);

Result

If the base points are correct the operator gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilledGenRegionPolygonFilled returns the value 2 (H_MSG_TRUE). 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

get_region_polygonget_region_polygonGetRegionPolygonGetRegionPolygonGetRegionPolygon, draw_polygondraw_polygonDrawPolygonDrawPolygonDrawPolygon

Alternatives

gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygon, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints, draw_polygondraw_polygonDrawPolygonDrawPolygonDrawPolygon

See also

gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygon, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, get_region_polygonget_region_polygonGetRegionPolygonGetRegionPolygonGetRegionPolygon, gen_region_runsgen_region_runsGenRegionRunsGenRegionRunsGenRegionRuns

Module

Foundation