HALCON Website / HALCON Operator Reference / Graphics / Output
ClassesClassesClassesClasses | | | | Operators

disp_circledisp_circleDispCircledisp_circleDispCircleDispCircle (Operator)

Name

disp_circledisp_circleDispCircledisp_circleDispCircleDispCircle — Displays circles in a window.

Signature

disp_circle( : : WindowHandle, Row, Column, Radius : )

Herror disp_circle(const Hlong WindowHandle, double Row, double Column, double Radius)

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

Herror 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 DispCircle(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 HOperatorSetX.DispCircle(
[in] VARIANT WindowHandle, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Radius)

void HWindowX.DispCircle(
[in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Radius)

static void HOperatorSet.DispCircle(HTuple windowHandle, HTuple row, HTuple column, HTuple radius)

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

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

Description

disp_circledisp_circleDispCircledisp_circleDispCircleDispCircle displays one or several circles in the output window. A circle is described by the center (RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn) and the radius RadiusRadiusRadiusRadiusRadiusradius. 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_drawset_drawSetDrawset_drawSetDrawSetDraw, set_grayset_graySetGrayset_graySetGraySetGray, set_drawset_drawSetDrawset_drawSetDrawSetDraw) 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_colorset_colorSetColorset_colorSetColorSetColor.

Attention

The center of the circle must be within the window.

Parallelization

Parameters

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Window identifier.

RowRowRowRowRowrow (input_control)  circle.center.y(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Row index of the center.

Default value: 64

Suggested values: 0, 64, 128, 256

Typical range of values: 0 ≤ Row Row Row Row Row row ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumnColumncolumn (input_control)  circle.center.x(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Column index of the center.

Default value: 64

Suggested values: 0, 64, 128, 256

Typical range of values: 0 ≤ Column Column Column Column Column column ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

RadiusRadiusRadiusRadiusRadiusradius (input_control)  circle.radius(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Radius of the circle.

Default value: 64

Suggested values: 0, 64, 128, 256

Typical range of values: 0 ≤ Radius Radius Radius Radius Radius 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)

Example (C)

open_window(0,0,-1,-1,"root","visible","",&WindowHandle) ;
set_draw(WindowHandle,"fill") ;
set_color(WindowHandle,"white") ;
get_mbutton(WindowHandle,&Row,&Column,&Button) ;
disp_circle(WindowHandle,Row,Column,(Row + Column) mod 50) ;

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)

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)

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)

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_circledisp_circleDispCircledisp_circleDispCircleDispCircle returns 2 (H_MSG_TRUE).

Possible Predecessors

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_colorset_colorSetColorset_colorSetColorSetColor, set_coloredset_coloredSetColoredset_coloredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi

Alternatives

disp_ellipsedisp_ellipseDispEllipsedisp_ellipseDispEllipseDispEllipse, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, gen_circlegen_circleGenCirclegen_circleGenCircleGenCircle, gen_ellipsegen_ellipseGenEllipsegen_ellipseGenEllipseGenEllipse

See also

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow, set_colorset_colorSetColorset_colorSetColorSetColor, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 11.0.5 Copyright © 1996-2015 MVTec Software GmbH