Wormux 0.5
Guide du dveloppeur Wormux (Franais)
--------------------------------------

Si vous vous sentez capable de nous aider, veuillez nous crire par email :

  wormux-dev _AT_ gna.org

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

  //# define DEBUG_CHG_ETAT
  //# 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.

Si GDB se bloque sur un signal SIGTTOU, c'est srement  cause du son. Le
plus simple tant de dsactiver l'interception de ces signaux :
  handle SIGTTOU noprint nostop


* 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.
