disp_circle

disp_circle ( : : WindowHandle, Row, Column, Radius : )

Displays circles in a window.

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

The procedures used to control the display of regions (e.g. set_draw, set_gray, set_draw) can also be used with circles. 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

`WindowHandle` (input_control)	window `->` integer
Window identifier.

`Row` (input_control)	circle.center.y(-array) `->` real / integer
Row index of the center.
Default value: 64
Suggested values: 0, 64, 128, 256
Typical 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
Typical 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
Typical 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','',WindowHandle) 
set_draw(WindowHandle,'fill') 
set_color(WindowHandle,'white') 
set_insert(WindowHandle,'not') 
repeat() 
  get_mbutton(WindowHandle,Row,Column,Button) 
  disp_circle(WindowHandle,Row,Column,(Row + Column) mod 50) 
until(Button = 1) 
close_window(WindowHandle).

Result

disp_circle returns 2 (H_MSG_TRUE).

Parallelization Information

disp_circle is reentrant, local, and processed without parallelization.

Possible Predecessors

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

Alternatives

disp_ellipse, disp_region, gen_circle, gen_ellipse

Module

Foundation