HALCON Reference Manual 10.0.2
Table of Contents / Graphics / Drawing ClassesClassesClasses | | | Operators

draw_regiondraw_regiondraw_regionDrawRegionDrawRegion (Operator)

Name

draw_regiondraw_regiondraw_regionDrawRegionDrawRegion — Interactive drawing of a closed region.

Signature

draw_region( : Region : WindowHandle : )

Herror draw_region(Hobject* Region, const Hlong WindowHandle)

Herror T_draw_region(Hobject* Region, const Htuple WindowHandle)

Herror draw_region(Hobject* Region, const HTuple& WindowHandle)

HRegion HWindow::DrawRegion() const

void HOperatorSetX.DrawRegion(
[out] IHUntypedObjectX*Region, [in] VARIANT WindowHandle)

void HRegionX.DrawRegion([in] IHWindowX* WindowHandle)

IHRegionX* HWindowX.DrawRegion()

static void HOperatorSet.DrawRegion(out HObject region, HTuple windowHandle)

void HRegion.DrawRegion(HWindow windowHandle)

HRegion HWindow.DrawRegion()

Description

draw_regiondraw_regiondraw_regionDrawRegionDrawRegion 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_colorset_colorset_colorSetColorSetColor, set_rgbset_rgbset_rgbSetRgbSetRgb, etc. .

Attention

The output object's gray values are not defined.

Parallelization

Parameters

RegionRegionRegionRegionregion (output_object)  region objectHRegionHRegionHRegionXHobject *

Interactive created region.

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Window identifier.

Example (HDevelop)

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)

Example (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) ;

Example (HDevelop)

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)

Example (HDevelop)

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)

Example (HDevelop)

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

Possible Predecessors

open_windowopen_windowopen_windowOpenWindowOpenWindow

Possible Successors

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, disp_regiondisp_regiondisp_regionDispRegionDispRegion, set_coloredset_coloredset_coloredSetColoredSetColored, set_line_widthset_line_widthset_line_widthSetLineWidthSetLineWidth, set_drawset_drawset_drawSetDrawSetDraw

Alternatives

draw_circledraw_circledraw_circleDrawCircleDrawCircle, draw_ellipsedraw_ellipsedraw_ellipseDrawEllipseDrawEllipse, draw_rectangle1draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1, draw_rectangle2draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2

See also

draw_polygondraw_polygondraw_polygonDrawPolygonDrawPolygon, reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, fill_upfill_upfill_upFillUpFillUp, set_colorset_colorset_colorSetColorSetColor

Module

Foundation


Table of Contents / Graphics / Drawing ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH