Default control tags
Jump to navigation
Jump to search
Here are the tags and attributes available for all controls. Note that they're all lowercase, as XML is case sensitive.
description | Only used to make things clear for the skinner. Not read by XBMC at all. |
type | Should be image for an image control. |
id | Specifies the control's id. The value this takes depends on the control type, and the window that you are using the control on. There are special control id's that must be present in each window. Any other controls that the skinner adds can be any id they like. Most image controls don't need an id as they're completely under the skinner's control. |
posx | Specifies where the left edge of the image should be drawn, relative to it's parent's left edge. If an "r" is included (eg 180r) then the measurement is taken from the parent's right edge (in the left direction). |
posy | Specifies where the top edge of the image should be drawn, relative to it's parent's top edge. If an "r" is included (eg 180r) then the measurement is taken from the parent's bottom edge (in the up direction). |
width | Specifies the width that should be used to draw the image. The image will be resized to fit into this width. |
height | Specifies the height that should be used to draw the image. The image will be resized to fit into this height. |
onup | Specifies the <id> of the control that should be moved to when the user moves up off this control. Can point to a control group (which remembers previous focused items). |
ondown | Specifies the <id> of the control that should be moved to when the user moves down off this control. Can point to a control group (which remembers previous focused items). |
onleft | Specifies the <id> of the control that should be moved to when the user moves left off this control. Can point to a control group (which remembers previous focused items). |
onright | Specifies the <id> of the control that should be moved to when the user moves right off this control. Can point to a control group (which remembers previous focused items). |
hitrect | Specifies the location and size of the "focus area" of this control (relative to the parent's coordinates) used by the mouse cursor. Format is <hitrect x="20" y="30" w="50" h="10" /> |
visible | Specifies a condition as to when this control will be visible. Can be true, false, or a condition. See here for more information. Defaults to true. |
enable | Specifies a condition as to when this control will be enabled. Can be true, false, or a condition. See here for more information. Defaults to true. |
animation | Specifies the animation to be run when the control enters a particular state. See here for more information |
camera | Specifies the location (relative to the parent's coordinates) of the camera. Useful for the 3D animations such as rotatey. Format is <camera x="20" y="30" /> |
colordiffuse | This specifies the color to be used for the texture basis. It's in hex AARRGGBB format. If you define <colordiffuse>FFFF00FF</colordiffuse> (magenta), the image will be given a magenta tint when rendered. Defaults to FFFFFFFF (no tint). |
pulseonselect | This specifies whether or not a button type will "pulse" when it has focus. This is done by varying the alpha channel of the button. Defaults to true. |