gen_region_polygon

gen_region_polygon_filled ( : Region : Rows, Columns : )

Store a polygon as a ``filled'' region.

The operator gen_region_polygon_filled 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_polygon a ``filled'' region is returned here.

Parameters

`Region` (output_object)	region `->` object
Created region.

`Rows` (input_control)	polygon.y-array `->` integer
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: `-oo <= Rows <= -oo` (lin)
Minimum increment: 1
Recommended increment: 1

`Columns` (input_control)	polygon.x-array `->` integer
Column 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: `-oo <= Columns <= -oo` (lin)
Minimum increment: 1
Recommended increment: 1
Number of elements: Columns == Rows

Example (Syntax: 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_filled returns the value 2 (H_MSG_TRUE). Otherwise an exception handling is raised. The clipping according to the current image format is set via the operator set_system('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>) determines whether the region is returned or an empty object tuple.

Parallelization Information

gen_region_polygon_filled is reentrant, local, and processed without parallelization.

Possible Predecessors

get_region_polygon, draw_polygon

Alternatives

gen_region_polygon, gen_region_points, draw_polygon

Module

Foundation