The Label Setup screen allows you to customize the look and function of label controls in an activity layout.
In the Name section, you can change the name and description of the label. The label name is not displayed, but is part of RedEye’s accessibility feature, which allows those with difficulty seeing to receive auditory feedback through the OS when they select different controls.
In the Type section, you can specify whether the label has any function when tapped. There are four label types:
- Display only labels are there for appearance only – tapping on them does not generate any action.
- Button labels work like hyperlinks. You can assign a single action to a button label. (If you want a macro button, please use the script type, as described below.)
- Repeating button labels work like repeating buttons. That is, they function as do Normal buttons when tapped and released. However, if you tap and hold a repeating button label, the label’s action is repeated rapidly until you release it. This type of label is useful for things such as volume and channel functions that “ramp” when you hold them down.
- Script images execute scripts when tapped. More information on scripting and advanced configuration is available in the RedEye Advanced Programming Manual.
The Appearance section determines how a label looks. Here you can input an exact Font Size and Height, in “relative pixels.” The relative pixel measurement assumes a display width of 320.0 pixels. For iPad, we scale up the size by 40%. On other screens (Android phones and tablets, PCs running the browser app) the exact scaling factor depends on the size and resolution of the display.
Bold indicates whether the text will be displayed in bold style.
Color shows the normal display color for the label, whereas Highlight Color shows the color displayed when the label is tapped (for button, repeating button, and script label types).To adjust either color, tap on the appropriate color row. RedEye displays a color picker to help you choose the color you want. You can enter color values directly using Hue, Saturation, and Value (HSV); Red, Green, and Blue (RGB); or hexadecimal formats. You can also drag the crosshair cursors to find the color you want. The gradient along the bottom adjusts the color brightness; the larger top gradient allows you to choose hue along the x-axis, and saturation along the y-axis. The currently selected color appears in the upper-right corner. Tap Save once you have found your desired color.
You can select the text alignment for your label using the Justification row. Options are left, center, and right justified.
The Text Variable field determines the actual text that your label will display. We use a state variable for the text value so that you can update the text label dynamically, which makes label controls suitable for displaying things such as current track name, temperature, and other values that can change over time. For more information on the scripting involved in updating state variables at runtime, please refer to the RedEye Advanced Programming Manual.
The Shortcut Gesture indicates which multi-touch or accelerometer gesture shortcut (if any) is assigned to the label. 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.
The Shortcut Key indicates which keyboard key is assigned to the control. Although the shortcut key has no function on iOS devices, it can be quite useful when operating your RedEye unit from a controller that has a keyboard (such as a PC).
As with gestures, shortcut key 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 Label Type, but in all cases this is the place to assign the label’s functionality in the form of an action or script. Tap on an action row to change the action or edit the script. If you have a “Display only”-type label, then this section will not be visible.