La vue system — les machines
Le carrousel, le logo, la ligne d’informations.
Le premier écran : la liste de vos machines.
Les composants réservés
| Nom | Type | Rôle |
|---|---|---|
systemcarousel | carousel | le carrousel — un seul, non renommable |
logo | image | le logo du système dans le carrousel |
systemInfo | text | la ligne « 510 jeux disponibles, 13 favoris » |
bgsound | sound | la musique de fond du thème |
directory | sound | le dossier de musiques du thème |
bgsoundetdirectorysont les seuls noms que<sound>accepte, et uniquement dans cette vue.
Deux pièges
systemInfo a un fond gris par défaut. Pour l’enlever :
<text name="systemInfo">
<backgroundColor>00000000</backgroundColor>
</text>
Le carrousel est unique. Un second <carousel> est lu sans erreur mais jamais dessiné.
Le logo par défaut
Quand le thème ne fournit pas de logo, Recalbox cherche le sien dans cet ordre :
<systeme>-<langue_PAYS>.svg → <systeme>-<langue>.svg
→ <systeme>-<region>.svg → <systeme>.svg
C’est ce qui permet d’avoir un logo « Genesis » aux États-Unis et « Mega Drive » en Europe sans rien écrire.
Le carrousel en détail
| Propriété | Défaut | Précision |
|---|---|---|
type | horizontal | horizontal, vertical, vertical_wheel ; toute autre valeur retombe sur horizontal |
logoSize | calculé | ratio de l’écran, pas du carrousel |
logoScale | 1.2 | agrandissement du logo choisi |
maxLogoCount | 3 | arrondi à l’entier — une décimale ne sert à rien |
color | transparent | le fond du carrousel |
L’espacement des logos se calcule ainsi :
espacement = (longueur − logoSize × maxLogoCount) / maxLogoCount + logoSize
où longueur est size.y en vertical, size.x en horizontal.