Operator Reference

HALCON Operator Reference / Develop
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_update_windowdev_update_windowDevUpdateWindowDevUpdateWindowdev_update_window (Operator)

dev_update_windowdev_update_windowDevUpdateWindowDevUpdateWindowdev_update_window — Switches the automatic output of iconic output objects into the graphics window during program execution on or off.

Signature

dev_update_window( : : DisplayMode : )

Herror dev_update_window(const char* DisplayMode)

Herror T_dev_update_window(const Htuple DisplayMode)

void DevUpdateWindow(const HTuple& DisplayMode)

static void HWindow::DevUpdateWindow(const HString& DisplayMode)

static void HWindow::DevUpdateWindow(const char* DisplayMode)

static void HWindow::DevUpdateWindow(const wchar_t* DisplayMode)   ( Windows only)

static void HOperatorSet.DevUpdateWindow(HTuple displayMode)

static void HWindow.DevUpdateWindow(string displayMode)

def dev_update_window(display_mode: str) -> None

Description

dev_update_windowdev_update_windowDevUpdateWindowDevUpdateWindowdev_update_window specifies whether all iconic objects that are returned by an operator call have to be displayed in the active graphics window (DisplayModeDisplayModeDisplayModedisplayModedisplay_mode = 'on'"on""on""on""on"---default) or not (DisplayModeDisplayModeDisplayModedisplayModedisplay_mode = 'off'"off""off""off""off").

This option has no influence on the object output in single step mode. After the execution of a single operator the iconic output objects are always displayed in the active graphics window.

This option should be set to 'off'"off""off""off""off", if only selected objects should to be displayed in the graphics window. In this case the objects should be displayed by dev_displaydev_displayDevDisplayDevDisplaydev_display.

For measuring the execution time of a sequence of operators all update options should be switched off in order to reduce the influence of the runtime of GUI updates in HDevelop. For this the operators dev_update_pcdev_update_pcDevUpdatePcDevUpdatePcdev_update_pc, dev_update_timedev_update_timeDevUpdateTimeDevUpdateTimedev_update_time, dev_update_vardev_update_varDevUpdateVarDevUpdateVardev_update_var, and dev_update_windowdev_update_windowDevUpdateWindowDevUpdateWindowdev_update_window or the procedures dev_update_on and dev_update_off can be used.

This option can also be controlled via the Preferences dialog: Edit -> Preferences -> Runtime Settings -> Update Window.

Attention

This operator is not supported for code export.

Parameters

DisplayModeDisplayModeDisplayModedisplayModedisplay_mode (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Mode for graphic output.

Default: 'off' "off" "off" "off" "off"

List of values: 'off'"off""off""off""off", 'on'"on""on""on""on"

Result

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

Possible Successors

dev_displaydev_displayDevDisplayDevDisplaydev_display

See also

dev_update_pcdev_update_pcDevUpdatePcDevUpdatePcdev_update_pc, dev_update_vardev_update_varDevUpdateVarDevUpdateVardev_update_var, dev_update_timedev_update_timeDevUpdateTimeDevUpdateTimedev_update_time

Module

Foundation

ClassesClasses | | Operators