Operator Reference

HALCON Operator Reference / Graphics / Parameters
ClassesClasses | | Operators

set_line_widthT_set_line_widthSetLineWidthSetLineWidthset_line_width (Operator)

set_line_widthT_set_line_widthSetLineWidthSetLineWidthset_line_width — Define the line width for region contour output.

Signature

set_line_width( : : WindowHandle, Width : )

Herror T_set_line_width(const Htuple WindowHandle, const Htuple Width)

void SetLineWidth(const HTuple& WindowHandle, const HTuple& Width)

void HWindow::SetLineWidth(double Width) const

static void HOperatorSet.SetLineWidth(HTuple windowHandle, HTuple width)

void HWindow.SetLineWidth(double width)

def set_line_width(window_handle: HHandle, width: float) -> None

Description

set_line_widthset_line_widthSetLineWidthSetLineWidthset_line_width defines the line width (in pixel) in which a region contour is displayed (e.g., with disp_regiondisp_regionDispRegionDispRegiondisp_region, disp_linedisp_lineDispLineDispLinedisp_line, disp_polygondisp_polygonDispPolygonDispPolygondisp_polygon, etc.) The operator get_line_widthget_line_widthGetLineWidthGetLineWidthget_line_width returns the current value for the window. Some output devices may not allow to change the contour width. If it is possible for the current device, it can be queried with query_line_widthquery_line_widthQueryLineWidthQueryLineWidthquery_line_width.

Attention

The line width is important if the output mode was set to 'margin' (see set_drawset_drawSetDrawSetDrawset_draw). If the line width is greater than one, regions may not always be displayed correctly.

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.

WidthWidthWidthwidthwidth (input_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Line width for region output in contour mode.

Default: 1.0

Restriction: Width >= 1.0 && Width <= 2000.0

Result

set_line_widthset_line_widthSetLineWidthSetLineWidthset_line_width returns 2 ( H_MSG_TRUE) if the parameter is correct and the window is valid. Otherwise an exception is raised.

Possible Predecessors

query_line_widthquery_line_widthQueryLineWidthQueryLineWidthquery_line_width, get_line_widthget_line_widthGetLineWidthGetLineWidthget_line_width

Possible Successors

disp_regiondisp_regionDispRegionDispRegiondisp_region

See also

get_line_widthget_line_widthGetLineWidthGetLineWidthget_line_width, query_line_widthquery_line_widthQueryLineWidthQueryLineWidthquery_line_width, set_drawset_drawSetDrawSetDrawset_draw, disp_regiondisp_regionDispRegionDispRegiondisp_region

Module

Foundation

ClassesClasses | | Operators