Les variables système donnent les informations du système actuellement affiché : celui sélectionné dans la liste des systèmes, ou celui dont on parcourt la liste de jeux. Sur un système virtuel (favoris, genre, constructeur arcade), ce sont bien les informations du système virtuel qui sont retournées, pas celles du jeu sélectionné.
Ces variables n'existent que pour les thèmes conçus pour Recalbox 10 minimum.
Elles sont utilisables dans la liste des systèmes comme dans les listes de jeux.
±NToutes les variables listées ci-dessous acceptent un décalage entier, positif ou négatif, collé au nom. Cela permet d'afficher les systèmes voisins de celui qui est sélectionné — pratique pour construire un carrousel personnalisé.
| Exemple | Résultat |
|---|---|
${system+1} |
nom du système suivant |
${system.logo-2} |
logo du deuxième système précédent |
${system.manufacturer+999999} |
fonctionne aussi : le décalage boucle |
Le décalage porte sur la liste des systèmes visibles, et boucle automatiquement en haut comme en bas. S'il n'y a qu'un seul système affichable, toutes les variables décalées renvoient ce même système.
<view name="system">
<text name="precedent" extra="true" text="${system-1}" pos="0.1 0.5" />
<text name="courant" extra="true" text="${system}" pos="0.5 0.5" />
<text name="suivant" extra="true" text="${system+1}" pos="0.9 0.5" />
</view>
${system}Nom complet du système.
Sony Playstation 1
${system.name}Nom interne du système. C'est ce nom qui sert aux réglages et aux dossiers de ROMs — attention, il ne correspond pas toujours au dossier de thème.
psx
${system.logo}Chemin vers le logo par défaut du système, tel que Recalbox le résout : d'abord une version localisée (psx-fr_FR.svg, puis psx-fr.svg), puis une version régionalisée (psx-eu.svg), et enfin le logo générique.
/recalbox/system/resources/logos/psx.svg
${system.manufacturer}Nom du constructeur.
Sony
${system.releasedate}Date de sortie du système, au format AAAA-MM.
1994-12
${system.type}Type de système, parmi arcade, virtual-arcade, console, handheld, computer, fantasy, engine, virtual et port.
console
${system.type.name}Type de système sous une forme lisible, parmi Arcade, Virtual Arcade System, Home Console, Handheld Console, Computer, Fantasy Console, Game Engine, Virtual System et Port.
Home Console
${system.input.pad}Nécessité d'une manette, parmi mandatory, recommended, optional et no.
mandatory
${system.input.mouse}Nécessité d'une souris, mêmes valeurs.
${system.input.keyboard}Nécessité d'un clavier, mêmes valeurs.
Un usage classique consiste à afficher une pastille par périphérique requis :
<image name="pictoPad" extra="true" path="${root}/art/pad-${system.input.pad}.svg" pos="0.05 0.85" size="0.04 0" />