-
Notifications
You must be signed in to change notification settings - Fork 9
Dials
Stream Deck + has a row of four dials below the keys. FXCommands works on those as well, with its own set of commands for turning, pushing and tapping.
Requires v2.1.0 or later.
Drag the Run Command action onto the dial row rather than onto a key. The Property Inspector gains a Dial section with three extra fields.
| Trigger | Field | Runs when |
|---|---|---|
| Push | Command / On Release | The dial is pressed in and released |
| Rotate left | Rotate Left | The dial turns anticlockwise |
| Rotate right | Rotate Right | The dial turns clockwise |
| Touch | Touch | The screen above the dial is tapped |
Pushing a dial uses the same On Press and On Release fields as a key, so a dial can cycle through stages exactly like a button does.
Note: If you drop the action on a key you will not see the Dial section. It only appears on the dial row.
Rotation commands can include placeholders, replaced with a number before the command is sent.
| Placeholder | Value |
|---|---|
{ticks} |
Detents turned by this event. Negative for left, positive for right. |
{rotationPercent} |
Running position, 0 to 100
|
{rotationAbsolute} |
Running position, 0 to 255
|
Turning the dial faster produces a larger {ticks} value in a single event, so a quick flick moves further than the same number of slow clicks.
radio_volume_adjust {ticks}
Sends the amount turned and lets the server apply it to whatever the current value is.
radio_volume_set {rotationPercent}
Sends an absolute target instead.
{ticks} is the one to reach for.
{rotationPercent} and {rotationAbsolute} are counted by the plugin, not read from the game. The counter starts at 0 when the button appears and is clamped between 0 and 255. If anything changes the value in game, or you were not at zero to begin with, the plugin's idea of the value and the real one drift apart and stay apart.
Sending {ticks} avoids the problem entirely, because the server owns the value and the plugin only reports movement.
Because the counter runs to 255, a full sweep from 0 to 100 percent takes several complete turns of the dial.
If your command reports its value back, the dial can display it on the touch strip. See Command Responses.
A response formatted as a percentage also draws a progress bar. Print a trailing % to opt in.
- Command Responses - showing a returned value on the dial
- Command Syntax - chains, delays and stages, all of which work on dials
FXCommands
Developers