draw_circleT_draw_circleDrawCircleDrawCircledraw_circle (Operator)
Name
draw_circleT_draw_circleDrawCircleDrawCircledraw_circle — Interactive drawing of a circle.
Signature
def draw_circle(window_handle: HHandle) -> Tuple[float, float, float]
Description
draw_circledraw_circleDrawCircleDrawCircleDrawCircledraw_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
RadiusRadiusRadiusRadiusradiusradius'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 RadiusRadiusRadiusRadiusradiusradius of
the circle.
Pressing the right mouse button terminates the procedure. On macOS
draw_circledraw_circleDrawCircleDrawCircleDrawCircledraw_circle can also be terminated by pressing the escape key.
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
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Window handle.
RowRowRowRowrowrow (output_control) circle.center.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Barycenter's row index.
ColumnColumnColumnColumncolumncolumn (output_control) circle.center.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Barycenter's column index.
RadiusRadiusRadiusRadiusradiusradius (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)
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_circleDrawCircleDrawCircleDrawCircledraw_circle returns 2 (H_MSG_TRUE) if the window is valid and the
needed drawing mode (see set_insertset_insertSetInsertSetInsertSetInsertset_insert) is available.
If necessary, an exception is raised.
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
Possible Successors
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain,
disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region,
set_coloredset_coloredSetColoredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width,
set_drawset_drawSetDrawSetDrawSetDrawset_draw,
set_insertset_insertSetInsertSetInsertSetInsertset_insert
Alternatives
draw_circle_moddraw_circle_modDrawCircleModDrawCircleModDrawCircleModdraw_circle_mod,
draw_ellipsedraw_ellipseDrawEllipseDrawEllipseDrawEllipsedraw_ellipse,
draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region
See also
gen_circlegen_circleGenCircleGenCircleGenCirclegen_circle,
draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1draw_rectangle1,
draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2draw_rectangle2,
draw_polygondraw_polygonDrawPolygonDrawPolygonDrawPolygondraw_polygon,
set_insertset_insertSetInsertSetInsertSetInsertset_insert
Module
Foundation