Skin Definition File Details (Devices)
The following table describes sample elements and values for a Skin Definition File for devices. For more information, see Skin Definition File Example (Devices).
Elements
XML Tags and Elements |
Description |
|---|---|
<skin> tag |
Encapsulates the schema for an emulator skin. You can use only one <skin> tag in each XML file. |
<view> tag |
Contains the schema for an emulator skin. You can use only one <view> tag per <skin> tag. |
titleBar ="My Emulator skin" title bar element |
Specifies the title of the window for the emulator. |
displayPosX="10" and displayPosY="149" elements |
Specifies the position at which to locate the window that contains the display for the emulator within the window for the emulator skin. To make the display not visible, select coordinates that are off-screen. |
displayWidth="272" and displayHeight="224" elements |
Specifies the width and height of the display for the emulator. For width, select an integer between 80 and 1024 that is divisible by 8. For height, select an integer between 64 and 768. |
displayDepth="8" element |
Specifies the color depth of the display for the emulator. For color depth, select 8, 16, or 32. |
normalImage="up.bmp" element |
Specifies the normal art file for the emulator skin, which is required. The normal art file specifies the size of the window for the emulator, and the appearance of the emulator skin. |
mappingImage="map.bmp" element |
Specifies the mapping file for the emulator skin. The mapping file is an optional file that defines the regions occupied by the buttons in the emulator skin. |
downImage="down.bmp" element |
Specifies the down art file for the emulator skin. The down art file is an optional file that specifies the appearance of the buttons on the emulator skin when the buttons are pressed. |
<button> tag |
Contains the description of a button on the emulator skin. |
mappingColor="0x00FF00" element |
Specifies the red. green, blue (RGB) color in the mapping file to use for the button. All pixels having this color in the mapping image represent the area in the emulator skin that you can click for this button. This area behaves as a mask through which the down art file is displayed when you press the button. |
toolTip="This is my ToolTip." element |
Optional. Specifies the text to appear when you move the pointer over the button. |
onClick=" DOWN:Key_LeftShift Key_Z 0x00000015 UP: Key_LeftShift Key_A" |
Optional. Specifies keyboard key presses to be passed to the engine when you press a button. Use hexadecimal or integer values corresponding to a raw keyboard scan code. |
<button toolTip="Soft Key 1" onPressAndHold="0x3B" mappingColor="0xF26C4F" KeyEvent="F1" Comment="Not handled when menu is present." |
Specifies keyboard events to repeat while a button on the emulator skin is being pressed. If KeyEvent is specified, the designer generates code for the button. If Comment is specified, it is added to the generated code as a comment. A tooltip is used as a comment by default. This feature supports all key codes except for the SHUTDOWN key code. |