Skip to content

draw_line_modDrawLineModDrawLineModdraw_line_modT_draw_line_mod🔗

Short description🔗

draw_line_modDrawLineModDrawLineModdraw_line_modT_draw_line_mod — Draw a line.

Signature🔗

draw_line_mod( window WindowHandle, line.begin.y Row1In, line.begin.x Column1In, line.end.y Row2In, line.end.x Column2In, out line.begin.y Row1, out line.begin.x Column1, out line.end.y Row2, out line.end.x Column2 )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 )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 )def draw_line_mod( window_handle: HHandle, row_1in: float, column_1in: float, row_2in: float, column_2in: float ) -> Tuple[float, float, float, float]

Herror T_draw_line_mod( 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

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_modDrawLineMod 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 Row1Inrow1Inrow_1in, Column1Incolumn1Incolumn_1in and of the end point Row2Inrow2Inrow_2in,Column2Incolumn2Incolumn_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.

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🔗

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🔗

WindowHandlewindowHandlewindow_handle (input_control) window → (handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window handle.

Row1Inrow1Inrow_1in (input_control) line.begin.y → (real)HTuple (double)HTuple (double)floatHtuple (double)

Row index of the first point of the line.

Column1Incolumn1Incolumn_1in (input_control) line.begin.x → (real)HTuple (double)HTuple (double)floatHtuple (double)

Column index of the first point of the line.

Row2Inrow2Inrow_2in (input_control) line.end.y → (real)HTuple (double)HTuple (double)floatHtuple (double)

Row index of the second point of the line.

Column2Incolumn2Incolumn_2in (input_control) line.end.x → (real)HTuple (double)HTuple (double)floatHtuple (double)

Column index of the second point of the line.

Row1row1row_1 (output_control) line.begin.y → (real)HTuple (double)HTuple (double)floatHtuple (double)

Row index of the first point of the line.

Column1column1column_1 (output_control) line.begin.x → (real)HTuple (double)HTuple (double)floatHtuple (double)

Column index of the first point of the line.

Row2row2row_2 (output_control) line.end.y → (real)HTuple (double)HTuple (double)floatHtuple (double)

Row index of the second point of the line.

Column2column2column_2 (output_control) line.end.x → (real)HTuple (double)HTuple (double)floatHtuple (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)
(C)
draw_line(WindowHandle,10,20,55,124,&Row1,&Column1,&Row2,&Column2)\;
disp_line(WindowHandle,Row1,Column1,Row2,Column2)\;

Result🔗

draw_line_modDrawLineMod returns 2 (H_MSG_TRUE) if the window is valid. If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

open_windowOpenWindow

Possible successors

reduce_domainReduceDomain, disp_lineDispLine, set_coloredSetColored, set_line_widthSetLineWidth, set_drawSetDraw

Alternatives

draw_lineDrawLine, draw_ellipseDrawEllipse, draw_regionDrawRegion

See also

gen_circleGenCircle, draw_rectangle1DrawRectangle1, draw_rectangle2DrawRectangle2

Module🔗

Foundation