disp_line ( : : Row1, Column1, Row2, Column2 : )

Draws lines in a window.

disp_line displays one or several lines in the current output window. A line is described by the coordinates of the start (Row1,Column1) and the coordinates of the end (Row2,Column2). The procedures used to control the display of regions (e.g. set_color, set_grey, set_draw, set_line_width) can also be used with lines. The output window is set with the procedure set_window. Several lines can be displayed with one call by using tuple parameters. For the use of colors with several lines, see set_color.


Attention

The starting points and the ending points of the lines must lie within the window.


Parameters

Row1 (input_control)
line.begin.y(-array) -> integer
row index of the start.
Default value: 32
Suggested values: 0, 64, 128, 256, 511
Range of values: 0 <= Row1 <= 511 (lin)
Minimum increment: 1
Recommended increment: 10

Column1 (input_control)
line.begin.x(-array) -> integer
column index of the start.
Default value: 32
Suggested values: 0, 64, 128, 256, 511
Range of values: 0 <= Column1 <= 511 (lin)
Minimum increment: 1
Recommended increment: 10

Row2 (input_control)
line.end.y(-array) -> integer
row index of end.
Default value: 64
Suggested values: 0, 64, 128, 256, 511
Range of values: 0 <= Row2 <= 511 (lin)
Minimum increment: 1
Recommended increment: 10

Column2 (input_control)
line.end.x(-array) -> integer
column index of end.
Default value: 64
Suggested values: 0, 64, 128, 256, 511
Range of values: 0 <= Column2 <= 511 (lin)
Minimum increment: 1
Recommended increment: 10


Example
/* Prozedur zur Ausgabe der Kontur eines Rechtecks: /* 

disp_rectangle1_margin(::Row1,Column1,Row2,Column2:):
  disp_line(::Row1,Column1,Row1,Column2:) >
  disp_line(::Row1,Column2,Row2,Column2:) >
  disp_line(::Row2,Column2,Row2,Column1:) >
  disp_line(::Row2,Column1,Row1,Column1:).

Result

disp_line returns TRUE, if a window is activated and the parameters are correct. Otherwise an exception is raised.


Possible Predecessors

open_window, set_rgb, set_lut, set_hsi, set_window, set_draw, set_color, set_colored, set_line_width


Alternatives

disp_arrow, disp_rectangle1, disp_rectangle2, disp_region, store_polygon, store_coord


See also

open_window, open_textwindow, set_color, set_rgb, set_hsi, set_insert, set_line_width, set_window



Copyright © 1996-1997 MVTec Software GmbH