Nommer et réutiliser

Le nom d’un composant, et comment en créer plusieurs d’un coup.

Deux choses à ne pas confondre

<image name="mon-fond">

• image est le type de composant : il décide de ce que le composant sait faire et des propriétés qu’il accepte. Il doit être choisi dans la liste des types existants — voir Les composants. Un type inventé est ignoré ;
• name est votre étiquette. Elle est libre… sauf si vous reprenez un des noms réservés par Recalbox, auquel cas le composant est relié au moteur — voir Les vues et leurs composants.

Deux composants de même name dans la même vue n’en font qu’un : le second complète ou remplace le premier. C’est voulu — c’est le mécanisme des surcouches — mais c’est une source d’erreurs quand on nomme deux décors « fond » sans y penser.

Créer plusieurs composants d’un coup

<box name="bande1, bande2, bande3, bande4">
  <size>0.01 1</size>
  <color>FFFFFF20</color>
</box>

Quatre composants, mêmes propriétés. Il reste à leur donner leur position individuelle plus loin :

<box name="bande1"><pos>0.90 0</pos></box>
<box name="bande2"><pos>0.92 0</pos></box>

Modifier sans tout réécrire

Comme le dernier gagne, il suffit de redéclarer la seule propriété qui change :

<include>${root}/views/base.xml</include>

<view name="system">
  <box name="fond"><color>7C2E44</color></box>   <!-- le reste est conservé -->
</view>