HALCON Website / HALCON Operator Reference / Graphics / Output
ClassesClassesClassesClasses | | | | Operators

disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion (Operator)

Name

disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion — Displays regions in a window.

Signature

disp_region(DispRegions : : WindowHandle : )

Herror disp_region(const Hobject DispRegions, const Hlong WindowHandle)

Herror T_disp_region(const Hobject DispRegions, const Htuple WindowHandle)

Herror disp_region(Hobject DispRegions, const HTuple& WindowHandle)

void HRegion::DispRegion(const HTuple& WindowHandle) const

void HRegionArray::DispRegion(const HTuple& WindowHandle) const

void DispRegion(const HObject& DispRegions, const HTuple& WindowHandle)

void HRegion::DispRegion(const HWindow& WindowHandle) const

void HWindow::DispRegion(const HRegion& DispRegions) const

void HOperatorSetX.DispRegion(
[in] IHUntypedObjectX* DispRegions, [in] VARIANT WindowHandle)

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

void HWindowX.DispRegion([in] IHRegionX* DispRegions)

static void HOperatorSet.DispRegion(HObject dispRegions, HTuple windowHandle)

void HRegion.DispRegion(HWindow windowHandle)

void HWindow.DispRegion(HRegion dispRegions)

Description

disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion displays the regions in DispRegionsDispRegionsDispRegionsDispRegionsDispRegionsdispRegions in the output window. The parameters for output can be set with the operators set_colorset_colorSetColorset_colorSetColorSetColor, set_grayset_graySetGrayset_graySetGraySetGray, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, etc.

The color(s) for the display of the regions are determined with set_colorset_colorSetColorset_colorSetColorSetColor, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_grayset_graySetGrayset_graySetGraySetGray or set_coloredset_coloredSetColoredset_coloredSetColoredSetColored. If more than one region is displayed and more than one color is set, the colors are assigned in a cyclic way to the regions.

The form of the region for output can be modified by set_paintset_paintSetPaintset_paintSetPaintSetPaint (e.g. encompassing circle, convex hull). The command set_drawset_drawSetDrawset_drawSetDrawSetDraw determines if the region is filled or only the boundary is drawn. If only the boundary is drawn, the thickness of the boundary will be determined by set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth and the style by set_line_styleset_line_styleSetLineStyleset_line_styleSetLineStyleSetLineStyle.

Parallelization

Parameters

DispRegionsDispRegionsDispRegionsDispRegionsDispRegionsdispRegions (input_object)  region(-array) → objectHRegionHRegionHRegionHRegionXHobject

Regions to display.

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Window handle.

Example (HDevelop)

* Output with 12 colors:
set_colored(WindowHandle,12)
disp_region(SomeSegments,WindowHandle)

* Symbolic representation:
set_draw(WindowHandle,'margin')
set_color(WindowHandle,'red')
set_shape(WindowHandle,'ellipse')
disp_region(SomeSegments,WindowHandle)

* Representation of a margin with pattern:
set_draw(WindowHandle,'margin')
set_color(WindowHandle,'blue')
set_line_style(WindowHandle,[12,3])
disp_region(Segments,WindowHandle)

Example (C)

/* Output with 12 colors: */
set_colored(WindowHandle,12) ;
disp_region(SomeSegments,WindowHandle) ;

/* Symbolic representation: */
set_draw(WindowHandle,"margin") ;
set_color(WindowHandle,"red") ;
set_shape(WindowHandle,"ellipse") ;
disp_region(SomeSegments,WindowHandle) ;

/* Representation of a margin with pattern: */
set_draw(WindowHandle,"margin") ;
create_tuple(&Color,2) ;
set_s(Color,"blue",0) ;
set_s(Color,"red",0) ;
create_tuple(&Handle,1) ;
set_i(Handle,WindowHandle,0) ;
T_set_color(Handle,Color) ;
create_tuple(&Par,2) ;

set_i(Par,12,0) ;
set_i(Par,3,1) ;
T_set_line_style(WindowHandle,Par) ;
disp_region(Segments,WindowHandle) ;

Example (HDevelop)

* Output with 12 colors:
set_colored(WindowHandle,12)
disp_region(SomeSegments,WindowHandle)

* Symbolic representation:
set_draw(WindowHandle,'margin')
set_color(WindowHandle,'red')
set_shape(WindowHandle,'ellipse')
disp_region(SomeSegments,WindowHandle)

* Representation of a margin with pattern:
set_draw(WindowHandle,'margin')
set_color(WindowHandle,'blue')
set_line_style(WindowHandle,[12,3])
disp_region(Segments,WindowHandle)

Example (HDevelop)

* Output with 12 colors:
set_colored(WindowHandle,12)
disp_region(SomeSegments,WindowHandle)

* Symbolic representation:
set_draw(WindowHandle,'margin')
set_color(WindowHandle,'red')
set_shape(WindowHandle,'ellipse')
disp_region(SomeSegments,WindowHandle)

* Representation of a margin with pattern:
set_draw(WindowHandle,'margin')
set_color(WindowHandle,'blue')
set_line_style(WindowHandle,[12,3])
disp_region(Segments,WindowHandle)

Example (HDevelop)

* Output with 12 colors:
set_colored(WindowHandle,12)
disp_region(SomeSegments,WindowHandle)

* Symbolic representation:
set_draw(WindowHandle,'margin')
set_color(WindowHandle,'red')
set_shape(WindowHandle,'ellipse')
disp_region(SomeSegments,WindowHandle)

* Representation of a margin with pattern:
set_draw(WindowHandle,'margin')
set_color(WindowHandle,'blue')
set_line_style(WindowHandle,[12,3])
disp_region(Segments,WindowHandle)

Example (HDevelop)

* Output with 12 colors:
set_colored(WindowHandle,12)
disp_region(SomeSegments,WindowHandle)

* Symbolic representation:
set_draw(WindowHandle,'margin')
set_color(WindowHandle,'red')
set_shape(WindowHandle,'ellipse')
disp_region(SomeSegments,WindowHandle)

* Representation of a margin with pattern:
set_draw(WindowHandle,'margin')
set_color(WindowHandle,'blue')
set_line_style(WindowHandle,[12,3])
disp_region(Segments,WindowHandle)

Result

disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion returns 2 (H_MSG_TRUE).

Possible Predecessors

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_lutset_lutSetLutset_lutSetLutSetLut, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi, set_shapeset_shapeSetShapeset_shapeSetShapeSetShape, set_line_styleset_line_styleSetLineStyleset_line_styleSetLineStyleSetLineStyle, set_insertset_insertSetInsertset_insertSetInsertSetInsert, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_colorset_colorSetColorset_colorSetColorSetColor, set_coloredset_coloredSetColoredset_coloredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth

Alternatives

disp_objdisp_objDispObjdisp_objDispObjDispObj, disp_arrowdisp_arrowDispArrowdisp_arrowDispArrowDispArrow, disp_linedisp_lineDispLinedisp_lineDispLineDispLine, disp_circledisp_circleDispCircledisp_circleDispCircleDispCircle, disp_rectangle1disp_rectangle1DispRectangle1disp_rectangle1DispRectangle1DispRectangle1, disp_rectangle2disp_rectangle2DispRectangle2disp_rectangle2DispRectangle2DispRectangle2, disp_ellipsedisp_ellipseDispEllipsedisp_ellipseDispEllipseDispEllipse

See also

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, set_colorset_colorSetColorset_colorSetColorSetColor, set_coloredset_coloredSetColoredset_coloredSetColoredSetColored, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_shapeset_shapeSetShapeset_shapeSetShapeSetShape, set_paintset_paintSetPaintset_paintSetPaintSetPaint, set_grayset_graySetGrayset_graySetGraySetGray, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, set_line_styleset_line_styleSetLineStyleset_line_styleSetLineStyleSetLineStyle, set_insertset_insertSetInsertset_insertSetInsertSetInsert, paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion, dump_windowdump_windowDumpWindowdump_windowDumpWindowDumpWindow

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 13.0.4 Copyright © 1996-2019 MVTec Software GmbH