Operator Reference

HALCON Operator Reference / Graphics / Output
ClassesClasses | | Operators

disp_arcT_disp_arcDispArcDispArcdisp_arc (Operator)

disp_arcT_disp_arcDispArcDispArcdisp_arc — Displays circular arcs in a window.

Signature

Herror T_disp_arc(const Htuple WindowHandle, const Htuple CenterRow, const Htuple CenterCol, const Htuple Angle, const Htuple BeginRow, const Htuple BeginCol)

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

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_arcDispArcDispArcdisp_arc displays one or several circular arcs in the output window. An arc is described by its center point (CenterRowCenterRowCenterRowcenterRowcenter_row,CenterColCenterColCenterColcenterColcenter_col), the angle between start and end of the arc (AngleAngleAngleangleangle in radians) and the first point of the arc (BeginRowBeginRowBeginRowbeginRowbegin_row,BeginColBeginColBeginColbeginColbegin_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_colorSetColorSetColorset_color, set_grayset_graySetGraySetGrayset_gray, set_drawset_drawSetDrawSetDrawset_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_colorSetColorSetColorset_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

WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control)  window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Window handle.

CenterRowCenterRowCenterRowcenterRowcenter_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: 64

Suggested values: 0, 64, 128, 256

Value range: 0 ≤ CenterRow CenterRow CenterRow centerRow center_row ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

CenterColCenterColCenterColcenterColcenter_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: 64

Suggested values: 0, 64, 128, 256

Value range: 0 ≤ CenterCol CenterCol CenterCol centerCol center_col ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

AngleAngleAngleangleangle (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: 3.1415926

Suggested values: 0.0, 0.785398, 1.570796, 3.1415926, 6.283185

Value range: 0.0 ≤ Angle Angle Angle angle angle ≤ 6.283185 (lin)

Minimum increment: 0.01

Recommended increment: 0.1

Restriction: Angle > 0.0

BeginRowBeginRowBeginRowbeginRowbegin_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: 32

Suggested values: 0, 64, 128, 256

Value range: 0 ≤ BeginRow BeginRow BeginRow beginRow begin_row ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

BeginColBeginColBeginColbeginColbegin_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: 32

Suggested values: 0, 64, 128, 256

Value range: 0 ≤ 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_arcDispArcDispArcdisp_arc returns 2 ( H_MSG_TRUE) .

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowopen_window, set_drawset_drawSetDrawSetDrawset_draw, set_colorset_colorSetColorSetColorset_color, set_coloredset_coloredSetColoredSetColoredset_colored, set_line_widthset_line_widthSetLineWidthSetLineWidthset_line_width, set_rgbset_rgbSetRgbSetRgbset_rgb, set_hsiset_hsiSetHsiSetHsiset_hsi

Alternatives

disp_circledisp_circleDispCircleDispCircledisp_circle, disp_ellipsedisp_ellipseDispEllipseDispEllipsedisp_ellipse, disp_regiondisp_regionDispRegionDispRegiondisp_region, gen_circlegen_circleGenCircleGenCirclegen_circle, gen_ellipsegen_ellipseGenEllipseGenEllipsegen_ellipse

See also

open_windowopen_windowOpenWindowOpenWindowopen_window, set_colorset_colorSetColorSetColorset_color, set_drawset_drawSetDrawSetDrawset_draw, set_rgbset_rgbSetRgbSetRgbset_rgb, set_hsiset_hsiSetHsiSetHsiset_hsi

Module

Foundation

ClassesClasses | | Operators