Operator Reference

HALCON Operator Reference / Graphics / Drawing
ClassesClasses | | Operators

draw_circleT_draw_circleDrawCircleDrawCircledraw_circle (Operator)

draw_circleT_draw_circleDrawCircleDrawCircledraw_circle — Interactive drawing of a circle.

Signature

draw_circle( : : WindowHandle : Row, Column, Radius)

Herror T_draw_circle(const Htuple WindowHandle, Htuple* Row, Htuple* Column, Htuple* Radius)

void DrawCircle(const HTuple& WindowHandle, HTuple* Row, HTuple* Column, HTuple* Radius)

void HWindow::DrawCircle(double* Row, double* Column, double* Radius) const

static void HOperatorSet.DrawCircle(HTuple windowHandle, out HTuple row, out HTuple column, out HTuple radius)

void HWindow.DrawCircle(out double row, out double column, out double radius)

def draw_circle(window_handle: HHandle) -> Tuple[float, float, float]

Description

draw_circledraw_circleDrawCircleDrawCircledraw_circle produces the parameter for a circle created interactive by the user in the window.

To create a circle you have to press the mouse button at the location which is used as the center of that circle. While keeping the mouse button pressed, the RadiusRadiusRadiusradiusradius's length can be modified through moving the mouse. After another mouse click in the created circle center you can move it. A clicking close to the circular arc you can modify the RadiusRadiusRadiusradiusradius of the circle. Pressing the right mouse button terminates the procedure. After terminating the procedure the circle is not visible in the window any longer.

Attention

If used in a buffer window, mouse events have to be supplied by the application, while the draw operator must be run in another thread.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control)  window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Window handle.

RowRowRowrowrow (output_control)  circle.center.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Barycenter's row index.

ColumnColumnColumncolumncolumn (output_control)  circle.center.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Barycenter's column index.

RadiusRadiusRadiusradiusradius (output_control)  circle.radius → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Circle's radius.

Example (HDevelop)

read_image(Image,'monkey')
draw_circle(WindowHandle,Row,Column,Radius)
gen_circle(Circle,Row,Column,Radius)
reduce_domain(Image,Circle,ImageReduced)
invert_image (ImageReduced, ImageInvert)
dev_display (ImageInvert)

Example (C)

read_image(&Image,"monkey");
draw_circle(WindowHandle,&Row,&Column,&Radius);
gen_circle(&Circle,Row,Column,Radius);
reduce_domain(Image,Circle,&GrayCircle);
disp_image(GrayCircle,WindowHandle);

Example (HDevelop)

read_image(Image,'monkey')
draw_circle(WindowHandle,Row,Column,Radius)
gen_circle(Circle,Row,Column,Radius)
reduce_domain(Image,Circle,ImageReduced)
invert_image (ImageReduced, ImageInvert)
dev_display (ImageInvert)

Example (HDevelop)

read_image(Image,'monkey')
draw_circle(WindowHandle,Row,Column,Radius)
gen_circle(Circle,Row,Column,Radius)
reduce_domain(Image,Circle,ImageReduced)
invert_image (ImageReduced, ImageInvert)
dev_display (ImageInvert)

Result

draw_circledraw_circleDrawCircleDrawCircledraw_circle returns 2 ( H_MSG_TRUE) if the window is valid and the needed drawing mode (see set_insertset_insertSetInsertSetInsertset_insert) is available. If necessary, an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowopen_window

Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, disp_regiondisp_regionDispRegionDispRegiondisp_region, set_coloredset_coloredSetColoredSetColoredset_colored, set_line_widthset_line_widthSetLineWidthSetLineWidthset_line_width, set_drawset_drawSetDrawSetDrawset_draw, set_insertset_insertSetInsertSetInsertset_insert

Alternatives

draw_circle_moddraw_circle_modDrawCircleModDrawCircleModdraw_circle_mod, draw_ellipsedraw_ellipseDrawEllipseDrawEllipsedraw_ellipse, draw_regiondraw_regionDrawRegionDrawRegiondraw_region

See also

gen_circlegen_circleGenCircleGenCirclegen_circle, draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1draw_rectangle1, draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2draw_rectangle2, draw_polygondraw_polygonDrawPolygonDrawPolygondraw_polygon, set_insertset_insertSetInsertSetInsertset_insert

Module

Foundation

ClassesClasses | | Operators