Fade label control: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
(13 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<section begin="main content" />
<section begin="main content" />
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. A fade label control is not supported in a list container.
The fade label control is used for displaying multiple pieces of text in the same space in Kodi. 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. A fade label control is not supported in a list container.
=== Example ===
=== Example ===
<syntaxhighlight lang="XML" enclose="div">
<syntaxhighlight lang=xml enclose="div">
   <control type="fadelabel" id="1">
   <control type="fadelabel" id="1">
         <description>My First fadelabel</description>
         <description>My First fadelabel</description>
         <posx>80</posx>
         <left>80</left>
         <posy>60</posy>
         <top>60</top>
         <width>250</width>
         <width>250</width>
         <visible>true</visible>
         <visible>true</visible>
Line 19: Line 19:
         <textcolor>FFB2D4F5</textcolor>
         <textcolor>FFB2D4F5</textcolor>
         <textoffsetx>20</textoffsetx>
         <textoffsetx>20</textoffsetx>
        <scroll>true</scroll>
        <randomize>true</randomize>
   </control>
   </control>
</syntaxhighlight>
</syntaxhighlight>
Line 33: Line 35:
|  '''info'''
|  '''info'''
|  
|  
Specifies the information that should be presented. XBMC will <span class="nobr">auto-fill</span> in this info in place of the <label>. [[InfoLabels|See here for more information.]]
Specifies the information that should be presented. Kodi will <span class="nobr">auto-fill</span> in this info in place of the <label>. [[InfoLabels|See here for more information.]]
|-  
|-  
|  '''font'''
|  '''font'''
Line 39: Line 41:
|-  
|-  
|  '''textcolor'''
|  '''textcolor'''
|  Specified the color the text should be, in hex AARRGGBB format, or a name from the [[Colour Themes|colour theme.]]
|  Specified the color the text should be, in hex AARRGGBB format, or a name from the [[Colour themes|colour theme.]]
|-  
|-  
|  '''textoffsetx'''
|  '''textoffsetx'''
Line 45: Line 47:
|-  
|-  
|  '''shadowcolor'''
|  '''shadowcolor'''
|  Specifies the color of the drop shadow on the text, in AARRGGBB format, or a name from the [[Colour Themes|colour theme.]]
|  Specifies the color of the drop shadow on the text, in AARRGGBB format, or a name from the [[Colour themes|colour theme.]]
|-  
|-  
|  '''angle'''
|  '''angle'''
Line 51: Line 53:
|-  
|-  
|  '''scrollout'''
|  '''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.
|  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. Defaults to true
|-  
|-  
|  '''pauseatend'''
|  '''pauseatend'''
Line 61: Line 63:
|  '''scrollspeed'''
|  '''scrollspeed'''
|  Scroll speed of text in pixels per second. Defaults to 60.
|  Scroll speed of text in pixels per second. Defaults to 60.
|-
|  '''scroll'''
|  If set to false, the labels won't scroll. Defaults to true.
|-
|  '''randomize'''
|  If set to true, the labels will be displayed in a random order. Defaults to false.
|}
|}


<section end="main content" />
<section end="main content" />
== See also ==
== See also ==
'''Development:'''
'''Development:'''

Revision as of 00:39, 13 July 2020

The fade label control is used for displaying multiple pieces of text in the same space in Kodi. 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. A fade label control is not supported in a list container.

Example

  <control type="fadelabel" id="1">
        <description>My First fadelabel</description>
        <left>80</left>
        <top>60</top>
        <width>250</width>
        <visible>true</visible>
        <scrollout>true</scrollout>
        <pauseatend>200</pauseatend>
        <label>6</label>
        <info>MusicPlayer.Genre</info>
        <info>MusicPlayer.Artist</info>
        <info>MusicPlayer.Album</info>
        <info>MusicPlayer.Year</info>
        <font>font14</font>
        <textcolor>FFB2D4F5</textcolor>
        <textoffsetx>20</textoffsetx>
        <scroll>true</scroll>
        <randomize>true</randomize>
  </control>

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.

Tags Description
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. Kodi 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, or a name from the colour theme.
textoffsetx Specify the offset from the left edge that the text should be rendered at when static (not scrolling). The scrolling text will still scroll using the full <width> of the control.
shadowcolor Specifies the color of the drop shadow on the text, in AARRGGBB format, or a name from the colour theme.
angle Specifies the angle at which the text should be drawn, measured counter clockwise from the horizontal.
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. Defaults to true
pauseatend Specifies the time that the text will wait until it fades away before it scrolls again or moves to the next item.
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 the play time (in seconds) inside a fadelabel. Defaults to true.
scrollspeed Scroll speed of text in pixels per second. Defaults to 60.
scroll If set to false, the labels won't scroll. Defaults to true.
randomize If set to true, the labels will be displayed in a random order. Defaults to false.


See also

Development: