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

disp_ellipsedisp_ellipseDispEllipsedisp_ellipseDispEllipseDispEllipse (Operator)

Name

disp_ellipsedisp_ellipseDispEllipsedisp_ellipseDispEllipseDispEllipse — Displays ellipses.

Signature

disp_ellipse( : : WindowHandle, CenterRow, CenterCol, Phi, Radius1, Radius2 : )

Herror disp_ellipse(const Hlong WindowHandle, const Hlong CenterRow, const Hlong CenterCol, double Phi, double Radius1, double Radius2)

Herror T_disp_ellipse(const Htuple WindowHandle, const Htuple CenterRow, const Htuple CenterCol, const Htuple Phi, const Htuple Radius1, const Htuple Radius2)

Herror disp_ellipse(const HTuple& WindowHandle, const HTuple& CenterRow, const HTuple& CenterCol, const HTuple& Phi, const HTuple& Radius1, const HTuple& Radius2)

void HWindow::DispEllipse(const HTuple& CenterRow, const HTuple& CenterCol, const HTuple& Phi, const HTuple& Radius1, const HTuple& Radius2) const

void DispEllipse(const HTuple& WindowHandle, const HTuple& CenterRow, const HTuple& CenterCol, const HTuple& Phi, const HTuple& Radius1, const HTuple& Radius2)

void HWindow::DispEllipse(const HTuple& CenterRow, const HTuple& CenterCol, const HTuple& Phi, const HTuple& Radius1, const HTuple& Radius2) const

void HWindow::DispEllipse(Hlong CenterRow, Hlong CenterCol, double Phi, double Radius1, double Radius2) const

void HOperatorSetX.DispEllipse(
[in] VARIANT WindowHandle, [in] VARIANT CenterRow, [in] VARIANT CenterCol, [in] VARIANT Phi, [in] VARIANT Radius1, [in] VARIANT Radius2)

void HWindowX.DispEllipse(
[in] VARIANT CenterRow, [in] VARIANT CenterCol, [in] VARIANT Phi, [in] VARIANT Radius1, [in] VARIANT Radius2)

static void HOperatorSet.DispEllipse(HTuple windowHandle, HTuple centerRow, HTuple centerCol, HTuple phi, HTuple radius1, HTuple radius2)

void HWindow.DispEllipse(HTuple centerRow, HTuple centerCol, HTuple phi, HTuple radius1, HTuple radius2)

void HWindow.DispEllipse(int centerRow, int centerCol, double phi, double radius1, double radius2)

Description

disp_ellipsedisp_ellipseDispEllipsedisp_ellipseDispEllipseDispEllipse displays one or several ellipses in the output window. An ellipse is described by the center (CenterRowCenterRowCenterRowCenterRowCenterRowcenterRow, CenterColCenterColCenterColCenterColCenterColcenterCol), the orientation PhiPhiPhiPhiPhiphi (in radians) and the radii of the major and the minor axis (Radius1Radius1Radius1Radius1Radius1radius1 and Radius2Radius2Radius2Radius2Radius2radius2).

The operators used to control the display of regions (e.g. set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_grayset_graySetGrayset_graySetGraySetGray, set_drawset_drawSetDrawset_drawSetDrawSetDraw) can also be used with ellipses. Several ellipses can be displayed with one call by using tuple parameters. For the use of colors with several ellipses, see set_colorset_colorSetColorset_colorSetColorSetColor.

Attention

The center of the ellipse must be within the window.

Parallelization

Parameters

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

Window handle.

CenterRowCenterRowCenterRowCenterRowCenterRowcenterRow (input_control)  ellipse.center.y(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Row index of center.

Default value: 64

Suggested values: 0, 64, 128, 256

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

Minimum increment: 1

Recommended increment: 10

CenterColCenterColCenterColCenterColCenterColcenterCol (input_control)  ellipse.center.x(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column index of center.

Default value: 64

Suggested values: 0, 64, 128, 256

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

Minimum increment: 1

Recommended increment: 10

PhiPhiPhiPhiPhiphi (input_control)  ellipse.angle.rad(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Orientation of the ellipse 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 phi ≤ 6.283185 (lin)

Minimum increment: 0.01

Recommended increment: 0.1

Radius1Radius1Radius1Radius1Radius1radius1 (input_control)  ellipse.radius1(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Radius of major axis.

Default value: 24.0

Suggested values: 0.0, 64.0, 128.0, 256.0

Typical range of values: 0.0 ≤ Radius1 Radius1 Radius1 Radius1 Radius1 radius1 ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Radius2Radius2Radius2Radius2Radius2radius2 (input_control)  ellipse.radius2(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Radius of minor axis.

Default value: 14.0

Suggested values: 0.0, 64.0, 128.0, 256.0

Typical range of values: 0.0 ≤ Radius2 Radius2 Radius2 Radius2 Radius2 radius2 ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Example (HDevelop)

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

Example (C)

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

Example (HDevelop)

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

Example (HDevelop)

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

Example (HDevelop)

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

Example (HDevelop)

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

Result

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

Possible Predecessors

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_colorset_colorSetColorset_colorSetColorSetColor, set_coloredset_coloredSetColoredset_coloredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi, elliptic_axiselliptic_axisEllipticAxiselliptic_axisEllipticAxisEllipticAxis, area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter

Alternatives

disp_circledisp_circleDispCircledisp_circleDispCircleDispCircle, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, gen_ellipsegen_ellipseGenEllipsegen_ellipseGenEllipseGenEllipse, gen_circlegen_circleGenCirclegen_circleGenCircleGenCircle

See also

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, set_colorset_colorSetColorset_colorSetColorSetColor, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth

Module

Foundation

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