disp_arc ( : : CenterRow, CenterCol, Angle, BeginRow, BeginCol : )

Displays circular arcs in a window.

disp_arc displays one or several circular arcs in the current output window. An arc is described by its center point (CenterRow,CenterCol), the angle between start and end of the arc (Angle in radians) and the first point of the arc (BeginRow,BeginCol). The arc is displayed in clockwise direction. The parameters for output can be determined - as with the output of regions - with the procedures set_color, set_grey, set_draw, etc. The output window is set with the procedure set_window. It is possible to draw several arcs with one call by using tupel parameters. For the use of colors with several arcs, see set_color.


Attention

The center point has to be within the window. The radius of the arc has be at least 2 pixel.


Parameters

CenterRow (input_control)
arc.center.y -> real / integer
row coordinate of center point.
Default value: 64
Suggested values: 0, 64, 128, 256
Range of values: 0 <= CenterRow <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

CenterCol (input_control)
arc.center.x -> real / integer
column coordinate of center point.
Default value: 64
Suggested values: 0, 64, 128, 256
Range of values: 0 <= CenterCol <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

Angle (input_control)
arc.angle.rad -> real / integer
angle between start and end of the arc (in radians).
Default value: 3.1415926
Suggested values: 0.0, 0.785398, 1.570796, 3.1415926, 6.283185
Range of values: 0.0 <= Angle <= 6.283185 (lin)
Minimum increment: 0.01
Recommended increment: 0.1
Restriction: Angle > 0.0

BeginRow (input_control)
arc.begin.y(-array) -> integer / real
row coordinate of the start of the arc.
Default value: 32
Suggested values: 0, 64, 128, 256
Range of values: 0 <= BeginRow <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

BeginCol (input_control)
arc.begin.x(-array) -> integer / real
column coordinate of the start of the arc.
Default value: 32
Suggested values: 0, 64, 128, 256
Range of values: 0 <= BeginCol <= 511 (lin)
Minimum increment: 1
Recommended increment: 1


Example
open_window(::0,0,-1,-1,'root','visible','':) >
set_draw(::'fill':) >
set_color(::'white':) >
set_insert(::'not':) >
Row = 100 >
Column = 100 >
disp_arc(::Row,Column,3.14,Row+10,Column+10:) >
close_window(:::).

Result

disp_arc returns TRUE, if a window is activated. 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_circle, disp_ellipse, disp_region, circle, ellipse


See also

open_window, open_textwindow, set_color, set_draw, set_rgb, set_hsi, set_window



Copyright © 1996-1997 MVTec Software GmbH