citronized.com

Introduction

Le développement pour Racer peut être une tâche décourageante de prime abord : il y a BEAUCOUP d'informations à assimiler. C'est un inconvénient comme un avantage, vous pouvez aller très loin.
Ici nous soulignerons ce que vous pouvez faire pour vous faciliter le développement. Cette page implique vous utilisiez la dernière version de développement, que vous pouvez obtenir en consultant la page des téléchargements des bêta.

Le fichier racer.ini

La plupart des paramètres globaux de Racer sont stockés dans ce fichier. C'est un document ASCII structuré, qui utilise '{' et '}' pour indiquer le début et la fin de l'arbre de variables. Par exemple :

resolution
  {
    x=50
    y=10
    samples
    {
      aa=16
    }
  }

C'est un peu comme le XML, la différence étant qu'il ne supporte que les chemins uniques. Les paramètres auquel la documentation se réfère utilisent des chemins avec des points. Par exemple, pour le code ci-dessus, on parlera de resolution.samples.aa=16. Dans le cas où la valeur de même nom est dupliquée, seule la première est utilisée. ndlt : De plus, dans cette traduction de la documentation, nous conserverons ce chemin en anglais, puisqu'il figure dans cette langue dans le code.
Donc, si vous avez :

resolution
  {
    x=50
    x=20
  }

Dans ce cas, resolution.x sera 50, et non pas 20. Il est d'ailleur recommandé dans ce cas de commenter la deuxième variable resolution.x pour éviter toute confusion, ainsi :

resolution
  {
    x=50
    ;x=20
  }

D'autres fichiers ini existent, ils sont utilisés pour les voitures (data/cars/[mavoiture]/car.ini^info) par exemple, ou pour la description des circuits (data/tracks/[moncircuit]/track.ini). Ils utilisent tous le même type de modèle.

Accéder aux variables durant le jeu

Il y a pas mal de variables que vous pouvez inspecter pendant que vous conduisez ; utilisez Ctrl+1 jusqu'à Ctrl+9 pour afficher les différents ensembles d'informations, que ce soient les forces appliquées aux pneus ou les clients réseau. Utilisez Ctrl+0 pour masquer cet affichage. Vous pouvez aussi utiliser la commande de script 'debug [n]' pour afficher ces informations.

Le fichier Qlog.txt

Racer va stocker les erreurs, avertissements et les messages d'information dans le fichier Qlog.txt. Ce fichier peut être retrouvé dans le répertoire de l'exécutable de Racer (racer.exe) après avoir exécuté le jeu au moins une fois. Ouvrez ce fichier dans un éditeur de texte et descendez en bas pour voir les derniers messages. Tous les messages sont archivés avec un maximum de 10 Mb, point auquel le fichier est renommé Qlog_old.txt et un nouveau fichier Qlog.txt est créé.

Beaucoup de gens ignorent le Qlog, mais il est spécialement nécessaire d'y être attentif lorsque l'on développe. Racer v0.7.4+ a une option dans le fichier racer.ini pour sauvegarder spécifiquement les messages de la dernière exécution dans un fichier Qlog_last.txt, vous pouvez ainsi voir instantanément ces derniers. Définissez, dans racer.ini l'option dev.log_last à 1, et Racer sauvegardera tous les derniers messages dans le fichier séparé (aussi bien que dans le fichier Qlog.txt) et tant qu'elle sera activée, Notepad lancera automatiquement (c'est une option uniquement pour Windows) le fichier Qlog_last.txt pour que vous puissiez immédiatement voir les messages. Si seuls des messages d'information sont enregistrés, notepad ne sera pas exécuté, donc vous ne verrez cette fenêtre que s'il existe un vrai problème.

Capter la sortie des messages de déboguage

Racer peut aussi sortir les message d'erreur directement vers une adresse réseau UDP, que ce soit en local ou sur le network. Dans racer.ini, recherchez l'option dev.udp_out et spécifiez un hôte et un port. Par exemple : dev.udp_out=192.162.0.102:7000
Dans ce cas, n'importe quel message Qlog sera immédiatement envoyé à cette combinaison d'hôte & port. Vous avez besoin d'un terminal UDP pour lire ces messages, mais heureusement Racer inclue udpterm, qui peut être exécuté en utilisant 'udpterm 7000' par exemple. Ça peut être sur l'ordinateur sur lequel Racer est exécuté (dans ce cas, définissez dev.udp_out avec la valeur 127.0.0.1:7000), ou sur un ordinateur différent sur le même réseau.

Essayez d'utiliser le port 7000 de préférence, étant donné qu'il n'est pas utilisé autre part que pour Racer.

Les messages Qlog ne sont pas les seuls à être envoyés via UDP ; il y a un grand nombre de messages supplémentaires que vous pouvez envoyer avec cette méthode. En fait, c'est la manière que j'utilise ndlt : Ruud Van Gaal pour déboguer. Envoyer des messages UDP ne consomme pas beaucoup de ressources.

Le système d'axes

Racer utilise le système d'axes de OpenGL. Cela veut dire que +Z = avant, +Y = haut et +X = gauche. Ce qui veut dire un système de coordonnées droitier. Regardez aussi l'image ci-dessous ; le point Y pointe vers le toit de la voiture.

Usuellement, toutes les unités dans Racer sont spécifiées selon la norme SI (Système d'unité International). Ce qui implique des mètres, des kilogrammes, etc. Les angles sont une exception ; ceux-ci sont exprimés en degrés, alors que la norme SI utiliserait des radians.

Les formats de fichiers

Racer interprète un certain nombre de formats. Pour le son, c'est tout ce que FMod peut interpréter, mais le *.wav est le format le plus commun. Les *.mp3 sont aussi possibles, mais vous souhaitez la meilleure qualité sonore, puisque vous mixez et transformez le son, de toute manière.

Pour le graphisme, voici les formats possibles :

• JPG - Utile pour les arrières plans, mais ce format a beaucoup de déperdition, il n'est donc pas recommendé pour les voitures ou les circuits.
• TGA -le format de choix jusqu'à la 0.8.2, en 24 ou 32 bits (le 32 bits contient le canal alpha), éventuellement compréssé.
• DDS - disponible depuis la 0.8.2, est supporté non-compressé, ou avec les compressions DXT1, DXT3 et DXT5. Ce sera certainement le format de choix à partir de maintenant, étant donné qu'il intègre les mipmaps. Quand ils sont générés 'offline' (dans Adobe Photoshop par exemple), les cartes de filtrage peuvent être de meilleure qualité comparé à ceux générés sur les CPU/GPU. Notez qu'ils chargent aussi plus vite.

Cette page est une traduction en français de la documentation originale de Ruud Van Gaal, disponible à l'adresse : http://racer.nl/tutorial/development.htm
De plus, la traduction de la documentation n'étant qu'à ses débuts, plusieurs liens peuvent ne pas fonctionner. Merci de votre compréhension.