disp_arcDispArcDispArcdisp_arcT_disp_arc🔗

Short description🔗

disp_arcDispArcDispArcdisp_arcT_disp_arc — Displays circular arcs in a window.

Signature🔗

disp_arc( window WindowHandle, arc.center.y CenterRow, arc.center.x CenterCol, arc.angle.rad Angle, arc.begin.y BeginRow, arc.begin.x BeginCol )

Description🔗

disp_arcDispArc displays one or several circular arcs in the output window. An arc is described by its center point (CenterRowcenterRowcenter_row,CenterColcenterColcenter_col), the angle between start and end of the arc (Angleangleangle in radians) and the first point of the arc (BeginRowbeginRowbegin_row,BeginColbeginColbegin_col). The arc is displayed in clockwise direction. The parameters for output can be determined - as with the output of regions - with the operators set_colorSetColor, set_graySetGray, set_drawSetDraw, etc. It is possible to draw several arcs with one call by using tuple parameters. For the use of colors with several arcs, see set_colorSetColor.

Attention🔗

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

Execution information🔗

Execution information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters🔗

WindowHandlewindowHandlewindow_handle (input_control) window → (handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window handle.

CenterRowcenterRowcenter_row (input_control) arc.center.y → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[int, float]Htuple (double / Hlong)

Row coordinate of center point.

Default: 6464
Suggested values: 0, 64, 128, 2560, 64, 128, 256
Value range: 0 ≤ CenterRow ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1

CenterColcenterColcenter_col (input_control) arc.center.x → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[int, float]Htuple (double / Hlong)

Column coordinate of center point.

Default: 6464
Suggested values: 0, 64, 128, 2560, 64, 128, 256
Value range: 0 ≤ CenterCol ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1

Angleangleangle (input_control) arc.angle.rad → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[int, float]Htuple (double / Hlong)

Angle between start and end of the arc (in radians).

Default: 3.14159263.1415926
Suggested values: 0.0, 0.785398, 1.570796, 3.1415926, 6.283185
Value range: 0.0 ≤ Angle ≤ 6.283185 (lin)
Minimum increment: 0.01
Recommended increment: 0.1
Restriction: Angle > 0.0

BeginRowbeginRowbegin_row (input_control) arc.begin.y(-array) → (integer / real)HTuple (Hlong / double)HTuple (int / long / double)MaybeSequence[Union[int, float]]Htuple (Hlong / double)

Row coordinate of the start of the arc.

Default: 3232
Suggested values: 0, 64, 128, 2560, 64, 128, 256
Value range: 0 ≤ BeginRow ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1

BeginColbeginColbegin_col (input_control) arc.begin.x(-array) → (integer / real)HTuple (Hlong / double)HTuple (int / long / double)MaybeSequence[Union[int, float]]Htuple (Hlong / double)

Column coordinate of the start of the arc.

Default: 3232
Suggested values: 0, 64, 128, 2560, 64, 128, 256
Value range: 0 ≤ BeginCol ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1

Example🔗

(HDevelop)

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

Result🔗

disp_arcDispArc returns 2 (H_MSG_TRUE).

Combinations with other operators🔗

Combinations

Possible predecessors

open_windowOpenWindow, set_drawSetDraw, set_colorSetColor, set_coloredSetColored, set_line_widthSetLineWidth, set_rgbSetRgb, set_hsiSetHsi

Alternatives

disp_circleDispCircle, disp_ellipseDispEllipse, disp_regionDispRegion, gen_circleGenCircle, gen_ellipseGenEllipse

Module🔗

Foundation