Fade label control: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Jmarshall
>Jmarshall
Line 20: Line 20:


===Tag Descriptions===
===Tag Descriptions===
Note that each tag is '''lower case only'''. This is important, as xml tags are case-sensitive.
In addition to the [[Default Control Tags]] the following tags are available.  Note that each tag is '''lower case''' only. This is important, as xml tags are case-sensitive.
{| class="dtable"
{| class="dtable"
|- class="userrow"
| class="usercell" | '''description'''
| class="usercell" | Only used to make things clear for the skinner. Not read by XBMC at all.
|- class="userrow"
| class="usercell" | '''type'''
| class="usercell" | Specifies the control type
|- class="userrow"
| class="usercell" | '''id'''
| class="usercell" | 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.
|- class="userrow"
| class="usercell" | '''posx'''
| class="usercell" | Specifies where the left of the label should be drawn. This is offset from the window's coordinates (normally the left edge of the screen, or 0). In the case of <align>right</align> however, this specifies the '''right''' of the label.
|- class="userrow"
| class="usercell" | '''posy'''
| class="usercell" | Specifies where the top edge of the label should be drawn. This is offset from the window's coordinates (normally the top edge of the screen, or 0).
|- class="userrow"
| class="usercell" | '''width'''
| class="usercell" | Specifies the width that should be used to draw the label. If the text is longer than the label, then it will be truncated and will scroll.
|- class="userrow"
| class="usercell" | '''visible'''
| class="usercell" |
Specifies a condition as to when this control will be visible. Can be true, false, or a condition. [[Conditional Visibility|See here for more information.]] Defaults to true.
|- class="userrow"
| class="usercell" | '''animation'''
| class="usercell" |
Specifies the animation to be run when the control enters a particular state. [[Animating Your Skin|See here for more information.]]
|- class="userrow"
|- class="userrow"
| class="usercell" | '''label'''
| class="usercell" | '''label'''
Line 65: Line 39:
| class="usercell" | '''shadowcolor'''
| class="usercell" | '''shadowcolor'''
| class="usercell" | Specifies the color of the drop shadow on the text, in AARRGGBB format.
| class="usercell" | Specifies the color of the drop shadow on the text, in AARRGGBB format.
|- class="userrow"
| class="usercell" | '''angle'''
| class="usercell" | Specifies the angle at which the text should be drawn, measured counter clockwise from the horizontal.
|}
|}
[[category:Skin Development]]
[[category:Skin Development]]

Revision as of 01:40, 24 July 2007

The fade label control is used for displaying multiple pieces of text in the same space in XBMC. You can choose the font, size, colour, location and contents of the text to be displayed. The first piece of information to display fades in over 50 frames, then scrolls off to the left. Once it is finished scrolling off screen, the second piece of information fades in and the process repeats.

Example

<xml>

 <control type="fadelabel" id="1">
       <description>My First fadelabel</description>
       <posx>80</posx>
       <posy>60</posy>
       <width>250</width>
       <visible>true</visible>
       <scroll>false</scroll>
       <label>6</label>
       <info>MusicPlayer.Genre</info>
       <info>MusicPlayer.Artist</info>
       <info>MusicPlayer.Album</info>
       <info>MusicPlayer.Year</info>
       font14
       <textcolor>FFB2D4F5</textcolor>
 </control>

</xml>

Tag Descriptions

In addition to the Default Control Tags the following tags are available. Note that each tag is lower case only. This is important, as xml tags are case-sensitive.

label

Specifies the text which should be drawn. You should specify an entry from the strings.xml here, however you may also specify a piece of text yourself if you wish, though ofcourse it will not be localisable. You may also specify more than one piece of information here by using the $INFO and $LOCALIZE formats.

info

Specifies the information that should be presented. XBMC will auto-fill in this info in place of the <label>. See here for more information.

font Specifies the font to use from the font.xml file.
textcolor Specified the color the text should be, in hex AARRGGBB format.
shadowcolor Specifies the color of the drop shadow on the text, in AARRGGBB format.
angle Specifies the angle at which the text should be drawn, measured counter clockwise from the horizontal.