disp_circle ( : : Row, Column, Radius : )

Displays circles in a window.

disp_circle displays one or several circles in the current output window. A circle is described by the center (Row, Column) and the radius Radius. If the used coordinates are not within the current window the circle is clipped accordingly.

The procedures used to control the display of regions (e.g. set_draw, set_grey, set_draw) can also be used with circles. The output window is set with the procedure set_window. Several circles can be displayed with one call by using tuple parameters. For the use of colors with several circles, see set_color.


Attention

The center of the circle must be within the window.


Parameters

Row (input_control)
circle.center.y(-array) -> real / integer
row index of the center.
Default value: 64
Suggested values: 0, 64, 128, 256
Range of values: 0 <= Row <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

Column (input_control)
circle.center.x(-array) -> real / integer
column index of the center.
Default value: 64
Suggested values: 0, 64, 128, 256
Range of values: 0 <= Column <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

Radius (input_control)
circle.radius(-array) -> real / integer
radius of the circle.
Default value: 64
Suggested values: 0, 64, 128, 256
Range of values: 0 <= Radius <= 511 (lin)
Minimum increment: 1
Recommended increment: 1
Restriction: Radius > 0.0


Example
open_window(::0,0,-1,-1,'root','visible','':) >
set_draw(::'fill':) >
set_color(::'white':) >
set_insert(::'not':) >
repeat(:::) >
get_mbutton(:::Row,Column,Button) >
disp_circle(::Row,Column,(Row + Column) mod 50:) >
until(::Button = 1:) >
close_window(:::).

Result

disp_circle 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_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