               [ Guide pour les dveloppeurs voulant ]
               [  s'impliquer dans le projet Wormux  ]


Si vous vous sentez capable de nous aider, veuillez nous crire par email :
  victor.stinner AT haypocalc.com

Toute contribution bienvenue :
- Code
- Graphisme
- Commentaires
- Rapport de bug (voir BUGS.txt)


Dverminage
===========

La correction des bugs reprsente une grosse partie du dveloppement du projet.
De nombreux outils ont t utiliss / crits pour arriver  dbusquer les bugs.

Messages de dbogage
--------------------

Pour le dbogage du code source, de nombreux fichiers comportent au dbut
du code des "#define DEBUG_...". Exemple de obj_physique.cpp :
  #ifdef DEBUG
    // Affiche les changements d'tat ?
  //# define DEBUG_CHG_ETAT

    // Affiche des informations sur le moteur physique ?
  //# define DEBUG_MSG_PHYSIQUE
  (...)
  #endif

En dcommentant "#define DEBUG_CHG_ETAT" de nombreux messages de dbogages
vont tre crit dans la console. Ceux-ci sont trs utiles lorsque quelque
chose ne va pas.

debug.cpp
---------

Ce fichier est une aide pour les dbogeurs. Elle permet en particulier 
d'afficher des informations mises  jour en temps rel. Editez simplement
Debug::Gestion() pour afficher tout ce que vous voulez.

GDB
---

Au plus bas niveau, on trouve l'outil gdb, le dbogueur de GNU. Pour la doc,
voyez le site web.

Lorsqu'une assertion choue, un signal ABORT est mis qui sera attrap par gdb.
A ce moment l, tapez "backtrace" dans gdb pour voir trs simplement o est-ce
que le programme a bloqu.



Graphisme
=========

Toutes les images doivent tre au format PNG, car, contrairement au format GIF,
c'est un format ouvert. Les images doivent tre en 24 bits/pixel ou 
32 bits/pixel. Quoique, dans certains cas, le format 256 couleurs est support.

Pour lire des coordonnes dans le jeu, dcommentez 
"#define AFFICHE_COORD_SOURIS" dans debug.cpp, puis recompilez le programme.
Maintenant les coordonnes de la souris dans l'cran et dans le terrain sont
affiches. Vous pouvez changer de repre (secondes valeurs) simplement avec un
clic droit.
