draw_region ( : Region : WindowHandle : )

Interactive drawing of a closed region.

draw_region produces an image. The region of that image spans exactly the image region entered interactively by mouse clicks (gray values remain undefined). Painting happens in the ouput window while keeping the left mouse button pressed. The left mouse button even operates by clicking in the output window; through this a line between the previous clicked points is drawn. Clicking the right mouse button terminates input and closes the outline. Subsequently the image is ``filled up''. Also it contains the whole image area enclosed by the mouse.

Painting uses that color which has been set by set_color, set_rgb, etc. .


Attention

The output object's gray values are not defined.


Parameters

Region (output_object)
region -> object
Interactive created region.

WindowHandle (input_control)
window -> integer
Window_id.


Example
read_image(Image,'fabrik') 
disp_image(Image,WindowHandle) 
draw_region(Region,WindowHandle) 
reduce_domain(Image,Region,New) 
regiongrowing(New,Segmente,5,5,6,50) 
set_colored(WindowHandle,12) 
disp_region(Segmente,WindowHandle).

Result

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


Parallelization Information

draw_region 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_circle, draw_ellipse, draw_rectangle1, draw_rectangle2


See also

draw_polygon, reduce_domain, fill_up, set_color


Module

System



Copyright © 1996-2005 MVTec Software GmbH