draw_rectangle2_modT_draw_rectangle2_modDrawRectangle2ModDrawRectangle2Moddraw_rectangle2_mod (Operator)
Name
draw_rectangle2_modT_draw_rectangle2_modDrawRectangle2ModDrawRectangle2Moddraw_rectangle2_mod — Interactive drawing of any orientated rectangle.
Signature
Herror T_draw_rectangle2_mod(const Htuple WindowHandle, const Htuple RowIn, const Htuple ColumnIn, const Htuple PhiIn, const Htuple Length1In, const Htuple Length2In, Htuple* Row, Htuple* Column, Htuple* Phi, Htuple* Length1, Htuple* Length2)
void DrawRectangle2Mod(const HTuple& WindowHandle, const HTuple& RowIn, const HTuple& ColumnIn, const HTuple& PhiIn, const HTuple& Length1In, const HTuple& Length2In, HTuple* Row, HTuple* Column, HTuple* Phi, HTuple* Length1, HTuple* Length2)
void HWindow::DrawRectangle2Mod(double RowIn, double ColumnIn, double PhiIn, double Length1In, double Length2In, double* Row, double* Column, double* Phi, double* Length1, double* Length2) const
static void HOperatorSet.DrawRectangle2Mod(HTuple windowHandle, HTuple rowIn, HTuple columnIn, HTuple phiIn, HTuple length1In, HTuple length2In, out HTuple row, out HTuple column, out HTuple phi, out HTuple length1, out HTuple length2)
void HWindow.DrawRectangle2Mod(double rowIn, double columnIn, double phiIn, double length1In, double length2In, out double row, out double column, out double phi, out double length1, out double length2)
Description
draw_rectangle2_moddraw_rectangle2_modDrawRectangle2ModDrawRectangle2ModDrawRectangle2Moddraw_rectangle2_mod returns the parameter for any orientated
rectangle, which has been created interactively by the user in the window.
The created rectangle is described by its center, its two half axes and the
angle between the first half axis and the horizontal coordinate axis.
To create a rectangle are expected the parameters RowInRowInRowInRowInrowInrow_in,
ColumnInColumnInColumnInColumnIncolumnIncolumn_in,PhiInPhiInPhiInPhiInphiInphi_in,Length1InLength1InLength1InLength1Inlength1Inlength_1in,Length2InLength2InLength2InLength2Inlength2Inlength_2in.
A click close to one side “grips” it to modify the rectangle's dimension
in perpendicular direction (Length2Length2Length2Length2length2length_2) to this side. You only can
modify the orientation (PhiPhiPhiPhiphiphi), if you grip a side perpendicular to
the first half axis. After another mouse click in the middle of the created
rectangle, you can move it. Pressing the right mouse button terminates the
procedure. On macOS draw_rectangle2_moddraw_rectangle2_modDrawRectangle2ModDrawRectangle2ModDrawRectangle2Moddraw_rectangle2_mod can also be terminated
by pressing the escape key.
After terminating the procedure the rectangle 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) rectangle2.center.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the center.
ColumnInColumnInColumnInColumnIncolumnIncolumn_in (input_control) rectangle2.center.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the center.
PhiInPhiInPhiInPhiInphiInphi_in (input_control) rectangle2.angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Orientation of the bigger half axis in radians.
Length1InLength1InLength1InLength1Inlength1Inlength_1in (input_control) rectangle2.hwidth → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Bigger half axis.
Length2InLength2InLength2InLength2Inlength2Inlength_2in (input_control) rectangle2.hheight → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Smaller half axis.
RowRowRowRowrowrow (output_control) rectangle2.center.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the center.
ColumnColumnColumnColumncolumncolumn (output_control) rectangle2.center.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the center.
PhiPhiPhiPhiphiphi (output_control) rectangle2.angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Orientation of the bigger half axis in radians.
Length1Length1Length1Length1length1length_1 (output_control) rectangle2.hwidth → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Bigger half axis.
Length2Length2Length2Length2length2length_2 (output_control) rectangle2.hheight → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Smaller half axis.
Result
draw_rectangle2_moddraw_rectangle2_modDrawRectangle2ModDrawRectangle2ModDrawRectangle2Moddraw_rectangle2_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_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2draw_rectangle2,
draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1draw_rectangle1,
draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2draw_rectangle2,
draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region
See also
gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2gen_rectangle2,
draw_circledraw_circleDrawCircleDrawCircleDrawCircledraw_circle,
draw_ellipsedraw_ellipseDrawEllipseDrawEllipseDrawEllipsedraw_ellipse,
set_insertset_insertSetInsertSetInsertSetInsertset_insert
Module
Foundation