Documentation Wiki rss-feed

Widgets


Widgets are graphical objects in the Stage application which are used to control parameters within the main EigenD application.

(We suggest that you read the main Stage article before continuing if you have not already done so.)

There are currently five different Stage widgets available for use: 1. Horizontal Slider, 2. Vertical Slider, 3. Rotary Knob, 4. +/- Button and 5. Toggle Button. Widgets 1-4 are used to control parameters that have an adjustable value, e.g. a volume, and hence are only accessible in the widget properties dialog for ports that take an adjustable value. Widget 5 is used to control parameters that can be toggled on and off, e.g. an effect enable, and are only accessible for ports that can be either on or off.

1. Horizontal Slider

image:hslider.jpg

To adjust the value of a parameter controlled by a Horizontal Slider widget, click on the vertical bar section of the widget and drag left to decrease the value, and right to increase it.


2. Vertical Slider

image:vslider.jpg

To adjust the value of a parameter controlled by a Vertical Slider widget, click on the horizontal bar section of the widget and drag upwards to increase the value, and downwards to decrease it.


3. Rotary Knob

image:rotary.jpg

To adjust the value of a parameter controlled by a Vertical Slider widget, click in the centre of the widget and drag upwards to increase the value, and downwards to decrease it.


4. +/- Button

image:plusminus.jpg

To adjust the value of a parameter controlled by a +/- Button widget, click the '+' to increase the value, and click the '-' to decrease it.


5. Toggle Button

image:toggle.jpg

Click in the centre of the Toggle Button widget to set the toggle on or off. When the indicator to the right of the widget is green (as in the diagram above), the toggle is on, and when grey, the toggle is set to off.


Enabling and Disabling Widgets

Widgets can be enabled and disabled by the 'enable' tick box in the widget properties dialog, which is opened by clicking on a widget with the Edit Tool. A disabled widget is shown as 'greyed out':

image:widget_greyed_out.jpg

Once disabled, a widget will not respond to mouse or touch gestures and so can be 'locked' to a certain value. It will however change if it receives a value change from another widget connected to the same port, which can be on another running Stage application, or from EigenD.


Changing a Widget Port Connection

The agent port that a widget is connected to can be changed once a widget is disabled. To change the widget port, first disable the widget then select the Create Tool. The new port can then be dragged from the agent tree onto the disabled widget, or selected in the agent tree and then the widget clicked on. The widget becomes enabled again once the new port is assigned to it.

The widget will have the same position and size after the port is changed. The type will also remain the same, unless the moving from a port that has a variable input and an on/off input, or the other way round. The widget name changes to the default name of the new port.


Widget Port Connection Status

A widget can become disconnected from an agent port in two ways. Firstly, if the agent is removed from the EigenD setup after the widget is connected to it. Secondly, if a Tab is imported into a setup which does not contain the agent the widget was previously connected to (see Tabs for details of importing Tabs). When a widget is disconnected, it become disabled and appears greyed out. When editing, its bounding box appears red to indicate it is disconnected:

image:widget_greyed_out_unconnected.jpg

Note a disconnected widget cannot be enabled. The enable tick box in the widget properties becomes greyed out. A disconnected widget can be connected to another available agent port to connect and enable it, see Changing a Widget Port Connection above.


See also