disp_circleDispCircleDispCircledisp_circleT_disp_circle

HALCON ScriptCpp++.NETPythonC

Short description

disp_circleDispCircleDispCircledisp_circleT_disp_circle — Displays circles in a window.

Signature

disp_circle( window WindowHandle, circle.center.y Row, circle.center.x Column, circle.radius Radius )void DispCircle( const HTuple& WindowHandle, const HTuple& Row, const HTuple& Column, const HTuple& Radius )static void HOperatorSet.DispCircle( HTuple windowHandle, HTuple row, HTuple column, HTuple radius )def disp_circle( window_handle: HHandle, row: MaybeSequence[Union[int, float]], column: MaybeSequence[Union[int, float]], radius: MaybeSequence[Union[int, float]] ) -> None

Herror T_disp_circle( const Htuple WindowHandle, const Htuple Row, const Htuple Column, const Htuple Radius )

void HWindow::DispCircle( const HTuple& Row, const HTuple& Column, const HTuple& Radius ) const

void HWindow::DispCircle( double Row, double Column, double Radius ) const

void HWindow.DispCircle( HTuple row, HTuple column, HTuple radius )

void HWindow.DispCircle( double row, double column, double radius )

Description

disp_circleDispCircle displays one or several circles in the output window. A circle is described by the center (Rowrowrow, Columncolumncolumn) and the radius Radiusradiusradius. If the used coordinates are not within the window the circle is clipped accordingly.

The operators used to control the display of regions (e.g., set_drawSetDraw, set_graySetGray, set_drawSetDraw) can also be used with circles. Several circles can be displayed with one call by using tuple parameters. For the use of colors with several circles, see set_colorSetColor.

Attention

The center of the circle must be within the window.

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.

Rowrowrow (input_control) circle.center.y(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[int, float]]Htuple (double / Hlong)

Row index of the center.

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

Columncolumncolumn (input_control) circle.center.x(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[int, float]]Htuple (double / Hlong)

Column index of the center.

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

Radiusradiusradius (input_control) circle.radius(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[int, float]]Htuple (double / Hlong)

Radius of the circle.

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

Example

(HDevelop)

open_window(0,0,-1,-1,'root','visible','',WindowHandle)
set_draw(WindowHandle,'fill')
set_color(WindowHandle,'white')
repeat
  get_mbutton(WindowHandle,Row,Column,Button)
  disp_circle(WindowHandle,Row,Column,(Row + Column) % 50)
until(Button == 1)
close_window(WindowHandle)

Result

disp_circleDispCircle 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_ellipseDispEllipse, disp_regionDispRegion, gen_circleGenCircle, gen_ellipseGenEllipse

See also

open_windowOpenWindow, set_colorSetColor, set_drawSetDraw, set_rgbSetRgb, set_hsiSetHsi

Module

Foundation