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

Interactive drawing of a circle.

draw_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 Radius'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 Radius of the circle. Pressing the right mousebutton terminates the procedure. After terminating the procedure the circle is not visible in the window any longer.


Parameters

WindowHandle (input_control)
window -> integer
Window_id.

Row (output_control)
circle.center.y -> real
Barycenter's row index.

Column (output_control)
circle.center.x -> real
Barycenter's column index.

Radius (output_control)
circle.radius -> real
Circle's radius.


Example
read_image(Image,'affe') 
draw_circle(WindowHandle,Row,Column,Radius) 
gen_circle(Circle,Row,Column,Radius,) 
reduce_domain(Image,Circle,GrayCircle) 
disp_image(GrayCircle,WindowHandle).

Result

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


Parallelization Information

draw_circle is reentrant, local, and processed without parallelization.


Possible Predecessors

open_window


Possible Successors

reduce_domain, disp_region, set_colored, set_line_width, set_draw, set_insert


Alternatives

draw_circle_mod, draw_ellipse, draw_region


See also

gen_circle, draw_rectangle1, draw_rectangle2, draw_polygon, set_insert


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH