disp_arc

Herror ::disp_arc ( const HTuple &WindowHandle, const HTuple &CenterRow, const HTuple &CenterCol, const HTuple &Angle, const HTuple &BeginRow, const HTuple &BeginCol ) void HWindow::DispArc ( const HTuple &CenterRow, const HTuple &CenterCol, const HTuple &Angle, const HTuple &BeginRow, const HTuple &BeginCol ) const

Displays circular arcs in a window.

::disp_arc displays one or several circular arcs in the 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_gray, ::set_draw, etc. 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

`WindowHandle` (input_control)	window `->` HTuple.long
Window identifier.

`CenterRow` (input_control)	arc.center.y `->` HTuple.double / long
Row coordinate of center point.
Default value: 64
Suggested values: 0, 64, 128, 256
Typical range of values: `0 <= CenterRow <= 511` (lin)
Minimum increment: 1
Recommended increment: 1

`CenterCol` (input_control)	arc.center.x `->` HTuple.double / long
Column coordinate of center point.
Default value: 64
Suggested values: 0, 64, 128, 256
Typical range of values: `0 <= CenterCol <= 511` (lin)
Minimum increment: 1
Recommended increment: 1

`Angle` (input_control)	arc.angle.rad `->` HTuple.double / long
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
Typical 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) `->` HTuple.long / double
Row coordinate of the start of the arc.
Default value: 32
Suggested values: 0, 64, 128, 256
Typical range of values: `0 <= BeginRow <= 511` (lin)
Minimum increment: 1
Recommended increment: 1

`BeginCol` (input_control)	arc.begin.x(-array) `->` HTuple.long / double
Column coordinate of the start of the arc.
Default value: 32
Suggested values: 0, 64, 128, 256
Typical range of values: `0 <= BeginCol <= 511` (lin)
Minimum increment: 1
Recommended increment: 1

Example

double Row, Column, WindowHandle;
open_window(0,0,-1,-1,"root","visible","",&WindowHandle) ;
set_draw(WindowHandle,"fill") ;
set_color(WindowHandle,"white") ;
set_insert(WindowHandle,"not") ;
Row = 100 ;
Column = 100 ;
disp_arc(WindowHandle,Row,Column,(double)3.14,(int)Row+10,(int)Column+10) ;
close_window(WindowHandle).

Result

::disp_arc returns H_MSG_TRUE.

Possible Predecessors

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

Alternatives

::disp_circle, ::disp_ellipse, ::disp_region, ::gen_circle, ::gen_ellipse

Module

System