Fader Extension

Navigation:  Widget Designer > Devices >

Fader Extension

prev main next

Navigation:  Widget Designer > Devices >

Fader Extension

prev main next

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

The Fader Extension is a hardware device with faders and buttons and acts as extension for the Jog/Shuttle Controller. 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 Fader Extension device is available in all Widget Designer editions, including the Free version.

Adding a New Fader Extension Device

To add a Fader Extension device, open the Devices menu and select "Fader Extension > Create Fader Extension 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 Fader Extension 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 Fader Extension 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 > Fader Extension and can be opened from here or with Devices menu > Configuration.

The Fader Extension Settings

click to enlargeThis dialog allows to assign scripts to buttons of the Fader Extension 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 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 "FaderExtension"), Script Assist will offer you a list of all Fader Extension Events.
There are commands to set the dimmer level of specific LEDs:
FaderExtension.SetTopButtonBlueLedBrightness(3,255)

You can also retrieve specific values via scripting in the same way as from other widgets (e.g. a Fader value):
vint = FaderExtension.Fader3.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 Fader Extension Events for an overview (with examples and description) over the events raised by a Fader Extension 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 "FaderExtension Input" for more information about the node itself or the chapter "Tutorial: Nodes" for information about the node system.