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
Herror T_gen_region_polygon_filled(Hobject* Region, const Htuple Rows, const 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
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
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