Operator Reference

HALCON Operator Reference / Develop

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

ClassesClasses | | Operators

Use the tabs on the upper right to switch to a different programming language.

Use the tabs on the upper right to switch to a different programming language.

Use the tabs on the upper right to switch to a different programming language.

Use the tabs on the upper right to switch to a different programming language.

dev_set_colordev_set_colorDevSetColorDevSetColordev_set_color (Operator)

dev_set_colordev_set_colorDevSetColorDevSetColordev_set_color — Set one or more output colors.

Signature

dev_set_color( : : ColorName : )

Herror dev_set_color(const char* ColorName)

Herror T_dev_set_color(const Htuple ColorName)

void DevSetColor(const HTuple& ColorName)

static void HWindow::DevSetColor(const HTuple& ColorName)

static void HWindow::DevSetColor(const HString& ColorName)

static void HWindow::DevSetColor(const char* ColorName)

static void HWindow::DevSetColor(const wchar_t* ColorName)   ( Windows only)

static void HOperatorSet.DevSetColor(HTuple colorName)

static void HWindow.DevSetColor(HTuple colorName)

static void HWindow.DevSetColor(string colorName)

def dev_set_color(color_name: MaybeSequence[str]) -> None

Description

dev_set_colordev_set_colorDevSetColorDevSetColordev_set_color defines the color(s) that are used to display regions, XLDs, and other geometrical objects in the graphics windows. The available colors can be queried with the operator query_colorquery_colorQueryColorQueryColorquery_color. In addition, the ColorNameColorNameColorNamecolorNamecolor_name may be specified as hexadecimal RGB triplet or RGBA quadruplet in the form '#rrggbb'"#rrggbb""#rrggbb""#rrggbb""#rrggbb" and '#rrggbbaa'"#rrggbbaa""#rrggbbaa""#rrggbbaa""#rrggbbaa". 'rr', 'gg', 'bb', and 'aa' are hexadecimal numbers between '00' and 'ff', respectively. 'aa' denotes the alpha value of a color and can be used to display transparent regions.

For more information see the description of the operator set_colorset_colorSetColorSetColorset_color. However, in contrast to that operator the color setting is also used for all new graphics windows that are opened afterwards.

These color settings remain valid until dev_set_colordev_set_colorDevSetColorDevSetColordev_set_color or dev_set_coloreddev_set_coloredDevSetColoredDevSetColoreddev_set_colored is called or until the color settings are modified interactively.

Examples of possible color strings

Attention

Using the code export feature of HDevelop, the code that is generated for this operator may have a different behavior than the related HALCON operator. For a detailed description of the code export of HDevelop graphics operators into the different programming languages see in the “HDevelop User's Guide” the chapter Code Export -> General Aspects of Code Generation -> Graphics Windows.

Parameters

ColorNameColorNameColorNamecolorNamecolor_name (input_control)  string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Output color names.

Default: 'white' "white" "white" "white" "white"

Suggested values: 'white'"white""white""white""white", 'black'"black""black""black""black", 'gray'"gray""gray""gray""gray", 'red'"red""red""red""red", 'green'"green""green""green""green", 'blue'"blue""blue""blue""blue", '#003075'"#003075""#003075""#003075""#003075", '#e53019'"#e53019""#e53019""#e53019""#e53019", '#ffb529'"#ffb529""#ffb529""#ffb529""#ffb529"

Example (HDevelop)

read_image(Image,'mreut')
dev_set_draw('fill')
dev_set_color('red')
threshold(Image,Region,180,255)
dev_set_color('green')
threshold(Image,Region,0,179)

Result

If the values of the specified parameters are correct, dev_set_colordev_set_colorDevSetColorDevSetColordev_set_color returns 2 ( H_MSG_TRUE) . Otherwise, an exception is raised and an error code returned.

Possible Predecessors

dev_open_windowdev_open_windowDevOpenWindowDevOpenWindowdev_open_window, query_colorquery_colorQueryColorQueryColorquery_color, query_all_colorsquery_all_colorsQueryAllColorsQueryAllColorsquery_all_colors

Possible Successors

dev_displaydev_displayDevDisplayDevDisplaydev_display

Alternatives

dev_set_coloreddev_set_coloredDevSetColoredDevSetColoreddev_set_colored

See also

dev_set_drawdev_set_drawDevSetDrawDevSetDrawdev_set_draw, dev_set_line_widthdev_set_line_widthDevSetLineWidthDevSetLineWidthdev_set_line_width, set_colorset_colorSetColorSetColorset_color

Module

Foundation

---

ClassesClasses | | Operators