Qu’est-ce qu’un thème ?

Ce qu’un thème change, et ce qu’il ne change pas.

Un thème Recalbox habille l’interface : la liste de vos systèmes au démarrage, celle de vos jeux, les menus, l’écran de veille.

Ce qu’un thème décide

• où les éléments se placent à l’écran, et de quelle taille ;
• quelles images s’affichent : fonds, logos, cadres, illustrations ;
• les couleurs et les polices, y compris celles des menus ;
• ce qui s’affiche selon le contexte : la définition de l’écran, le type de machine, le jeu survolé.

Ce qu’un thème ne décide pas

• le contenu des menus : Recalbox les construit lui-même. Un thème n’en règle que l’habillage ;
• les jeux, leurs informations, les émulateurs ;
• le comportement des boutons.

Le principe, en une phrase

Recalbox lit des fichiers XML qui déclarent des composants — une image, un texte, une liste — chacun avec sa position, sa taille et son apparence.

<image name="fond">
  <pos>0 0</pos>
  <size>1 1</size>
  <path>./data/fond.jpg</path>
</image>

Le studio écrit ces fichiers pour vous. Cette documentation explique la syntaxe complète : elle doit vous permettre d’écrire un thème entièrement à la main si vous le souhaitez.