disp_circle

Herror ::disp_circle ( const HTuple &WindowHandle, const HTuple &Row, const HTuple &Column, const HTuple &Radius ) void HWindow::DispCircle ( const HTuple &Row, const HTuple &Column, const HTuple &Radius ) const

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 `->` HTuple.long
Window identifier.

`Row` (input_control)	circle.center.y(-array) `->` HTuple.double / long
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) `->` HTuple.double / long
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) `->` HTuple.double / long
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") ;
get_mbutton(WindowHandle,&Row,&Column,&Button) ;
disp_circle(WindowHandle,Row,Column,(Row + Column) mod 50) ;

Result

::disp_circle returns H_MSG_TRUE.

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

System