HALCON 17.12 / HALCON Operator Reference / Graphics / Output
ClassesClasses | | Operators

disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1 (Operator)

Name

disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1 — Display of rectangles aligned to the coordinate axes.

Signature

disp_rectangle1( : : WindowHandle, Row1, Column1, Row2, Column2 : )

Herror disp_rectangle1(const Hlong WindowHandle, double Row1, double Column1, double Row2, double Column2)

Herror T_disp_rectangle1(const Htuple WindowHandle, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2)

void DispRectangle1(const HTuple& WindowHandle, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2)

void HWindow::DispRectangle1(const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2) const

void HWindow::DispRectangle1(double Row1, double Column1, double Row2, double Column2) const

static void HOperatorSet.DispRectangle1(HTuple windowHandle, HTuple row1, HTuple column1, HTuple row2, HTuple column2)

void HWindow.DispRectangle1(HTuple row1, HTuple column1, HTuple row2, HTuple column2)

void HWindow.DispRectangle1(double row1, double column1, double row2, double column2)

Description

disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1DispRectangle1 displays one or several rectangles in the output window. A rectangle is described by the upper left corner (Row1Row1Row1Row1row1,Column1Column1Column1Column1column1) and the lower right corner (Row2Row2Row2Row2row2,Column2Column2Column2Column2column2). If the given coordinates are not within the boundary of the window the rectangle is clipped accordingly. The operators used to control the display of regions (e.g. set_colorset_colorSetColorSetColorSetColor, set_grayset_graySetGraySetGraySetGray, set_drawset_drawSetDrawSetDrawSetDraw, set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidth) can also be used with rectangles. Several rectangles can be displayed with one call by using tuple parameters.

Execution Information

Parameters

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Window handle.

Row1Row1Row1Row1row1 (input_control)  rectangle.origin.y(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Row index of the upper left corner.

Default value: 16

Suggested values: 0, 64, 128, 256, 511

Typical range of values: 0 ≤ Row1 Row1 Row1 Row1 row1 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Column1Column1Column1Column1column1 (input_control)  rectangle.origin.x(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column index of the upper left corner.

Default value: 16

Suggested values: 0, 64, 128, 256, 511

Typical range of values: 0 ≤ Column1 Column1 Column1 Column1 column1 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Row2Row2Row2Row2row2 (input_control)  rectangle.corner.y(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Row index of the lower right corner.

Default value: 48

Suggested values: 0, 64, 128, 256, 511

Typical range of values: 0 ≤ Row2 Row2 Row2 Row2 row2 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Row2 >= Row1

Column2Column2Column2Column2column2 (input_control)  rectangle.corner.x(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column index of the lower right corner.

Default value: 80

Suggested values: 0, 64, 128, 256, 511

Typical range of values: 0 ≤ Column2 Column2 Column2 Column2 column2 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Column2 >= Column1

Example (HDevelop)

set_color(WindowHandle,'green')
draw_region(MyRegion,WindowHandle)
smallest_rectangle1(MyRegion,R1,C1,R2,C2)
disp_rectangle1(WindowHandle,R1,C1,R2,C2)

Example (C)

set_color(WindowHandle,"green") ;
draw_region(&MyRegion,WindowHandle) ;
smallest_rectangle1(MyRegion,&R1,&C1,&R2,&C2) ;
disp_rectangle1(WindowHandle,R1,C1,R2,C2) ;

Example (HDevelop)

set_color(WindowHandle,'green')
draw_region(MyRegion,WindowHandle)
smallest_rectangle1(MyRegion,R1,C1,R2,C2)
disp_rectangle1(WindowHandle,R1,C1,R2,C2)

Example (HDevelop)

set_color(WindowHandle,'green')
draw_region(MyRegion,WindowHandle)
smallest_rectangle1(MyRegion,R1,C1,R2,C2)
disp_rectangle1(WindowHandle,R1,C1,R2,C2)

Example (HDevelop)

set_color(WindowHandle,'green')
draw_region(MyRegion,WindowHandle)
smallest_rectangle1(MyRegion,R1,C1,R2,C2)
disp_rectangle1(WindowHandle,R1,C1,R2,C2)

Result

disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1DispRectangle1 returns 2 (H_MSG_TRUE).

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_rgbset_rgbSetRgbSetRgbSetRgb, set_lutset_lutSetLutSetLutSetLut, set_hsiset_hsiSetHsiSetHsiSetHsi, set_drawset_drawSetDrawSetDrawSetDraw, set_colorset_colorSetColorSetColorSetColor, set_coloredset_coloredSetColoredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidth

Alternatives

disp_rectangle2disp_rectangle2DispRectangle2DispRectangle2DispRectangle2, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1, disp_regiondisp_regionDispRegionDispRegionDispRegion, disp_linedisp_lineDispLineDispLineDispLine, set_shapeset_shapeSetShapeSetShapeSetShape

See also

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_colorset_colorSetColorSetColorSetColor, set_drawset_drawSetDrawSetDrawSetDraw, set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidth

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH