The <scrolltext> object displays a line of text that scrolls horizontally when it exceeds the width allocated to it. It is the natural choice for a game name, a developer or a genre, whose length is unpredictable.
<scrolltext>was introduced in Recalbox 10.
| View | Name | Element |
|---|---|---|
system |
systemInfo |
The system information line |
detailed |
md_developer, md_publisher, md_genre, md_releasedate |
The variable-length metadata values |
gameclip |
md_gameName, md_systemName |
The game name and the system name |
gameclip |
md_developer, md_publisher, md_genre, md_releasedate, md_players, md_playcount, md_favorite |
The metadata values |
For any other scrolling text, pick your own name and add extra="true".
| Property | Type | Purpose |
|---|---|---|
pos |
Pair | Object position. See common properties. |
size |
Pair | Frame size. The width is what triggers scrolling when the text exceeds it. |
origin |
Pair | Point of the object that pos refers to. |
rotation |
Float | Rotation angle in degrees, clockwise when positive. |
rotationOrigin |
Pair | Point the rotation happens around. Defaults to 0.5 0.5. |
text |
String | Text to display. Accepts ${...} variables. |
path |
Path | Path of a text file to load, instead of typing the text in text. |
backgroundColor |
Colour | Text background colour. |
fontPath |
Path | TrueType or OpenType font to use. |
fontSize |
Float | Font size, as a fraction of screen height. |
fontStyle |
String | Font style: bold, italic or bolditalic. The engine simply looks for the letter b (bold) and the letter i (italic) inside the value. |
color |
Colour | Colour applied to the object. |
alignment |
String | Horizontal alignment: left, center or right. center also centres vertically. |
forceUppercase |
Boolean | Displays text in uppercase. |
zIndex |
Float | Drawing order, from lowest to highest. |
disabled |
Boolean | Hides the object entirely. |
<scrolltext name="md_developer, md_publisher, md_genre" fontSize="0.028" color="FFFFFFFF" />
<scrolltext name="infoLine" extra="true" text="${game.name} — ${game.developer}"
pos="0.05 0.92" size="0.9 0.04" fontSize="0.03" zIndex="15" />