store_filled_polygon ( : Region : Rows, Columns : )

Store a polygon as a "filled" region.

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


Attention

All base points must be located within the image format. If no pixels are passed an empty region is created.


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
Range of values: 0 <= Rows <= 511 (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
Range of values: 0 <= Columns <= 511 (lin)
Minimum increment: 1
Recommended increment: 1
Number of elements: Columns == Rows


Example
/* Polygon approximation */
T_fetch_polygon(Region,7,&Row,&Column);
T_store_filled_polygon(&Pol,Row,Column);
/* fill up with original grey value */
reduce_domain(Image,Pol,&New);

Result

If the base points are correct the operator store_filled_polygon returns the value TRUE. Otherwise an exception is raised. If an empty region is created the operator set_system(::'store_empty_region',<true/false>:) determines whether the region is returned.


Possible Predecessors

fetch_polygon, draw_polygon


Alternatives

store_polygon, store_coord, draw_polygon


See also

store_polygon, reduce_domain, fetch_polygon, store_chord



Copyright © 1996-1997 MVTec Software GmbH