Text
Last updated
Last updated
The Text effect enables up to 20 lines of text, all individually controlled to be displayed. The content of the text can be static, but can also include countdown timers. Adding a '\n' to the text will display the text following it on a new line.
Option/Settings
In order to stop the text after one cycle, use the "Vector" Movement option and define your vector motion. It will complete that motion in the duration of the effect. This option can also be used to stop text at a particular point on a matrix.
Specific "Keys" can be used to insert Sequence Settings Values into the text effect. These "keys" will replaced with the values specified in the Sequence Settings.
Replace Key | Sequence Settings Meta Data |
---|---|
Option/Settings
Description
Text
Contains the text that is to be displayed for the line.
From File
Set Text to be displayed from a local file.
From Lyrics
Set Text to be displayed from a Lyric Track.
Font
Defines the font that is to be used for the text. Click on the attribute to open up a window where the type of font, style, size, color and other related attributes can be defined.
XL Font
Use an OS defined font or Select one of the xLights defined fonts. The xLights defined fonts are intended to match LOR SuperStar and may look better on models with lower pixel density.
Movement / C
Defines the direction of the movement of the line of text. One of several options are possible such as Left, Right, Down, None, etc.
If the box next to the Movement setting i.e. ‘C’ is checked, then the text will reach the center and stop.
When the Vector option is selected, the Start Position and End Position tabs at the bottom are used to adjust the motion. 0,0 is the middle position. It defaults to offsetting with the values being percentages of the model size but if you check the Offsets in Pixels box it becomes number of pixels.
Speed
Controls the speed at which the line of text moves.
Effect
Controls the layout of the line of text. The default is ‘Normal’, however other options to rotate the text at different angles are possible.
Count down
Defines whether the line of text is to be used as a Countdown Timer. The default value is ‘None’ indicating that it is not a Countdown Timer effect.
For a count down effect, the following options are possible and count down will be based from the time the effect is rendered or finally saved and not from when it is executed in the sequence. The concept of the count down timer stems from New Year’s Eve countdown displays. If one knows exactly when the countdown will start, then setting this to an appropriate date/time is a non-issue.
The date/time must conform the the RFC822 standard format.
Properly formatted examples are: Fri, 25 Dec 2015 00:00:00 +0100
Fri, 25 Dec 2015 00:00:00 EST
Fri, 25 Dec 2015 00:00:00 MST
Fri, 25 Dec 2015 00:00:00 -0800
<b></b>
These must be specified in the Text field without any quotes. seconds
100
Will execute a 100 second countdown
In the following examples ‘+0100’ refers to your time +GMT hours. Change accordingly. Or you can use GMT, EST etc.
to date ‘d h m s’
Fri, 25 Dec 2015 00:00:00 +0100
Will display 33d 3h 38m 14
to date ‘h:m:s’
Fri, 25 Dec 2015 00:00:00 +0100
Will display 3h 38m 14 - the time is calculated to the next day in hours, mins, secs
to date ‘m’ or ‘s’
Fri, 25 Dec 2015 00:00:00 +0100
Will display 217m - the time is calculated to the next day in minutes
to date ‘s’
Fri, 25 Dec 2015 00:00:00 +0100
Will display 13011 - the time is calculated to the next day in seconds
!to date !%tofmt
!Fri, 25 Dec 2015 00:00:00 +0100!%D
Will display 133
Position
This setting is used to adjust the initial position of the text. Either the vertical (Y) or the horizontal (X) position of the text is adjusted, depending on the value of the ‘Movement’ setting. For a value of ‘None’ or a horizontal movement such as Left / Right, adjusting the setting will move the initial position of the text vertically.
Only the first line of text can be controlled vertically and horizontally. The other lines have a horizontal control only.
You can however use multiple Layers each with one or more text lines if required.
${TITLE} or ${SONG}
Song
${ARTIST}
Artist
${ALBUM}
Album
${FILENAME}
Media File Name
${AUTHOR}
Author
${AUTHOREMAIL}
${COMMENT}
Comment
${URL}
Music URL
${WEBSITE}
Website