The Slider Setup screen allows you to customize the look and function of slider controls in an activity layout.
In the Name section, you can change the name and description of the slider. The slider name is displayed in the activity layout if the Show Name option is set to “On.”
In the Type section, you can specify whether the slider invokes a command or a script when it is dragged. More information on scripting is available in the RedEye Advanced Programming Manual.
Each slider can display up to two different labels. If you turn on the Show Name option, the slider name will appear at the bottom of the control. Turning on the Show Value option displays the current value of the slider above the drag handle on the control.
In the Slider Values section you assign numeric values to the slider.
Minimum Value is the lowest possible value for the device you are controlling with the slider; it is the value selected when you drag the slider all the way to the left.
Maximum Value is the highest possible value for the device you are controlling; it is the value selected when you drag the slider all the way to the right.
Increment determines the spacing between each valid value for the device you are controlling. For example, one device may have a volume control that ranges from 0 to 1.0 in increments of 1%, or 0.01. Another device may range from 0 to 100 in increments of 1, disallowing any fractions. When set properly, the minimum, maximum, and increment values will ensure that only valid values are sent to the device you are controlling.
Value Variable is the state variable which the slider control updates when it is dragged. Simply updating a state variable is not enough to control any device; you must also invoke some action (a command or script) that applies the value of the state variable to your device. We use state variables here so that when the value of the slider changes, all connected client controllers can see the new value. If you use feedback from the device you are controlling to update this state variable, then you will see the slider control update when you control the device outside the RedEye system, as well. For more information on the scripting involved in updating state variables at runtime, please refer to the RedEye Advanced Programming Manual.
Shortcut Gestures indicate which multitouch or accelerometer gesture shortcuts (if any) are assigned to the slider. Whereas other controls have a single shortcut gesture, sliders can have up to two – one to nudge the slider up, and another to nudge it down.
One of the problems with touch screen remote controls is that you must look down at the screen to know what button you are pressing. Sometimes —particularly when paging through information on a television or other display — it is inconvenient to have to divert your eyes. Shortcut gestures solve this problem by allowing you to assign shortcuts to as many as twenty-three different controls within each activity layout. To execute these shortcuts, you do not need to look down at the screen — simply make the appropriate gesture, and the RedEye application will respond as if you had tapped the corresponding control.
A shortcut may be assigned to only one control at a time, so if you select a shortcut that is currently assigned to another control, the previously assigned control will no longer have that shortcut.
Shortcut Keys indicate which keyboard keys are assigned to the control. Although shortcut keys have no function on iOS devices, they can be quite useful when operating your RedEye unit from a controller that has a keyboard (such as a PC).
As with gestures, shortcut keys may be assigned to only one control at a time, so if you select a shortcut that is currently assigned to another control, the previously assigned control will no longer have that shortcut.
The name and format of the last section on the page changes depending on the Slider Type, but in all cases this is the place to assign the slider’s functionality in the form of an action or script. Tap on an action row to change the action or edit the script.