draw_line_modT_draw_line_modDrawLineModDrawLineModdraw_line_mod (Operator)
Name
draw_line_modT_draw_line_modDrawLineModDrawLineModdraw_line_mod — Draw a line.
Signature
void DrawLineMod(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::DrawLineMod(double Row1In, double Column1In, double Row2In, double Column2In, double* Row1, double* Column1, double* Row2, double* Column2) const
static void HOperatorSet.DrawLineMod(HTuple windowHandle, HTuple row1In, HTuple column1In, HTuple row2In, HTuple column2In, out HTuple row1, out HTuple column1, out HTuple row2, out HTuple column2)
void HWindow.DrawLineMod(double row1In, double column1In, double row2In, double column2In, out double row1, out double column1, out double row2, out double column2)
Description
draw_line_moddraw_line_modDrawLineModDrawLineModDrawLineModdraw_line_mod returns the parameter for a line, which has been
created interactively by the user in the window.
To create a line are expected the coordinates of the start point
Row1InRow1InRow1InRow1Inrow1Inrow_1in, Column1InColumn1InColumn1InColumn1Incolumn1Incolumn_1in and of the end point
Row2InRow2InRow2InRow2Inrow2Inrow_2in,Column2InColumn2InColumn2InColumn2Incolumn2Incolumn_2in.
If you click on one end point of the created line, you may move this point.
After another mouse click in the middle of the created line
you can move it.
Pressing the right mouse button terminates the procedure. On macOS
draw_line_moddraw_line_modDrawLineModDrawLineModDrawLineModdraw_line_mod can also be terminated by pressing the escape key.
After terminating the procedure the line 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.
Row1InRow1InRow1InRow1Inrow1Inrow_1in (input_control) line.begin.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the first point of the line.
Column1InColumn1InColumn1InColumn1Incolumn1Incolumn_1in (input_control) line.begin.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the first point of the line.
Row2InRow2InRow2InRow2Inrow2Inrow_2in (input_control) line.end.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the second point of the line.
Column2InColumn2InColumn2InColumn2Incolumn2Incolumn_2in (input_control) line.end.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the second point of the line.
Row1Row1Row1Row1row1row_1 (output_control) line.begin.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the first point of the line.
Column1Column1Column1Column1column1column_1 (output_control) line.begin.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the first point of the line.
Row2Row2Row2Row2row2row_2 (output_control) line.end.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Row index of the second point of the line.
Column2Column2Column2Column2column2column_2 (output_control) line.end.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Column index of the second point of the line.
Example (HDevelop)
draw_line_mod(WindowHandle,10,20,55,124,Row1,Column1,Row2,Column2)
gen_contour_polygon_xld (Line, [Row1,Row2], [Column1,Column2])
dev_display (Line)
Example (C)
draw_line(WindowHandle,10,20,55,124,&Row1,&Column1,&Row2,&Column2);
disp_line(WindowHandle,Row1,Column1,Row2,Column2);
Example (HDevelop)
draw_line_mod(WindowHandle,10,20,55,124,Row1,Column1,Row2,Column2)
gen_contour_polygon_xld (Line, [Row1,Row2], [Column1,Column2])
dev_display (Line)
Example (HDevelop)
draw_line_mod(WindowHandle,10,20,55,124,Row1,Column1,Row2,Column2)
gen_contour_polygon_xld (Line, [Row1,Row2], [Column1,Column2])
dev_display (Line)
Example (HDevelop)
draw_line_mod(WindowHandle,10,20,55,124,Row1,Column1,Row2,Column2)
gen_contour_polygon_xld (Line, [Row1,Row2], [Column1,Column2])
dev_display (Line)
Result
draw_line_moddraw_line_modDrawLineModDrawLineModDrawLineModdraw_line_mod returns TRUE, if the window is valid and the
needed drawing mode is available.
If necessary, an exception is raised.
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
Possible Successors
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain,
disp_linedisp_lineDispLineDispLineDispLinedisp_line,
set_coloredset_coloredSetColoredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width,
set_drawset_drawSetDrawSetDrawSetDrawset_draw,
set_insertset_insertSetInsertSetInsertSetInsertset_insert
Alternatives
draw_linedraw_lineDrawLineDrawLineDrawLinedraw_line,
draw_ellipsedraw_ellipseDrawEllipseDrawEllipseDrawEllipsedraw_ellipse,
draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region
See also
gen_circlegen_circleGenCircleGenCircleGenCirclegen_circle,
draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1draw_rectangle1,
draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2draw_rectangle2
Module
Foundation