Blayze: Adds Button Node page.

2023-03-04T01:11:04Z

Adds Button Node page.

New page

{{Return to nodes}}{{Node Data
|title=Button Node
|gallery=<gallery mode="slideshow">
File:Button-node.png
File:Button-settings.png
</gallery>
|output-list=<li>signal</li>
}}
The Button Node is a UI Node that places a button on the [[The Controller|controller]]. A button is a simple element that triggers a signal emission when either on press, release or both (default).

Button Nodes were introduced in [[Firmware Releases|firmware version]] 2.1 along with all basic nodes.

== Outputs ==
Button Nodes have a single output - ''signal'', which attempts to emit a ''1 (high)'' value when the button is 'activated', and a ''0 (low)'' when the button is 'deactivated' again. Whether these values are emitted as soon as pressed and released, only on press, only on release, or are toggled with each press is configurable with the Node's ''Button Mode'' setting.

== Settings ==
The Button Node's settings can be configured to alter it's visual presentation and mode of operation.

{{UI_Node_Settings|node=Button}}

* '''Activated Colour''': Configures the colour the button changes when 'activated'.
* '''Button Mode''': Configures the behaviour of the button (see below).

== Button Modes ==
The '''Button Mode''' setting has three values:

* '''sensitive''': The button emits a ''1 (high)'' as soon as it's pressed (activated), and also emits a ''0 (low)'' signal as soon as it's released (deactivated).
* '''impulse low''': The button emits a ''0 (low)'' signal whenever it transitions into a deactivated state (is released), but does not emit a ''1 (high)'' signal when it transitions into an activated state (is pressed).
* '''impulse high''': The button emits a ''1 (high)'' signal whenever it transitions into an activated state (is pressed), but does not emit a ''0 (low)'' signal when it transitions into a deactivated state (is released).
* '''toggle''': This mode is identical to '''sensitive''', emitting a signal whenever the button transitions either way (is pressed ''or'' released), but in this mode the button ''toggles'' meaning that on the first press and release, the button activates, and it will not deactivate until it is pressed again, after which it can be activated again.

Button Node - Revision history

Blayze: Adds Button Node page.