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_update_pcdev_update_pcDevUpdatePcDevUpdatePcdev_update_pc (Operator)

dev_update_pcdev_update_pcDevUpdatePcDevUpdatePcdev_update_pc — Switches the update of the PC during program execution on or off.

Signature

dev_update_pc( : : DisplayMode : )

Herror dev_update_pc(const char* DisplayMode)

Herror T_dev_update_pc(const Htuple DisplayMode)

void DevUpdatePc(const HTuple& DisplayMode)

static void HOperatorSet.DevUpdatePc(HTuple displayMode)

def dev_update_pc(display_mode: str) -> None

Description

dev_update_pcdev_update_pcDevUpdatePcDevUpdatePcdev_update_pc specifies the behavior of the PC during program execution. If DisplayModeDisplayModeDisplayModedisplayModedisplay_mode is set to 'on'"on""on""on""on", which is the default, within the selected procedure the PC is always displayed left to the currently executed operator. In addition the program text is scrolled---if necessary---so that the current operator is visible.

If the mode is 'off'"off""off""off""off" the PC is not visible during program execution and the program text will not be scrolled automatically. When the program stops the PC becomes visible again and the listing is scrolled to the current PC position.

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 Program Counter.

Attention

This operator is not supported for code export.

Parameters

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

Mode for runtime behavior.

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_pcdev_update_pcDevUpdatePcDevUpdatePcdev_update_pc returns 2 ( H_MSG_TRUE) . Otherwise, an exception is raised and an error code returned.

See also

dev_update_timedev_update_timeDevUpdateTimeDevUpdateTimedev_update_time, dev_update_windowdev_update_windowDevUpdateWindowDevUpdateWindowdev_update_window, dev_update_vardev_update_varDevUpdateVarDevUpdateVardev_update_var

Module

Foundation

---

ClassesClasses | | Operators