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

disp_rectangle2disp_rectangle2disp_rectangle2DispRectangle2DispRectangle2 (Operator)

Name

disp_rectangle2disp_rectangle2disp_rectangle2DispRectangle2DispRectangle2 — Displays arbitrarily oriented rectangles.

Signature

disp_rectangle2( : : WindowHandle, CenterRow, CenterCol, Phi, Length1, Length2 : )

Herror disp_rectangle2(const Hlong WindowHandle, double CenterRow, double CenterCol, double Phi, double Length1, double Length2)

Herror T_disp_rectangle2(const Htuple WindowHandle, const Htuple CenterRow, const Htuple CenterCol, const Htuple Phi, const Htuple Length1, const Htuple Length2)

Herror disp_rectangle2(const HTuple& WindowHandle, const HTuple& CenterRow, const HTuple& CenterCol, const HTuple& Phi, const HTuple& Length1, const HTuple& Length2)

void HWindow::DispRectangle2(const HTuple& CenterRow, const HTuple& CenterCol, const HTuple& Phi, const HTuple& Length1, const HTuple& Length2) const

void HOperatorSetX.DispRectangle2(
[in] VARIANT WindowHandle, [in] VARIANT CenterRow, [in] VARIANT CenterCol, [in] VARIANT Phi, [in] VARIANT Length1, [in] VARIANT Length2)

void HWindowX.DispRectangle2(
[in] VARIANT CenterRow, [in] VARIANT CenterCol, [in] VARIANT Phi, [in] VARIANT Length1, [in] VARIANT Length2)

static void HOperatorSet.DispRectangle2(HTuple windowHandle, HTuple centerRow, HTuple centerCol, HTuple phi, HTuple length1, HTuple length2)

void HWindow.DispRectangle2(HTuple centerRow, HTuple centerCol, HTuple phi, HTuple length1, HTuple length2)

void HWindow.DispRectangle2(double centerRow, double centerCol, double phi, double length1, double length2)

Description

disp_rectangle2disp_rectangle2disp_rectangle2DispRectangle2DispRectangle2 draws one or several arbitrarily oriented rectangles in the output window. A rectangle is described by the center (CenterRowCenterRowCenterRowCenterRowcenterRow,CenterColCenterColCenterColCenterColcenterCol), the orientation PhiPhiPhiPhiphi (in radians) and half the lengths of the edges Length1Length1Length1Length1length1 and Length2Length2Length2Length2length2. The operators used to control the display of regions (e.g. set_drawset_drawset_drawSetDrawSetDraw, set_grayset_grayset_graySetGraySetGray, set_drawset_drawset_drawSetDrawSetDraw) can also be used with rectangles. Several rectangles can be displayed with one call by using tuple parameters. For the use of colors with several rectangles, see set_colorset_colorset_colorSetColorSetColor.

Attention

The center must lie within the window boundaries.

Parallelization

Parameters

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

Window identifier.

CenterRowCenterRowCenterRowCenterRowcenterRow (input_control)  rectangle2.center.y(-array) → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Row index of the center.

Default value: 48

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

Typical range of values: 0 ≤ CenterRow CenterRow CenterRow CenterRow centerRow ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

CenterColCenterColCenterColCenterColcenterCol (input_control)  rectangle2.center.x(-array) → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Column index of the center.

Default value: 64

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

Typical range of values: 0 ≤ CenterCol CenterCol CenterCol CenterCol centerCol ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

PhiPhiPhiPhiphi (input_control)  rectangle2.angle.rad(-array) → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Orientation of rectangle in radians.

Default value: 0.0

Suggested values: 0.0, 0.785398, 1.570796, 3.1415926, 6.283185

Typical range of values: 0.0 ≤ Phi Phi Phi Phi phi ≤ 6.283185 (lin)

Minimum increment: 0.01

Recommended increment: 0.1

Length1Length1Length1Length1length1 (input_control)  rectangle2.hwidth(-array) → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Half of the length of the longer side.

Default value: 48

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

Typical range of values: 0 ≤ Length1 Length1 Length1 Length1 length1 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Length2Length2Length2Length2length2 (input_control)  rectangle2.hheight(-array) → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Half of the length of the shorter side.

Default value: 32

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

Typical range of values: 0 ≤ Length2 Length2 Length2 Length2 length2 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Length2 < Length1

Example (HDevelop)

set_color(WindowHandle,'green')
draw_region(MyRegion,WindowHandle)
elliptic_axis(MyRegion,Ra,Rb,Phi)
area_center(MyRegion,_,Row,Column)
disp_rectangle2(WindowHandle,Row,Column,Phi,Ra,Rb)

Example (C)

set_color(WindowHandle,"green") ;
draw_region(&MyRegion,WindowHandle) ;
elliptic_axis(MyRegion,&Ra,&Rb,&Phi) ;
area_center(MyRegion,NULL,&Row,&Column) ;
disp_gen_rectangle2(WindowHandle,Row,Column,Phi,Ra,Rb) ;

Example (HDevelop)

set_color(WindowHandle,'green')
draw_region(MyRegion,WindowHandle)
elliptic_axis(MyRegion,Ra,Rb,Phi)
area_center(MyRegion,_,Row,Column)
disp_rectangle2(WindowHandle,Row,Column,Phi,Ra,Rb)

Example (HDevelop)

set_color(WindowHandle,'green')
draw_region(MyRegion,WindowHandle)
elliptic_axis(MyRegion,Ra,Rb,Phi)
area_center(MyRegion,_,Row,Column)
disp_rectangle2(WindowHandle,Row,Column,Phi,Ra,Rb)

Example (HDevelop)

set_color(WindowHandle,'green')
draw_region(MyRegion,WindowHandle)
elliptic_axis(MyRegion,Ra,Rb,Phi)
area_center(MyRegion,_,Row,Column)
disp_rectangle2(WindowHandle,Row,Column,Phi,Ra,Rb)

Result

disp_rectangle2disp_rectangle2disp_rectangle2DispRectangle2DispRectangle2 returns 2 (H_MSG_TRUE), if the parameters are correct. Otherwise an exception is raised.

Possible Predecessors

open_windowopen_windowopen_windowOpenWindowOpenWindow, set_rgbset_rgbset_rgbSetRgbSetRgb, set_lutset_lutset_lutSetLutSetLut, set_hsiset_hsiset_hsiSetHsiSetHsi, set_drawset_drawset_drawSetDrawSetDraw, set_colorset_colorset_colorSetColorSetColor, set_coloredset_coloredset_coloredSetColoredSetColored, set_line_widthset_line_widthset_line_widthSetLineWidthSetLineWidth

Alternatives

disp_regiondisp_regiondisp_regionDispRegionDispRegion, gen_rectangle2gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2, disp_rectangle1disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1, set_shapeset_shapeset_shapeSetShapeSetShape

See also

open_windowopen_windowopen_windowOpenWindowOpenWindow, open_textwindowopen_textwindowopen_textwindowOpenTextwindowOpenTextwindow, disp_regiondisp_regiondisp_regionDispRegionDispRegion, set_colorset_colorset_colorSetColorSetColor, set_drawset_drawset_drawSetDrawSetDraw, set_line_widthset_line_widthset_line_widthSetLineWidthSetLineWidth

Module

Foundation

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