draw_polygon ( : PolygonRegion : WindowHandle : )

Interactive drawing of a polygon row.

draw_polygon produces an image. The region of that image spans exactly the imagepoints entered interactively by mouse clicks (gray values remain undefined).

Painting in the output window happens while pressing the left mouse button. Releasing the left mouse button and repressing it at another position effects drawing a line between these two points. Pressing the right mouse button terminates the input. Painting uses that color which has been set by set_color, set_rgb, etc. .

To put gray values on the created PolygonRegion for further processing, you may use the procedure reduce_domain.


Attention

The painted contour is not closed automatically, in particular it is not ``filled up'' either.

Output object's gray values are not defined.


Parameters

PolygonRegion (output_object)
region -> object
Region, which encompasses all painted points.

WindowHandle (input_control)
window -> integer
Window_id.


Example
draw_polygon(Polygon,WindowHandle) 
shape_trans(Polygon,Filled,'convex') 
disp_region(Filled,WindowHandle).

Result

If the window is valid, draw_polygon returns 2 (H_MSG_TRUE). If necessary, an exception handling is raised.


Parallelization Information

draw_polygon is reentrant, local, and processed without parallelization.


Possible Predecessors

open_window


Possible Successors

reduce_domain, disp_region, set_colored, set_line_width, set_draw


Alternatives

draw_region, draw_circle, draw_rectangle1, draw_rectangle2, boundary


See also

reduce_domain, fill_up, set_color


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH