Operator Reference

HALCON Operator Reference / Graphics / Parameters

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

ClassesClasses | | Operators

set_rgbaT_set_rgbaSetRgbaSetRgbaset_rgba (Operator)

set_rgbaT_set_rgbaSetRgbaSetRgbaset_rgba — Set the color definition via RGBA values.

Signature

set_rgba( : : WindowHandle, Red, Green, Blue, Alpha : )

Herror T_set_rgba(const Htuple WindowHandle, const Htuple Red, const Htuple Green, const Htuple Blue, const Htuple Alpha)

void SetRgba(const HTuple& WindowHandle, const HTuple& Red, const HTuple& Green, const HTuple& Blue, const HTuple& Alpha)

void HWindow::SetRgba(const HTuple& Red, const HTuple& Green, const HTuple& Blue, const HTuple& Alpha) const

void HWindow::SetRgba(Hlong Red, Hlong Green, Hlong Blue, Hlong Alpha) const

static void HOperatorSet.SetRgba(HTuple windowHandle, HTuple red, HTuple green, HTuple blue, HTuple alpha)

void HWindow.SetRgba(HTuple red, HTuple green, HTuple blue, HTuple alpha)

void HWindow.SetRgba(int red, int green, int blue, int alpha)

def set_rgba(window_handle: HHandle, red: MaybeSequence[int], green: MaybeSequence[int], blue: MaybeSequence[int], alpha: MaybeSequence[int]) -> None

Description

set_rgbaset_rgbaSetRgbaSetRgbaset_rgba sets the output color(s) or the gray values, respectively, for region output for the window. The colors are defined with the red, green, blue, and alpha components. If only one combination is passed, all output takes place in that color. If a tuple is passed, region output and output of geometric objects takes place modulo the passed colors.

For every call of an output operator, output is started with the first color. If only one object is displayed per call, it will always be displayed in the first color. This is even true for objects with multiple connection components. If multiple objects are displayed per operator call, multiple colors are used. The defined colors are used until set_colorset_colorSetColorSetColorset_color, set_rgbaset_rgbaSetRgbaSetRgbaset_rgba, or set_rgbset_rgbSetRgbSetRgbset_rgb is called again. The values are used by operators like disp_regiondisp_regionDispRegionDispRegiondisp_region, disp_linedisp_lineDispLineDispLinedisp_line, disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1disp_rectangle1, disp_rectangle2disp_rectangle2DispRectangle2DispRectangle2disp_rectangle2, disp_arrowdisp_arrowDispArrowDispArrowdisp_arrow, etc.

Attention

set_rgbaset_rgbaSetRgbaSetRgbaset_rgba depends on the library libcanvas, which might not be available on embedded systems.

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.

RedRedRedredred (input_control)  integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Red component of the color.

Default: 255

Value range: 0 ≤ Red Red Red red red ≤ 255

Restriction: 0 <= Red && Red <= 255

GreenGreenGreengreengreen (input_control)  integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Green component of the color.

Default: 0

Value range: 0 ≤ Green Green Green green green ≤ 255

Restriction: 0 <= Green && Green <= 255

BlueBlueBlueblueblue (input_control)  integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Blue component of the color.

Default: 0

Value range: 0 ≤ Blue Blue Blue blue blue ≤ 255

Restriction: 0 <= Blue && Blue <= 255

AlphaAlphaAlphaalphaalpha (input_control)  integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Alpha component of the color.

Default: 255

Value range: 0 ≤ Alpha Alpha Alpha alpha alpha ≤ 255

Restriction: 0 <= Alpha && Alpha <= 255

Result

set_rgbaset_rgbaSetRgbaSetRgbaset_rgba returns 2 ( H_MSG_TRUE) if the window is valid and all passed colors are available and displayable. Otherwise an exception is raised.

Possible Successors

disp_objdisp_objDispObjDispObjdisp_obj

Alternatives

set_rgbset_rgbSetRgbSetRgbset_rgb, set_colorset_colorSetColorSetColorset_color

Module

Foundation

---

ClassesClasses | | Operators