Fade Label Control
From DevWiki
Fade Label controls are used to display multiple pieces of text in the same space. Fade Label properties include font, size, color and such and the text displayed can be set statically or changed dynamically through information variables. The first line of text appears for a given set of time, then scrolls off and the next line is faded in repeatedly. There is no (known) limitation to the number of lines displayed.
- Example
<control type="fadelabel" id="110"> <posx>280</posx> <posy>100</posy> <width>250</width> <height>40</height> <scroll>false</scroll> <scrollout>true</scrollout> <pauseatend>200</pauseatend> <label>Playing:</label> <info>MusicPlayer.Genre</info> <info>MusicPlayer.Artist</info> <info>MusicPlayer.Album</info> <info>MusicPlayer.Year</info> <font>font23</font> <textcolor>white</textcolor> </control>
- This control contains the following properties in addition to the default control properties
| Element | Description | Required |
|---|---|---|
| label | Specifies the text showed in the label. It can be a link into strings.xml, or an actual text label. For more than once piece of information use the $INFO and $LOCALIZE formats. Several label and info properties can be set and they will be shown repeatedly. | Yes, if info is not specified. |
| info | Specifies the information showed in the label taken from strings.xml or as a GUI information. Several label and info properties can be set and they will be shown repeatedly. | Yes, if label is not specified. |
| font | Font used for the button label. From the skin /720p/fonts.xml. | Yes |
| textcolor | Color used for displaying the button label. In AARRGGBB hex format or a name from the skin color themes /colors/defaults.xml. | Yes |
| shadowcolor | Specifies the color of the drop shadow on the text. In AARRGGBB hex format or a name from the skin color themes /colors/defaults.xml. | No |
| angle | The angle the text should be rendered at, in degrees. A value of 0 is horizontal. | No |
| align | Label horizontal alignment on the button. Defaults to left, can also be center or right. | No |
| aligny | Label vertical alignment on the button. Defaults to top, can also be center. | No |
| scroll | When true, the text will scroll if longer than the label's <width>. If false, the text will be truncated. Defaults to false. | No |
| scrollspeed | Scroll speed of text in pixels per second. Defaults to 60. | No |
| scrollout | If set to false the fadelabel will only scroll until the last char is to the right side of the width of the fadelabel instead of all the way out to the left. | No |
| pauseatend | Specifies the time that the text will wait until it fades away before it scrolls again or moves to the next item. | No |
| resetonlabelchange | If set to false the fadelabel will not reset the scrolling offset when the label’s content changes. Useful if you have things such as theplay time (in seconds) inside a fadelabel. Defaults to true. | No |
