Store a polygon as an image object.
The operator gen_region_polygon creates a region from a polygon row described by a series of line and column coordinates. The created region consists of the pixels of the routes defined thereby, wherein it is linearily interpolated between the base points.
The region is not automatically closed and not filled. The gray values of the output regions are undefined.
|
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 |
| Colum 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 | |
/* Polygon-approximation*/ get_region_polygon(Region,7,Row,Column) /* store it as a region */ gen_region_polygon(Pol,Row,Column) /* fill up the hole */ fill_up(Pol,Filled).
If the base points are correct the operator gen_region_polygon 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.
gen_region_polygon is reentrant, local, and processed without parallelization.
get_region_polygon, draw_polygon
gen_region_polygon_filled, gen_region_points, gen_region_runs
fill_up, reduce_domain, get_region_polygon, draw_polygon
Foundation
