Jog/Shuttle

Navigation:  Widget Designer > Devices >

Jog/Shuttle

prev main next

Navigation:  Widget Designer > Devices >

Jog/Shuttle

prev main next

Please wait. Due to its content this page might take a while to load...

The Jog/Shuttle is a hardware device with faders and buttons and can be used together with the Fader Extension. When adding the device to the Configuration dialog you can assign custom scripts to buttons and the Sequence opacity or other Parameters to faders. The Jog/Shuttle device is available in all Widget Designer editions, including the Free version.

Adding a New Jog/Shuttle Device

To add a Jog/Shuttle device, open the Devices menu and select "Jog/Shuttle > Create Jog/Shuttle Device". This opens the Configuration dialog. Alternatively, you can add a new device in the Configuration dialog with the "+" button.

On the right side, you can name, dis-/enable the device or configure it with the "Open Settings" button as explained in the next paragraph.

The Name is the unique identifier for this Jog/Shuttle object in WD and the general rules for naming objects apply here as well (only letters, numbers and underscore are allowed, the first symbol must be a letter).
If you like, you can change the default name to a more descriptive one. When scripting, enter the name to access available members as described further down.

The "Enable" check box is ticked per default. On the left side, you should see that the icon in front of your Jog/Shuttle device is a filled blue circle. An empty blue circle indicates an enabled device which is not connected. An empty gray circle indicates a disabled device.

You can close the dialog at any time. The newly created device will also be added to the Devices menu > Jog/Shuttle and can be opened from here or with Devices menu > Configuration.

The Jog/Shuttle Settings

click to enlargeThis dialog allows to assign scripts to buttons of the Jog/Shuttle control hardware and parameter control to its faders. This offers you more flexibility compared to the usage of the device with only the predetermined functionality when it is connected to Pandoras Box.

Press one of the buttons (physically or in the UI) and enter a script which should be executed when the button is pressed or released. Please see the chapter Script Language for more information how to enter commands.

Select a fader to edit which PB Sequence or which PB Device parameter should be controlled with it. Enter the Site and Device ID from the Layer in Pandoras Box, which you would like to control, e.g. "2.1" or "2.1 3.1" in case you like to control the first Layer of Site 2 and 3 at the same time. If you like to send the inverted fader value (i.e. "0" when fader says "255") to a parameter, fill out the two fields "Device (INV)" and "Parameter (INV)".

Press "OK" or "Apply" to save your changes or check the option "Apply Changes Automatically".

Using the Device in Regular Scripting

After creating a device, you can also use it via scripting which allows to perform actions on the device as well as retrieve information from it.

To send commands to the device, first create a CustomScript button or use the Macro editor or anything else with a scripting field. If you enter the device's identifier name into the script field (per default that is "JogShuttle"), Script Assist will offer you a list of all Jog/Shuttle Members.

There are commands to set the dimmer level of specific LEDs:
JogShuttle.SetTopButtonBlueLedBrightness(1,255)

You can also retrieve specific values via scripting in the same way as from other widgets (e.g. a Fader value):
vint = JogShuttle.Fader1.GetValue

Using the Device with Event Listeners

Event Listeners can be added to the Configuration dialog and provide a simple way of listening to triggers from connected devices.

Please see the chapter Event Listener for a detailed description of its functionality and Jog/Shuttle Events for an overview (with examples and description) over the events raised by a Jog/Shuttle device.

Using the Device in the Node System

After creating a device, you can also use it in the node system as an input node. Input nodes allow to retrieve information from the associated device and send it to other nodes. Please see the chapter "JogShuttle Input" for more information about the node itself or the chapter "Tutorial: Nodes" for information about the node system.