HALCON 23.11.0.0 / HALCON Operator Reference / Graphics / Output
ClassesClasses | | Operators

disp_arcT_disp_arcDispArcDispArcdisp_arc (Operator)

Name

disp_arcT_disp_arcDispArcDispArcdisp_arc — Displays circular arcs in a window.

Signature

disp_arc( : : WindowHandle, CenterRow, CenterCol, Angle, BeginRow, BeginCol : )

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

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_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

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
HALCON Operator Reference 23.11.0.0 Copyright © 1996-2023 MVTec Software GmbH