The Image Detail screen allows you to customize the look and function of image controls in an activity layout.
In the Name section, you can change the name and description of the image. The image name is displayed in the activity layout if the Show Label option is set to “On.”
- Display only images are there for appearance only – tapping on them does not generate any action.
- Button images work like custom buttons. You can assign a single action to a button image. (If you want a macro button, please use the script type, as described below.)
- Repeating button images 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 image, the image’s action is repeated rapidly until you release it. This type of image 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 an image looks. Here you can input an exact Width 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.
Z Index is a property which determines the stacking order of images in your activity. Any integer value between 1 and 1000 is valid. The lower the value, the closer to the “bottom” of the display – images with higher Z Index values appear on top. All other controls (buttons, etc) appear on top of your images (i.e., they have an effective Z Index value of 1001). Z Index is particularly useful when you are dealing with background images or images that have transparency and can be stacked to add a feeling of depth to the display.
The Image and Highlight Image fields determine the actual image that your control will display. Image is the primary image for your control and is the picture you will see most often. Highlight Image is the graphic that will display when you tap on the control.
The values for Image and Highlight Image come from state variables. You can update state variables dynamically, which makes image controls suitable for displaying things such as album art. For more information on the scripting involved in updating state variables at runtime, please refer to the RedEye Advanced Programming Manual.
Your image state variables should be properly formatted URLs. Because of limitations within the browser application and limited storage space within the RedEye unit itself, at this time we support images hosted on publicly accessible web (HTTP) servers. You can use file types supported by standard web browsers, including JPEG, GIF, and PNG. We recommend using PNG files, as this format uses lossless compression and allows for transparency.
The RedEye application will cache the images you feed it based on URL. If you need to update an image, the URL needs to change. (Alternatively, you can delete and reinstall the application.)
Toggling Show Label to “On” will display the image name underneath the image in your activity layout.
The Shortcut Gesture indicates which multi-touch or accelerometer gesture shortcut (if any) is assigned to the image. 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 button 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 Image Type, but in all cases this is the place to assign the image’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 image, then this section will not be visible.