disp_arcT_disp_arcDispArcDispArcdisp_arc (Operator)
Name
disp_arcT_disp_arcDispArcDispArcdisp_arc — Displays circular arcs in a window.
Signature
void DispArc(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
void HWindow::DispArc(double CenterRow, double CenterCol, double Angle, Hlong BeginRow, Hlong BeginCol) const
static void HOperatorSet.DispArc(HTuple windowHandle, HTuple centerRow, HTuple centerCol, HTuple angle, HTuple beginRow, HTuple beginCol)
void HWindow.DispArc(HTuple centerRow, HTuple centerCol, HTuple angle, HTuple beginRow, HTuple beginCol)
void HWindow.DispArc(double centerRow, double centerCol, double angle, int beginRow, int beginCol)
def disp_arc(window_handle: HHandle, center_row: Union[int, float], center_col: Union[int, float], angle: Union[int, float], begin_row: MaybeSequence[Union[int, float]], begin_col: MaybeSequence[Union[int, float]]) -> None
Description
disp_arcdisp_arcDispArcDispArcDispArcdisp_arc displays one or several circular arcs in the
output window. An arc is described by its center point
(CenterRowCenterRowCenterRowCenterRowcenterRowcenter_row,CenterColCenterColCenterColCenterColcenterColcenter_col), the angle between start and end
of the arc (AngleAngleAngleAngleangleangle in radians) and the first point of the arc
(BeginRowBeginRowBeginRowBeginRowbeginRowbegin_row,BeginColBeginColBeginColBeginColbeginColbegin_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_colorset_colorSetColorSetColorSetColorset_color, set_grayset_graySetGraySetGraySetGrayset_gray,
set_drawset_drawSetDrawSetDrawSetDrawset_draw, 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_colorset_colorSetColorSetColorSetColorset_color.
Attention
The center point has to be within the window. The radius of the arc has be
at least 2 pixel.
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
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Window handle.
CenterRowCenterRowCenterRowCenterRowcenterRowcenter_row (input_control) arc.center.y → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Row coordinate of center point.
Default value: 64
Suggested values: 0, 64, 128, 256
Typical range of values: 0
≤
CenterRow
CenterRow
CenterRow
CenterRow
centerRow
center_row
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
CenterColCenterColCenterColCenterColcenterColcenter_col (input_control) arc.center.x → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Column coordinate of center point.
Default value: 64
Suggested values: 0, 64, 128, 256
Typical range of values: 0
≤
CenterCol
CenterCol
CenterCol
CenterCol
centerCol
center_col
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
AngleAngleAngleAngleangleangle (input_control) arc.angle.rad → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
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
Angle
Angle
Angle
angle
angle
≤
6.283185 (lin)
Minimum increment: 0.01
Recommended increment: 0.1
Restriction: Angle > 0.0
BeginRowBeginRowBeginRowBeginRowbeginRowbegin_row (input_control) arc.begin.y(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Row coordinate of the start of the arc.
Default value: 32
Suggested values: 0, 64, 128, 256
Typical range of values: 0
≤
BeginRow
BeginRow
BeginRow
BeginRow
beginRow
begin_row
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
BeginColBeginColBeginColBeginColbeginColbegin_col (input_control) arc.begin.x(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Column coordinate of the start of the arc.
Default value: 32
Suggested values: 0, 64, 128, 256
Typical range of values: 0
≤
BeginCol
BeginCol
BeginCol
BeginCol
beginCol
begin_col
≤
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_arcdisp_arcDispArcDispArcDispArcdisp_arc returns 2 (H_MSG_TRUE).
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window,
set_drawset_drawSetDrawSetDrawSetDrawset_draw,
set_colorset_colorSetColorSetColorSetColorset_color,
set_coloredset_coloredSetColoredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width,
set_rgbset_rgbSetRgbSetRgbSetRgbset_rgb,
set_hsiset_hsiSetHsiSetHsiSetHsiset_hsi
Alternatives
disp_circledisp_circleDispCircleDispCircleDispCircledisp_circle,
disp_ellipsedisp_ellipseDispEllipseDispEllipseDispEllipsedisp_ellipse,
disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region,
gen_circlegen_circleGenCircleGenCircleGenCirclegen_circle,
gen_ellipsegen_ellipseGenEllipseGenEllipseGenEllipsegen_ellipse
See also
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window,
set_colorset_colorSetColorSetColorSetColorset_color,
set_drawset_drawSetDrawSetDrawSetDrawset_draw,
set_rgbset_rgbSetRgbSetRgbSetRgbset_rgb,
set_hsiset_hsiSetHsiSetHsiSetHsiset_hsi
Module
Foundation