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

draw_ellipsedraw_ellipsedraw_ellipseDrawEllipseDrawEllipse (Operator)

Name

draw_ellipsedraw_ellipsedraw_ellipseDrawEllipseDrawEllipse — Interactive drawing of an ellipse.

Signature

draw_ellipse( : : WindowHandle : Row, Column, Phi, Radius1, Radius2)

Herror draw_ellipse(const Hlong WindowHandle, double* Row, double* Column, double* Phi, double* Radius1, double* Radius2)

Herror T_draw_ellipse(const Htuple WindowHandle, Htuple* Row, Htuple* Column, Htuple* Phi, Htuple* Radius1, Htuple* Radius2)

Herror draw_ellipse(const HTuple& WindowHandle, double* Row, double* Column, double* Phi, double* Radius1, double* Radius2)

double HWindow::DrawEllipse(HTuple* Column, HTuple* Phi, HTuple* Radius1, HTuple* Radius2) const

void HOperatorSetX.DrawEllipse(
[in] VARIANT WindowHandle, [out] VARIANT* Row, [out] VARIANT* Column, [out] VARIANT* Phi, [out] VARIANT* Radius1, [out] VARIANT* Radius2)

double HWindowX.DrawEllipse(
[out] double* Column, [out] double* Phi, [out] double* Radius1, [out] double* Radius2)

static void HOperatorSet.DrawEllipse(HTuple windowHandle, out HTuple row, out HTuple column, out HTuple phi, out HTuple radius1, out HTuple radius2)

void HWindow.DrawEllipse(out double row, out double column, out double phi, out double radius1, out double radius2)

Description

draw_ellipsedraw_ellipsedraw_ellipseDrawEllipseDrawEllipse returns the parameter for any orientated ellipse, which has been created interactively by the user in the window.

The created ellipse is described by its center, its two half axes and the angle between the first half axis and the horizontal coordinate axis.

To create an ellipse you have to determine the center of the ellipse with the left mouse button. Keeping the button pressed determines the length (Radius1Radius1Radius1Radius1radius1) and the orientation (PhiPhiPhiPhiphi) of the first half axis. In doing so a temporary default length for the second half axis is assumed, which may be modified afterwards on demand. After another mouse click in the center of the created ellipse you can move it. A mouse click close to a vertex “grips” it to modify the length of the appropriate half axis. You may modify the orientation only, if a vertex of the first half axis is gripped.

Pressing the right mouse button terminates the procedure. After terminating the procedure the ellipse is not visible in the window any longer.

Parallelization

Parameters

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

Window identifier.

RowRowRowRowrow (output_control)  ellipse.center.y HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row index of the center.

ColumnColumnColumnColumncolumn (output_control)  ellipse.center.x HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column index of the center.

PhiPhiPhiPhiphi (output_control)  ellipse.angle.rad HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Orientation of the first half axis in radians.

Radius1Radius1Radius1Radius1radius1 (output_control)  ellipse.radius1 HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

First half axis.

Radius2Radius2Radius2Radius2radius2 (output_control)  ellipse.radius2 HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Second half axis.

Example (HDevelop)

read_image(Image,'monkey')
draw_ellipse(WindowHandle,Row,Column,Phi,Radius1,Radius2)
gen_ellipse(Ellipse,Row,Column,Phi,Radius1,Radius2)
reduce_domain(Image,Ellipse,GrayEllipse)
sobel_amp(GrayEllipse,Sobel,'sum_abs',3)
disp_image(Sobel,WindowHandle)

Example (C)

read_image(&Image,"monkey") ;
draw_ellipse(WindowHandle,&Row,&Column,&Phi,&Radius1,&Radius2) ;
gen_ellipse(&Ellipse,Row,Column,Phi,Radius1,Radius2) ;
reduce_domain(Image,Ellipse,&GrayEllipse) ;
sobel_amp(GrayEllipse,&Sobel,"sum_abs",3) ;
disp_image(Sobel,WindowHandle) ;

Example (HDevelop)

read_image(Image,'monkey')
draw_ellipse(WindowHandle,Row,Column,Phi,Radius1,Radius2)
gen_ellipse(Ellipse,Row,Column,Phi,Radius1,Radius2)
reduce_domain(Image,Ellipse,GrayEllipse)
sobel_amp(GrayEllipse,Sobel,'sum_abs',3)
disp_image(Sobel,WindowHandle)

Example (HDevelop)

read_image(Image,'monkey')
draw_ellipse(WindowHandle,Row,Column,Phi,Radius1,Radius2)
gen_ellipse(Ellipse,Row,Column,Phi,Radius1,Radius2)
reduce_domain(Image,Ellipse,GrayEllipse)
sobel_amp(GrayEllipse,Sobel,'sum_abs',3)
disp_image(Sobel,WindowHandle)

Example (HDevelop)

read_image(Image,'monkey')
draw_ellipse(WindowHandle,Row,Column,Phi,Radius1,Radius2)
gen_ellipse(Ellipse,Row,Column,Phi,Radius1,Radius2)
reduce_domain(Image,Ellipse,GrayEllipse)
sobel_amp(GrayEllipse,Sobel,'sum_abs',3)
disp_image(Sobel,WindowHandle)

Result

draw_ellipsedraw_ellipsedraw_ellipseDrawEllipseDrawEllipse returns 2 (H_MSG_TRUE), if the window is valid and the needed drawing mode (see set_insertset_insertset_insertSetInsertSetInsert) is available. 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, set_insertset_insertset_insertSetInsertSetInsert

Alternatives

draw_ellipse_moddraw_ellipse_moddraw_ellipse_modDrawEllipseModDrawEllipseMod, draw_circledraw_circledraw_circleDrawCircleDrawCircle, draw_regiondraw_regiondraw_regionDrawRegionDrawRegion

See also

gen_ellipsegen_ellipsegen_ellipseGenEllipseGenEllipse, draw_rectangle1draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1, draw_rectangle2draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2, draw_polygondraw_polygondraw_polygonDrawPolygonDrawPolygon, set_insertset_insertset_insertSetInsertSetInsert

Module

Foundation


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