disp_arrow ( : : Row1, Column1, Row2, Column2, Size : )

Displays arrows in a window.

disp_arrow displays one or several arrows in the current output window. An arrow is described by the coordinates of the start (Row1,Column1) and the end (Row2,Column2). An arrowhead is displayed at the end of the arrow. The size of the arrowhead is specified by the parameter Size. If the arrow consists of just one point (start = end) nothing is displayed. The procedures used to control the display of regions (e.g. set_draw, set_color, set_line_width) can also be used with arrows. Several arrows can be displayed with one call by using tuple parameters. For the use of colors with several arcs, see set_color.


Attention

The start and the end of the arrows must fall within the window.


Parameters

Row1 (input_control)
line.begin.y(-array) -> real / integer
row index of the start.
Default value: 10.0
Suggested values: 0.0, 64.0, 128.0, 256.0
Range of values: 0.0 <= Row1 <= 511.0 (lin)
Minimum increment: 1.0
Recommended increment: 1.0

Column1 (input_control)
line.begin.x(-array) -> real / integer
column index of the start.
Default value: 10.0
Suggested values: 0.0, 64.0, 128.0, 256.0
Range of values: 0.0 <= Column1 <= 511.0 (lin)
Minimum increment: 1.0
Recommended increment: 1.0

Row2 (input_control)
line.end.y(-array) -> real / integer
row index of the end.
Default value: 118.0
Suggested values: 0.0, 64.0, 128.0, 256.0
Range of values: 0.0 <= Row2 <= 511.0 (lin)
Minimum increment: 1.0
Recommended increment: 1.0

Column2 (input_control)
line.end.x(-array) -> real / integer
column index of the end.
Default value: 118.0
Suggested values: 0.0, 64.0, 128.0, 256.0
Range of values: 0.0 <= Column2 <= 511.0 (lin)
Minimum increment: 1.0
Recommended increment: 1.0

Size (input_control)
number -> real / integer
size of the arrowhead.
Default value: 1.0
Suggested values: 1.0, 2.0, 3.0, 5.0
Range of values: 0.0 <= Size <= 20.0 (lin)
Minimum increment: 1.0
Recommended increment: 1.0
Restriction: Size > 0.0


Example
set_colored(3) ;
disp_arrow(10,10,118,118,1.0);

Result

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


Possible Predecessors

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


Alternatives

disp_line, store_polygon, disp_region


See also

open_window, open_textwindow, set_color, set_draw, set_line_width



Copyright © 1996-1997 MVTec Software GmbH