A.I.P termine sa mise en place...

Cet espace lui est consacré, et donc le forum d'Advanced Irrlicht Project est un espace qui lui est dédié,
(pour tout ce qui touche Irrlicht à proprement parlé, restez sur le forum qui est prévue à cet effet SVP).

A.I.P étant un projet à vocation communautaire, toutes les bonnes volontés sont les bienvenues bien entendu...

• ----------------------------------------------------------------------------------------------------------

Le forum A.I.P s'articule en deux sections distincts.

• la première est une section généraliste, les titre des sous forums parlent d'eux même...
• la seconde est une section dédiée aux principaux chapitres que comprend le moteur.

respectez autant que faire se peux les sections.

• ----------------------------------------------------------------------------------------------------------

Comment contribuer ?


Trois possibilités s'offrent à vous:

• la première sous forme de critiques constructives. En d'autres termes, si certaines choses vous chagrinent, ou

encore manque dans Irrlicht, et que vous souhaitez les voir corrigés ou ajoutés au sein de A.I.P, alors faites
en part. Soyez le plus précis possible. N'hésitez pas à donner des exemples pour appuyer vos remarques,
fournissez une amorce de solution technique quand vous le pouvez.

• la seconde, en tant que testeur et utilisateur. La simple utilisation du moteur, et la remonté d'information sur

les soucis que vous rencontrez est en soit une forme de contribution, donc n'hésitez pas fournir vos remarques.

• la troisième, au niveau du code. Avant de chercher à modifier le code du moteur, il est bon que la chose soit avant

tout débattue. Postez votre code, ou le mieux encore, fournissez un exemple (accompagné d'un fichier compressé),
c'est toujours la solution idéale. Si l'intérêt est avéré, alors le code du moteur sera mis à jour.


A.I.P reste un moteur à vocation généraliste, ne venez pas pour de ajout atypiques, pensez que tout ce qui doit
être apporter a A.I.P doit servir au plus grand nombre.

• ----------------------------------------------------------------------------------------------------------

L'upload

Pour le moment, la capacité d'upload n'est donnée qu'a quelques membres du forum. En fonction de l'activité des
contributeurs, ainsi que de leur sérieux, cette capacité sera alors étendu.

Pour tout ceux qui ont la possibilité d'uploader, comme à chaque fois dans ce genre d'exercice, vérifiez bien que
vous partez de la dernière version en ligne du moteur et des fichiers qui lui sont associés, avant d'y apporter vos
modifications et de faire votre mise à jour.

• ----------------------------------------------------------------------------------------------------------

Règles et tags dans les fichiers sources

Par soucis de lisibilité, il est bon de respecter quelques règles d'écriture au sein des fichiers sources:

• en en-tête:

la première ligne doit toujours avoir cette forme:

revision XXXX étant le numéro de révision du fichier, pour le moment quasiment tous sont tagués revision 0001
Au fil des mises à jours, le changement de revision se fera automatiquement.

• tag au sein du code lui même:

pour permettre de mieux s'y retrouver au niveau des fichiers modifiés, il est bon d'appliquer un tag, cela facilite
grandement les recherches sur des fichiers volumineux, surtout si il y a plein de modif à pas mal d'endroit différents.

Le tag doit donc être composé obligatoirement de: ! -- AIP ---.
Quand c'est possible et que cela ne nuit pas trop à la visibilité, insérez la
date de la modif ainsi que la révision concernée.

Exemple:



ou

ou encore




Pour les nouveaux fichiers, bien entendu pas de tag. Par contre, une fois intégrés au moteur, si ceux-si sont
modifiés, la règle s'applique alors pour eux aussi.

.