draw_regionDrawRegionDrawRegiondraw_regionT_draw_region🔗

Short description🔗

draw_regionDrawRegionDrawRegiondraw_regionT_draw_region — Interactive drawing of a closed region.

Signature🔗

draw_region( out region Region, window WindowHandle )

HRegion HWindow::DrawRegion( ) const

HRegion HWindow.DrawRegion( )

Description🔗

draw_regionDrawRegion 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_colorSetColor, set_rgbSetRgb, etc. .

Pressing the right mouse button terminates the procedure.

Attention🔗

The output object’s gray values are not defined.

If used in a buffer window, mouse events have to be supplied by the application, while the draw operator must be run in another thread.

Execution information🔗

Execution information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters🔗

Regionregionregion (output_object) region → objectHObjectHRegionHObjectHobject *

Interactive created region.

WindowHandlewindowHandlewindow_handle (input_control) window → (handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window handle.

Example🔗

(HDevelop)

read_image(Image,'fabrik')
dev_display (Image)
draw_region(Region,WindowHandle)
reduce_domain(Image,Region,ImageReduced)
invert_image (ImageReduced, ImageInvert)
dev_display (ImageInvert)

(C)

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_regionDrawRegion returns 2 (H_MSG_TRUE). If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

open_windowOpenWindow

Possible successors

reduce_domainReduceDomain, disp_regionDispRegion, set_coloredSetColored, set_line_widthSetLineWidth, set_drawSetDraw

Alternatives

draw_circleDrawCircle, draw_ellipseDrawEllipse, draw_rectangle1DrawRectangle1, draw_rectangle2DrawRectangle2

Module🔗

Foundation