draw_rectangle1_modT_draw_rectangle1_modDrawRectangle1ModDrawRectangle1Moddraw_rectangle1_mod (Operator)
draw_rectangle1_modT_draw_rectangle1_modDrawRectangle1ModDrawRectangle1Moddraw_rectangle1_mod — Draw a rectangle parallel to the coordinate axis.
Signature
void DrawRectangle1Mod(const HTuple& WindowHandle, const HTuple& Row1In, const HTuple& Column1In, const HTuple& Row2In, const HTuple& Column2In, HTuple* Row1, HTuple* Column1, HTuple* Row2, HTuple* Column2)
void HWindow::DrawRectangle1Mod(double Row1In, double Column1In, double Row2In, double Column2In, double* Row1, double* Column1, double* Row2, double* Column2) const
static void HOperatorSet.DrawRectangle1Mod(HTuple windowHandle, HTuple row1In, HTuple column1In, HTuple row2In, HTuple column2In, out HTuple row1, out HTuple column1, out HTuple row2, out HTuple column2)
void HWindow.DrawRectangle1Mod(double row1In, double column1In, double row2In, double column2In, out double row1, out double column1, out double row2, out double column2)
Description
draw_rectangle1_moddraw_rectangle1_modDrawRectangle1ModDrawRectangle1Moddraw_rectangle1_mod returns the parameter for a rectangle parallel
to the coordinate axes, which has been created interactively by the user
in the window.
To create a rectangle are expected the parameters Row1InRow1InRow1Inrow1Inrow_1in,
Column1InColumn1InColumn1Incolumn1Incolumn_1in,Row2InRow2InRow2Inrow2Inrow_2in and Column2InColumn2InColumn2Incolumn2Incolumn_2in.
After a mouse click in the middle of the created rectangle you can move it.
A click close to one side “grips” it to modify the rectangle's dimension in perpendicular
direction to this side. If you click on one corner of the created rectangle, you may
move this corner.
Pressing the right mouse button terminates the procedure.
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
WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Window handle.
Row1InRow1InRow1Inrow1Inrow_1in (input_control) rectangle.origin.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the left upper corner.
Column1InColumn1InColumn1Incolumn1Incolumn_1in (input_control) rectangle.origin.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the left upper corner.
Row2InRow2InRow2Inrow2Inrow_2in (input_control) rectangle.corner.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the right lower corner.
Column2InColumn2InColumn2Incolumn2Incolumn_2in (input_control) rectangle.corner.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the right lower corner.
Row1Row1Row1row1row_1 (output_control) rectangle.origin.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the left upper corner.
Column1Column1Column1column1column_1 (output_control) rectangle.origin.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the left upper corner.
Row2Row2Row2row2row_2 (output_control) rectangle.corner.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the right lower corner.
Column2Column2Column2column2column_2 (output_control) rectangle.corner.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the right lower corner.
Example (HDevelop)
read_image(Image,'monkey')
get_image_size (Image, Width, Height)
dev_display (Image)
draw_rectangle1_mod(WindowHandle,100,100,200,300,\
Row1,Column1,Row2,Column2)
dev_set_part (Row1, Column1, Row2, Column2)
dev_display (Image)
Example (C)
read_image(&Image,"monkey");
get_image_size(Image,&Width,&Height);
disp_image(Image,WindowHandle);
draw_rectangle1_mod(WindowHandle,100,100,200,300,
&Row1,&Column1,&Row2,&Column2);
set_part(WindowHandle,Row1,Column1,Row2,Column2);
disp_image(Image,WindowHandle);
Example (HDevelop)
read_image(Image,'monkey')
get_image_size (Image, Width, Height)
dev_display (Image)
draw_rectangle1_mod(WindowHandle,100,100,200,300,\
Row1,Column1,Row2,Column2)
dev_set_part (Row1, Column1, Row2, Column2)
dev_display (Image)
Example (HDevelop)
read_image(Image,'monkey')
get_image_size (Image, Width, Height)
dev_display (Image)
draw_rectangle1_mod(WindowHandle,100,100,200,300,\
Row1,Column1,Row2,Column2)
dev_set_part (Row1, Column1, Row2, Column2)
dev_display (Image)
Result
draw_rectangle1_moddraw_rectangle1_modDrawRectangle1ModDrawRectangle1Moddraw_rectangle1_mod returns 2 (
H_MSG_TRUE)
, if the window is valid and the
needed drawing mode (see set_insertset_insertSetInsertSetInsertset_insert) is available.
If necessary, an exception is raised.
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowopen_window
Possible Successors
reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain,
disp_regiondisp_regionDispRegionDispRegiondisp_region,
set_coloredset_coloredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthset_line_width,
set_drawset_drawSetDrawSetDrawset_draw,
set_insertset_insertSetInsertSetInsertset_insert
Alternatives
draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1draw_rectangle1,
draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2draw_rectangle2,
draw_regiondraw_regionDrawRegionDrawRegiondraw_region
See also
gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1gen_rectangle1,
draw_circledraw_circleDrawCircleDrawCircledraw_circle,
draw_ellipsedraw_ellipseDrawEllipseDrawEllipsedraw_ellipse,
set_insertset_insertSetInsertSetInsertset_insert
Module
Foundation