draw_ellipse_modπ
Short descriptionπ
draw_ellipse_mod β Interactive drawing of an ellipse.
Signatureπ
draw_ellipse_mod( window WindowHandle, ellipse.center.y RowIn, ellipse.center.x ColumnIn, ellipse.angle.rad PhiIn, ellipse.radius1 Radius1In, ellipse.radius2 Radius2In, out ellipse.center.y Row, out ellipse.center.x Column, out ellipse.angle.rad Phi, out ellipse.radius1 Radius1, out ellipse.radius2 Radius2 )
Descriptionπ
draw_ellipse_mod 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 are expected the parameters RowIn,
ColumnIn,PhiIn,Radius1In,Radius2In.
Keeping the button pressed determines the length (Radius1)
and the orientation (Phi) 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.
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π
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π
WindowHandle (input_control) window β (handle)
Window handle.
RowIn (input_control) ellipse.center.y β (real)
Row index of the center.
ColumnIn (input_control) ellipse.center.x β (real)
Column index of the center.
PhiIn (input_control) ellipse.angle.rad β (real)
Orientation of the bigger half axis in radians.
Radius1In (input_control) ellipse.radius1 β (real)
Bigger half axis.
Radius2In (input_control) ellipse.radius2 β (real)
Smaller half axis.
Row (output_control) ellipse.center.y β (real)
Row index of the center.
Column (output_control) ellipse.center.x β (real)
Column index of the center.
Phi (output_control) ellipse.angle.rad β (real)
Orientation of the first half axis in radians.
Radius1 (output_control) ellipse.radius1 β (real)
First half axis.
Radius2 (output_control) ellipse.radius2 β (real)
Second half axis.
Exampleπ
(HDevelop)
read_image(Image,'monkey')
draw_ellipse_mod(WindowHandle,RowIn,ColumnIn,PhiIn,Radius1In,Radius2In,\
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)
dev_display(Sobel)
(C)read_image(&Image,"monkey")\;
draw_ellipse_mod(WindowHandle,RowIn,ColumnIn,PhiIn,Radius1In,Radius2In,
&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_ellipse_mod returns 2 (H_MSG_TRUE) if the window is valid.
If necessary, an exception is raised.
Combinations with other operatorsπ
Combinations
Possible predecessors
Possible successors
reduce_domain, disp_region, set_colored, set_line_width, set_draw
Alternatives
draw_ellipse, draw_circle, draw_region
See also
Moduleπ
Foundation