HALCON Reference Manual 10.0.2
Table of Contents / Graphics / Output ClassesClassesClasses | | | Operators

disp_linedisp_linedisp_lineDispLineDispLine (Operator)

Name

disp_linedisp_linedisp_lineDispLineDispLine — Draws lines in a window.

Signature

disp_line( : : WindowHandle, Row1, Column1, Row2, Column2 : )

Herror disp_line(const Hlong WindowHandle, double Row1, double Column1, double Row2, double Column2)

Herror T_disp_line(const Htuple WindowHandle, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2)

Herror disp_line(const HTuple& WindowHandle, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2)

void HWindow::DispLine(const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2) const

void HOperatorSetX.DispLine(
[in] VARIANT WindowHandle, [in] VARIANT Row1, [in] VARIANT Column1, [in] VARIANT Row2, [in] VARIANT Column2)

void HWindowX.DispLine(
[in] VARIANT Row1, [in] VARIANT Column1, [in] VARIANT Row2, [in] VARIANT Column2)

static void HOperatorSet.DispLine(HTuple windowHandle, HTuple row1, HTuple column1, HTuple row2, HTuple column2)

void HWindow.DispLine(HTuple row1, HTuple column1, HTuple row2, HTuple column2)

void HWindow.DispLine(double row1, double column1, double row2, double column2)

Description

disp_linedisp_linedisp_lineDispLineDispLine displays one or several lines in the output window. A line is described by the coordinates of the start (Row1Row1Row1Row1row1,Column1Column1Column1Column1column1) and the coordinates of the end (Row2Row2Row2Row2row2,Column2Column2Column2Column2column2). The operators used to control the display of regions (e.g. set_colorset_colorset_colorSetColorSetColor, set_grayset_grayset_graySetGraySetGray, set_drawset_drawset_drawSetDrawSetDraw, set_line_widthset_line_widthset_line_widthSetLineWidthSetLineWidth) can also be used with lines. Several lines can be displayed with one call by using tuple parameters. For the use of colors with several lines, see set_colorset_colorset_colorSetColorSetColor.

Attention

The starting points and the ending points of the lines must be in the window.

Parallelization

Parameters

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Window identifier.

Row1Row1Row1Row1row1 (input_control)  line.begin.y(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row index of the start.

Default value: 32.0

Suggested values: 0.0, 64.0, 128.0, 256.0, 511.0

Typical range of values: 0 ≤ Row1 Row1 Row1 Row1 row1 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Column1Column1Column1Column1column1 (input_control)  line.begin.x(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column index of the start.

Default value: 32.0

Suggested values: 0.0, 64.0, 128.0, 256.0, 511.0

Typical range of values: 0 ≤ Column1 Column1 Column1 Column1 column1 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Row2Row2Row2Row2row2 (input_control)  line.end.y(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row index of end.

Default value: 64.0

Suggested values: 0.0, 64.0, 128.0, 256.0, 511.0

Typical range of values: 0 ≤ Row2 Row2 Row2 Row2 row2 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Column2Column2Column2Column2column2 (input_control)  line.end.x(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column index of end.

Default value: 64.0

Suggested values: 0.0, 64.0, 128.0, 256.0, 511.0

Typical range of values: 0 ≤ Column2 Column2 Column2 Column2 column2 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Example (HDevelop)

* display contour of a rectangle
disp_line(WindowHandle,Row1,Column1,Row1,Column2)
disp_line(WindowHandle,Row1,Column2,Row2,Column2)
disp_line(WindowHandle,Row2,Column2,Row2,Column1)
disp_line(WindowHandle,Row2,Column1,Row1,Column1)

Example (C)

/* display contour of a rectangle /*
disp_rectangle1_margin(long WindowHandle,
                       long Row1, long Column1,
                       long Row2, long Column2)
{
  disp_line(WindowHandle,Row1,Column1,Row1,Column2) ;
  disp_line(WindowHandle,Row1,Column2,Row2,Column2) ;
  disp_line(WindowHandle,Row2,Column2,Row2,Column1) ;
  disp_line(WindowHandle,Row2,Column1,Row1,Column1) ;
}

Example (HDevelop)

* display contour of a rectangle
disp_line(WindowHandle,Row1,Column1,Row1,Column2)
disp_line(WindowHandle,Row1,Column2,Row2,Column2)
disp_line(WindowHandle,Row2,Column2,Row2,Column1)
disp_line(WindowHandle,Row2,Column1,Row1,Column1)

Example (HDevelop)

* display contour of a rectangle
disp_line(WindowHandle,Row1,Column1,Row1,Column2)
disp_line(WindowHandle,Row1,Column2,Row2,Column2)
disp_line(WindowHandle,Row2,Column2,Row2,Column1)
disp_line(WindowHandle,Row2,Column1,Row1,Column1)

Example (HDevelop)

* display contour of a rectangle
disp_line(WindowHandle,Row1,Column1,Row1,Column2)
disp_line(WindowHandle,Row1,Column2,Row2,Column2)
disp_line(WindowHandle,Row2,Column2,Row2,Column1)
disp_line(WindowHandle,Row2,Column1,Row1,Column1)

Result

disp_linedisp_linedisp_lineDispLineDispLine returns 2 (H_MSG_TRUE).

Possible Predecessors

open_windowopen_windowopen_windowOpenWindowOpenWindow, set_rgbset_rgbset_rgbSetRgbSetRgb, set_lutset_lutset_lutSetLutSetLut, set_hsiset_hsiset_hsiSetHsiSetHsi, set_drawset_drawset_drawSetDrawSetDraw, set_colorset_colorset_colorSetColorSetColor, set_coloredset_coloredset_coloredSetColoredSetColored, set_line_widthset_line_widthset_line_widthSetLineWidthSetLineWidth

Alternatives

disp_arrowdisp_arrowdisp_arrowDispArrowDispArrow, disp_rectangle1disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1, disp_rectangle2disp_rectangle2disp_rectangle2DispRectangle2DispRectangle2, disp_regiondisp_regiondisp_regionDispRegionDispRegion, gen_region_polygongen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygon, gen_region_pointsgen_region_pointsgen_region_pointsGenRegionPointsGenRegionPoints

See also

open_windowopen_windowopen_windowOpenWindowOpenWindow, open_textwindowopen_textwindowopen_textwindowOpenTextwindowOpenTextwindow, set_colorset_colorset_colorSetColorSetColor, set_rgbset_rgbset_rgbSetRgbSetRgb, set_hsiset_hsiset_hsiSetHsiSetHsi, set_insertset_insertset_insertSetInsertSetInsert, set_line_widthset_line_widthset_line_widthSetLineWidthSetLineWidth

Module

Foundation

Table of Contents / Graphics / Output ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH