Operator Reference

HALCON Operator Reference / Graphics / Parameters

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

set_line_styleT_set_line_styleSetLineStyleSetLineStyleset_line_style (Operator)

set_line_styleT_set_line_styleSetLineStyleSetLineStyleset_line_style — Define a contour output pattern.

Signature

set_line_style( : : WindowHandle, Style : )

Herror T_set_line_style(const Htuple WindowHandle, const Htuple Style)

void SetLineStyle(const HTuple& WindowHandle, const HTuple& Style)

void HWindow::SetLineStyle(const HTuple& Style) const

static void HOperatorSet.SetLineStyle(HTuple windowHandle, HTuple style)

void HWindow.SetLineStyle(HTuple style)

def set_line_style(window_handle: HHandle, style: Sequence[int]) -> None

Description

set_line_styleset_line_styleSetLineStyleSetLineStyleset_line_style defines the output pattern of the margin of regions and of XLD contours. The information is used by operators like disp_regiondisp_regionDispRegionDispRegiondisp_region, disp_linedisp_lineDispLineDispLinedisp_line, disp_polygondisp_polygonDispPolygonDispPolygondisp_polygon etc. The current value can be queried with get_line_styleget_line_styleGetLineStyleGetLineStyleget_line_style. StyleStyleStylestylestyle contains up to five pairs of values. The first value is the length of the visible contour part, the second is the length of the invisible part. The value pairs are used cyclical for contour output.

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.

StyleStyleStylestylestyle (input_control)  integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Contour pattern.

Default: []

Value range: 1 ≤ Style Style Style style style ≤ 120

Example (HDevelop)

* stroke line: X-Windows
set_line_style(WindowHandle,[20,7])
* point-stroke line: X-Windows
set_line_style(WindowHandle,[20,7,3,7])
* passing line (standard)
set_line_style(WindowHandle,[])

Example (C)

Htuple LineStyle;

/* stroke line: X-Windows */
create_tuple(&LineStyle,2);
set_i(LineStyle,20,0);
set_i(LineStyle,7,1);
T_set_line_style(WindowHandle,LineStyle);
destroy_tuple(LineStyle);

/* point-stroke line: X-Windows */
create_tuple(&LineStyle,4);
set_i(LineStyle,20,0);
set_i(LineStyle,7,1);
set_i(LineStyle,3,2);
set_i(LineStyle,7,3);
T_set_line_style(WindowHandle,LineStyle);
destroy_tuple(LineStyle);

/* passing line (standard) */
create_tuple(&LineStyle,0);
T_set_line_style(WindowHandle,LineStyle);
destroy_tuple(LineStyle);

Example (HDevelop)

* stroke line: X-Windows
set_line_style(WindowHandle,[20,7])
* point-stroke line: X-Windows
set_line_style(WindowHandle,[20,7,3,7])
* passing line (standard)
set_line_style(WindowHandle,[])

Example (HDevelop)

* stroke line: X-Windows
set_line_style(WindowHandle,[20,7])
* point-stroke line: X-Windows
set_line_style(WindowHandle,[20,7,3,7])
* passing line (standard)
set_line_style(WindowHandle,[])

Result

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

Possible Predecessors

get_line_styleget_line_styleGetLineStyleGetLineStyleget_line_style

Possible Successors

disp_regiondisp_regionDispRegionDispRegiondisp_region

See also

get_line_styleget_line_styleGetLineStyleGetLineStyleget_line_style, set_line_approxset_line_approxSetLineApproxSetLineApproxset_line_approx, disp_regiondisp_regionDispRegionDispRegiondisp_region

Module

Foundation

---

ClassesClasses | | Operators