draw_region (Operator)

Name

draw_region — Interactive drawing of a closed region.

Synopsis

draw_region( : Region : WindowHandle : )

Description

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 output 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 identifier.

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 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

Foundation