[English] [Français]

Introduction

Définitions des membres et fabrication du squelette des personnages.

 
<sprite name="body-normal" type="body" >
  <image file="body.png"/>
  <anchor dx="12" dy="15"/>
  <attached member_type="head" frame="*" dx="10" dy="1"/>
  <attached member_type="arm-right"  frame="*" dx="5" dy="9"/>
  <attached member_type="arm-left"  frame="*" dx="11" dy="8"/>
  <attached member_type="foot-right"  frame="*" dx="9" dy="28"/>
  <attached member_type="foot-left"  frame="*" dx="18" dy="26"/>
  <attached member_type="jetpack" frame="*" dx="3" dy="13"/>
  <attached member_type="jetpack-belt" frame="*" dx="0" dy="20" />
</sprite>

• Champs name : nom du membre
• Champs type : indique le type de membre. La valeur donnée au champs type est arbitraire, on peut lui donner n'importe quelle valeur. Il faut cependant veiller à donner le même type à deux membres décrivant la même partie du corps du personnage. (par exemple: Workrave possède deux corps différents: un s'il est vivant (body-normal) et l'autre s'il est mort (body-dead), dans chaque cas le type est fixé à "body").
• Champs image : nom de fichier de l'image associée au membre (voir §5 pour l'utilisation d'animations au lieu d'images fixes).
• Champs anchor : définit les coordonnées du point d'encrage sur l'image. Ce point sert de centre de rotation à ce membre (voir schéma ci-dessous), et de point d 'attache au membre supérieur.
• Champs attached : décrit le squelette du skin en indiquant quel type de membre (member_type) peut être rattaché au membre étant décrit. frame est utilisé pour des membres animés (voir §5). Les coordonnées dx et dy indiquent la position du point d'ancrage du membre attaché (voir schéma ci-dessous).
  
  
  Par exemple, le corps simplifé de Workrave, avec seulement un bras donnerait :
  
  Code XML :

  <sprite name="body-normal" type="body" >
    <image file="body.png"/>
    <anchor dx="12" dy="15"/>
    <attached member_type="arm-right"  frame="*" dx="5" dy="9"/>
  </sprite>
  <sprite name="arm-right-normal" type="arm-right" >
    <image file="arm.png"/>
    <anchor dx="2" dy="0"/>
  </sprite>

  
  

  

• Membre weapon : il faut attacher à chaque corps un membre de type "weapon", indiquant quel membre tient l'arme.
  

Définitions des vêtements.

<clothe name="normal">
  <member name="arm-left-normal"/>
  <member name="foot-left-normal"/>
  <member name="body-normal"/>
  <member name="head-normal"/>
  <member name="foot-right-normal"/>
  <member name="arm-right-normal"/>
  <member name="weapon"/>
</clothe>

• Champs name : défini le nom du vêtement. Selon les circonstances WarMUX affiche un certain vêtement s'il est disponible dans le fichier XML (par exemple le vêtement "helmet" est affiché, lorsque l'arme anti-gravité est utilisée (voir §6 pour la liste des différents vêtements).
• Champs member : name est le nom du membre à afficher, et layer indique dans quel ordre afficher les membres, les différentes couches étant placé dans l'ordre.
  
  

  

• Membre body : chaque vêtement doit contenir un membre de type "body" car il sert de base à l'affichage du skin.
• Membre weapon : si le vêtement décrit peut être utilisé lorsque le skin utilise une arme, il faut inclure un membre "weapon" dans le vêtement. L'arme est toujours affichée au premier plan et donc son numéro de layer n'a pas d'importance (pour l'instant en tout cas
  

Définitions des mouvements.

<movement name="jump" speed="100">
  <collision_rect left="5" right="5" top="10" bottom="2" />
  <frame number="0">
     <member type="head" follow_crosshair="true"/>
     <member type="arm-left" angle="90" follow_speed="true"/> 
     <member type="arm-right" angle="90" follow_speed="true"/>
     <member type="foot-left" angle="0" follow_speed="true"/>
     <member type="foot-right" angle="0" follow_speed="true"/>
  </frame>
</movement>

• Champs name : déifni le nom du mouvement. Selon les circonstances WarMUX applique un certain mouvement au joueur s'il est disponible dans le fichier XML(par exemple le mouvement "jump" lorsque le joueur saute. Voir §6 pour la liste des mouvements gérés)
• Champs speed : défini la durée en millisecondes de chaque image de l'animation
• Champs collision_rect : au niveau du calcul des déplacements des objets dans WarMUX, chaque objet est considéré comme étant un rectangle. Lorsque les rectangles représentant deux objets se touchent, on considère qu'il y a une collision. Afin que le rectangle de test de collision correspondent le mieux possible au skin le champ collision_rect défini les bords à supprimer du rectangle initial associé au personnage (rectangle de 30x45 pixels).
  
  

  

• Champs frame number : numéro de frame
• Champs member : type indique le type de membre à déplacer. angle indique l'angle de rotation par rapport à sa position initial (et non pas par rapport à la frame précédente). L'angle est en degrés et les membres tournent dans le sens des aiguilles d'une montre.
  
  dx et dy indiquent des déplacements en pixels. Certaines options spéciales peuvent être utilisées pour que le mouvement soit calculé par WarMUX (les mouvements calculés sont ajoutés à l'angle et déplacement définis pour la frame) :
• • follow_speed permet au membre de suivre la trajectoire :
  
  

  
  

• • follow_crosshair permet au membre de suivre le viseur de l'arme. (aucune modification si l'arme n'utilise pas le viseur)
  • follow_direction fait tourner le membre de 180° quand le personnage est tourné vers la gauche. Ce paramètre sert essentiellement avec le mouvement "ninja-rope" pour pas que le skin se retrouve la tête en bas lorsqu'on le déplace vers la gauche.
    

Définition de membres à partir de sprites animés.

 
<sprite name="yoyo" type="yoyo">
  <image file="yoyo.png">
     <grid pos="0,0" size="32,42" array="36,1" />
  </image>
  <anchor dx="29" dy="25"/>
  <animation speed="150" />
</sprite>

• Champs grid:
• Champs pos: inutilisé
• Champs size: taille d'une image constituant l'animation
• Champs array: disposition des images de l'animation dans le fichier file (ici yoyo.png est constitué de 36 images de 32x42 pixels disposées sur 1 ligne de 36 images).
• Champs animation: l'option speed du champs animation donne la durée de chaque frame de l'animation en millisecondes.
  

Liste des vêtements et mouvements gérés

À développer

• Toutes les skins utilisent les mêmes yeux (2 fichiers : fond et pupille)
• Ou placer les fichiers ?
• Quels sont les fichiers ?
• Combien de lignes environ le fichier de configuration
• Le dossier team : son fichier de config, son drapeau