text, scrolltext, markdown
Les trois façons d’afficher du texte.
text — le texte courant (18 propriétés)
<text name="titre">
<pos>0.06 0.08</pos>
<size>0.5 0.1</size>
<text>${system}</text>
<fontPath>${root}/data/fonts/Exo2.otf</fontPath>
<fontSize>0.05</fontSize>
<color>FFFFFF</color>
<alignment>left</alignment>
<forceUppercase>true</forceUppercase>
</text>| Propriété | Type | Rôle |
|---|---|---|
pos size origin rotation rotationOrigin | paire | placement — voir Position, taille, origine |
text | texte | le contenu, variables comprises |
path | chemin | lit le contenu dans un fichier, au lieu de text |
fontPath | chemin | la police |
fontSize | nombre | < 1 = ratio de hauteur d’écran, >= 1 = pixels |
fontStyle | texte | normal, bold, italic, bolditalic |
color | couleur | la couleur du texte |
backgroundColor | couleur | un fond derrière le texte |
alignment | texte | voir ci-dessous |
forceUppercase | oui/non | tout en capitales |
lineSpacing | nombre | interligne, 1.2 par défaut |
multiline | oui/non | autoriser le retour à la ligne |
zIndex | nombre | profondeur |
disabled | oui/non | éteindre le composant |
alignment agit sur deux axes
La valeur combine l’horizontale et la verticale.
Neuf positions, treize façons de les écrire — quatre valeurs sont des synonymes :
| Position | À écrire | Synonyme |
|---|---|---|
| haut-gauche | topleft | |
| haut-centre | topcenter | top |
| haut-droite | topright | |
| centre-gauche | centerleft | left |
| centre | center | |
| centre-droite | centerright | right |
| bas-gauche | bottomleft | |
| bas-centre | bottomcenter | bottom |
| bas-droite | bottomright |
⚠️ Une valeur inconnue ne laisse pas l’alignement précédent : elle retombe sur centre-gauche, la valeur par défaut.
Le texte est aligné dans sa boîte size : sans size, l’alignement n’a rien pour s’exercer.
scrolltext — le texte qui défile (16 propriétés)
Mêmes propriétés que text, sans multiline et lineSpacing. Le texte défile horizontalement quand il dépasse de sa boîte.
<scrolltext name="titre-long">
<size>0.4 0.06</size>
<text>${game.name}</text>
<fontSize>0.04</fontSize>
</scrolltext>À réserver aux valeurs dont on ne maîtrise pas la longueur — un nom de jeu, un développeur.
markdown — le texte mis en forme (15 propriétés)
<markdown name="synopsis">
<pos>0.06 0.5</pos>
<size>0.4 0.35</size>
<text>${game.synopsis}</text>
<fontSize>0.028</fontSize>
<color>C6CBD8</color>
</markdown>Mêmes propriétés que text, sans fontStyle, backgroundColor ni multiline.
Il comprend une mise en forme simple dans le texte : **gras**, *italique*, # titre, listes à tirets. Utile pour un synopsis ou une page « à propos ».
⚠️
markdownne gère pas le défilement : un texte plus long que sa boîte est coupé.