draw_ellipse_modT_draw_ellipse_modDrawEllipseModDrawEllipseModdraw_ellipse_mod (Operator)
Name
draw_ellipse_modT_draw_ellipse_modDrawEllipseModDrawEllipseModdraw_ellipse_mod — Interactive drawing of an ellipse.
Signature
Herror T_draw_ellipse_mod(const Htuple WindowHandle, const Htuple RowIn, const Htuple ColumnIn, const Htuple PhiIn, const Htuple Radius1In, const Htuple Radius2In, Htuple* Row, Htuple* Column, Htuple* Phi, Htuple* Radius1, Htuple* Radius2)
void DrawEllipseMod(const HTuple& WindowHandle, const HTuple& RowIn, const HTuple& ColumnIn, const HTuple& PhiIn, const HTuple& Radius1In, const HTuple& Radius2In, HTuple* Row, HTuple* Column, HTuple* Phi, HTuple* Radius1, HTuple* Radius2)
void HWindow::DrawEllipseMod(double RowIn, double ColumnIn, double PhiIn, double Radius1In, double Radius2In, double* Row, double* Column, double* Phi, double* Radius1, double* Radius2) const
static void HOperatorSet.DrawEllipseMod(HTuple windowHandle, HTuple rowIn, HTuple columnIn, HTuple phiIn, HTuple radius1In, HTuple radius2In, out HTuple row, out HTuple column, out HTuple phi, out HTuple radius1, out HTuple radius2)
void HWindow.DrawEllipseMod(double rowIn, double columnIn, double phiIn, double radius1In, double radius2In, out double row, out double column, out double phi, out double radius1, out double radius2)
Description
draw_ellipse_moddraw_ellipse_modDrawEllipseModDrawEllipseModDrawEllipseModdraw_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 RowInRowInRowInRowInrowInrow_in,
ColumnInColumnInColumnInColumnIncolumnIncolumn_in,PhiInPhiInPhiInPhiInphiInphi_in,Radius1InRadius1InRadius1InRadius1Inradius1Inradius_1in,Radius2InRadius2InRadius2InRadius2Inradius2Inradius_2in.
Keeping the button pressed determines the length (Radius1Radius1Radius1Radius1radius1radius_1)
and the orientation (PhiPhiPhiPhiphiphi) 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. On macOS
draw_ellipse_moddraw_ellipse_modDrawEllipseModDrawEllipseModDrawEllipseModdraw_ellipse_mod can also be terminated by pressing the escape key.
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
- 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.
RowInRowInRowInRowInrowInrow_in (input_control) ellipse.center.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the center.
ColumnInColumnInColumnInColumnIncolumnIncolumn_in (input_control) ellipse.center.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the center.
PhiInPhiInPhiInPhiInphiInphi_in (input_control) ellipse.angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Orientation of the bigger half axis in radians.
Radius1InRadius1InRadius1InRadius1Inradius1Inradius_1in (input_control) ellipse.radius1 → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Bigger half axis.
Radius2InRadius2InRadius2InRadius2Inradius2Inradius_2in (input_control) ellipse.radius2 → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Smaller half axis.
RowRowRowRowrowrow (output_control) ellipse.center.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the center.
ColumnColumnColumnColumncolumncolumn (output_control) ellipse.center.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the center.
PhiPhiPhiPhiphiphi (output_control) ellipse.angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Orientation of the first half axis in radians.
Radius1Radius1Radius1Radius1radius1radius_1 (output_control) ellipse.radius1 → HTuplefloatHTupleHtuple (real) (double) (double) (double)
First half axis.
Radius2Radius2Radius2Radius2radius2radius_2 (output_control) ellipse.radius2 → HTuplefloatHTupleHtuple (real) (double) (double) (double)
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)
Example (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);
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)
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)
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)
Result
draw_ellipse_moddraw_ellipse_modDrawEllipseModDrawEllipseModDrawEllipseModdraw_ellipse_mod 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_ellipsedraw_ellipseDrawEllipseDrawEllipseDrawEllipsedraw_ellipse,
draw_circledraw_circleDrawCircleDrawCircleDrawCircledraw_circle,
draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region
See also
gen_ellipsegen_ellipseGenEllipseGenEllipseGenEllipsegen_ellipse,
draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1draw_rectangle1,
draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2draw_rectangle2,
draw_polygondraw_polygonDrawPolygonDrawPolygonDrawPolygondraw_polygon,
set_insertset_insertSetInsertSetInsertSetInsertset_insert
Module
Foundation