Skin.xml

Un article de XBOX Media Center FR.

Chaque thème de XBMC contient le fichier skin.xml qui donne une vue d'ensemble du skin/thème, des informations sur les crédits et la version.

[modifier] Exemple

 
  <skin>
    <defaultresolution>pal</defaultresolution>
    <defaultresolutionwide>pal16x9</defaultresolutionwide>
    <defaultthemename>default</defaultthemename>
    <effectslowdown>1</effectslowdown>
    <version>2.0</version>
    <zoom>1.1</zoom>
    <credits>
      <skinname>Le nom de mon skyn</skinname>
      <name>Awesome Skinner 1</name>
      <name>Awesome Skinner 2</name>
      <name>Awesome Skinner 3</name>
    </credits>
    <startwindows>
      <window id="0">513</window>
      <window id="1">0</window>
      <window id="3">Mon incroybale nouvelle fenêtre</window>
    </startwindows>
  </skin>

Une chose très importante à ne pas oublier est que tous les tags sont en minuscules. les tags XML sont sensibles à la casse!

[modifier] Présentation des balises (tags)

defaultresolution	Dossier de la résolution par défaut du skin. C’est le répertoire de base que toute requête de fichier d’écran XML ira consulter.
defaultresolutionwide	Dossier de la résolution widescreen par défaut de l’habillage. C’est le dossier que toute requête de fichier d’écran pour des résolutions widescreen (1080i, 720p, 480p 16x9, NTSC 16x9 et PAL 16x9) ira consulter. Si le fichier n’est pas trouvé, il basculera alors vers le dossier <defaultresolution>.
defaultthemename	Nom du thème par défaut. Actuellement mis à: Default.
effectslowdown	Un multiplicateur qui agit sur tous les temps d’effets <animation> du skin. Utile pour ralentir globalement toutes les animations afin que vous puissiez configurer les cadences et observer les interactions entre les contrôles d’animation.
version	Spécifie la version du moteur qui pilote le skin. La version minimum actuelle est la 2.0. L’équipe XBMC essaie d’assurer le plus longtemps possible une compatibilité descendante (généralement jusqu’à un palier majeur d’une version).
zoom	Facteur/multiplicateur d’agrandissement par défaut (agrandissement de l’interface graphique d’un skin afin de pouvoir ajuster un skin), la valeur par défaut est de 1.0, c’est-à-dire pas d’agrandissement.
credits	La balise du bloc destiné aux crédits.
name	Une simple ligne de crédit pour le skin. Vous pouvez utiliser jusqu’à 5 lignes de crédits, chacune limitée à 50 caractères.
startwindows	La balise du bloc startwindows.
window	Un écran de démarrage pour votre skin. L’attribut d’identification est son ID de skin, sa valeur est le nom de l’écran. Si une valeur numérique est donnée, elle est considérée comme une valeur à rechercher dans strings.xml

[modifier] Comment les fichiers d'écran XML sont trouvés

XBMC peut fonctionner dans différentes résolutions, et bien entendu, les skins/thèmes doivent essayer de fonctionner dans toutes ces résolutions. La plus simple façon est de créer pour une résolution et s'assurer que tous les contrôles contiennent les tags <width> et <height>. Ainsi, XBMC peut adapter les contrôles à la résolution en cours.

Toutefois, vous pouvez choisir de développer un fichier xml pour chaque résolution (par exemple pour la HDTV ou pour le 16/9eme). Voici, ci-dessous, l'ordre dans lequel XBMC lis les fichiers XML :

1. En premier il regarde dans le dossier correspondant a la résolution (un de ceux la 1080i, 720p, NTSC16x9, NTSC, PAL16x9 or PAL)
2. Si la résolution courante est 1080i, alors il regarde dans le dossier 720p.
3. Si la résolution est 16/9eme(1080i, 720p, NTSC16x9, PAL16x9), alors il regarde dans le dossier <defaultresolutionwide>.
4. Enfin, il regarde dans le dossier <defaultresolution>.

Cela vous permet de mettre le fichier nécessaire qui ne requiert pas de traitement spécial, pour le 16/9eme par exemple, dans le dossier <defaultresolution>, pour prévenir toute répétition inutile.