Utilisation du Walktest

Le Walktest est une application de test essentielle à Crystal Space. Il vous fournit nombre de commandes et méthodes pour tester ou changer vos fichiers map, les débugguer, etc. Ce tutoriel à l'intention de vous expliquer les bases du Walktest pas à pas.

Lancer le Walktest

Après avoir compilé avec succès Crystal Space sur votre ordinateur, le Walktest est prêt à être utilisé. Ouvrez une console, et naviguez dans vos réportoire Crystal Space (Pour les utilisateur Windows : Démarrer -> Exécuter et taper cmd. Une console s'ouvrira, maintenant vous avez la console).

Débuter l'application avec la commande :

walktest

Tout d'abord, le Walktest ouvrira une nouvelle fenêtre, et vous pourrez y voir quantité d'informations sur votre version de Crystal Space, votre pilote graphique, etc. Cela ressemblera à çà :

Ensuite le Walktest chargera la map castle. Si Crystal Space ne trouve pas de données d'éclairage en précache, vous verrez un avertissement :

Le Walktest dispose d'une console de commande. Relight est une de ces commandes utilisables par le Walktest. Dans cet exemple nous devons l'utiliser, sinon notre map sera trop sombre. Appuyez sur la touche [Tab], et la console apparaîtra. Tapez la commande suivante et appuyer sur [Entrer] :

relight

Le calcul de l'éclairage prend du temps, spécialement si vous utilisez de grands fichiers de maps. Soyez donc patient. Appuyez sur la touche [Tab] et vous retournerez sur le monde 3D. Ok, pressez [Echap] et l'application se terminera.

Quand vous retaper dans votre console :

walktest

Vous pouvez voir que les infos d'éclairage ont disparu. Appuyer sur [Echap], et taper ceci :

walktest -relight

Le paramètre relight s'assure que l'éclairage de la map sera recréé, et Crystal Space sauvera l'information dans votre dossier /votre_dossier_de_map/cache/. Appuyez sur [Echap], et relancez une nouvelle fois walktest mais sans l'option relight et vous verrez que le moteur chargera les éclairages de map calculés précédemment. (A noter que cslight est une application qui calcule directement les éclairage de maps).

Parcourir le monde 3D

Dans le Walktest, vous pouvez parcourir la nouvelle map que vous avez créée, comme dans n'importe quel FPS (jeu de tir à la première personne). Les touches les plus importantes sont :

[Flèche haut] : Avancer
[Flèche bas] : Reculer
[Flèche gauche/droite] : Rotation de la caméra vers la gauche/droite
[Page précédente/suivante] : Rotation de la caméra vers le haut/bas
[Espace] : Sauter
[Alt + Flèche gauche/droite] : Pas de côté à gauche/droite
[Touche B] : Regarder derrière

Si vous utilisez Crystal Space 1.0, le Walktest chargera la grandiose map castle pour vous - amusez-vous à la parcourir. Après avoir pressé le bouton gauche de la souris, la caméra avancera. Si vous voulez utiliser le Walktest uniquement avec la souris, appuyez sur la touche [Tab] pour basculer en mode console et tapez ceci :

freelook on

Appuyez une nouvelle fois sur [Tab] et à partir de maintenant, lorsque vous bougerez la souris, la caméra bougera aussi. Si vous préférez inverser la rotation haut/bas de la souris (comme dans les simulateurs d'avion), tapez ceci dans la console :

inverse_mouse on

Les commandes :

freelook off

inverse_mouse off

sont très utiles, lorsque vous voulez rendre ces commandes inefficaces.

Il existe des options spéciales de déplacement appelées move3d. Si vous appuyer sur la touche [3] ou tapez cette commande dans la console :

move3d on

Rebasculer dans la vue 3D et vous verrez le résultat lorsque vous essayerez de vous déplacer. Vous vous déplacerez pas à pas, mais le plus important est que vous pourrez vous déplacez dans n'importe quelle direction (la gravité est désactivée). Orientez la caméra ves le haut avec la touche [page précédente] et vous pourrez avancer vers le haut. Le mouvement de la caméra sera en 3D réelle. Essayez et observez le résultat. Les [Flèche gauche/droite] ferons pivoter la caméra comme vous pouvez le prévoir. Pour le désactiver : appuyer sur la touche [3] une seconde fois, ou tapez dans la console :

move3d off

Cette commande est plus efficace lorsque vous activez freelook sur on. (C'est uniquement l'opinion de l'auteur).

Plusieurs vues

Le Walktest peut facilement diviser votre écran (comme dans les jeux de course). Appuyer sur les touches [Shift+S], et vous verrez quelque chose comme ceci :

Maintenant vous avez deux vues différentes. Pour basculer de l'une à l'autre, appuyez sur [Shift+T] (toggle). En pressant les touches [Shift+U], vous repasserez en mode une vue, la seconde vue (celle qui est passive) disparaîtra.

Gravité et détection de collision

Lorsque vous n'avez pas besoin de la gravité, appuyez simplement sur la touche [8] ou taper la commande :

do_gravity off

Maintenant quand vous appuierez sur la touche [Espace], la caméra sautera et restera dans les airs. Vous serez capable de marcher dans les airs, comme Jésus sur l'eau. Quand vous vous sentirez l'envie de traverser les murs mais sans en avoir l'opportunité de le faire, il suffira de taper dans la console :

colldet off

Maintenant, vous pourrez vous déplacer à travers n'importe quel objet solide, comme pourrais le faire un fantôme dans un château écossais.

Plus de commandes utiles

Pour obtenir une moyenne du frame-rate (images par seconde), appuyer sur la touche [P] ou utilisez la commande perftest. La commande fera un rendu sur 200 images (par défaut), et notera le résultat dans la console.

La commande suivante fera un test sur 1000 images, en changeant ce paramètre, vous pourrez tester différentes mesures.

perftest 1000

En appuyant sur les touches [Ctrl+C], le Walktest vous affichera votre position actuelle et le nom du secteur comme sur l'image :

coordshow on

Vous pourrez faire une sauvegarde de la position de votre caméra, et la recharger plus tard. Pour sauvegarder, appuyer sur les touches [Shift+C], pour recharger la touche [C]. Votre caméra se déplacera dans la position sauvegardée. Moins de mouvement, moins de perte de temps - sauvegarder les bonnes coordonnées accélérera grandement les choses. A noter, la position de la caméra sera sauvée dans le répertoire /tmp/ répertoire VFS . La prochaine fois que vous utiliserez le Walktest, taper sur [C] restaurera cette position.

Vous pouvez basculer l'affichage du logo avec la touche [L], ou avec la commande :

do_logo on

ou

do_logo off

Options du Walktest en ligne de commande

Le Walktest vous fournit plusieurs options de ligne de commande. La plus importante est le chemin de la map que vous voulez charger. Pour charger la map terrainf, vous devez taper :

walktest /lev/terrainf

ou simplement :

walktest terrainf

Car le /lev/ n'est pas nécessaire quand votre map se situe dans le dossier VFS /lev/.

Autres options

Logo 

Le logo Crystal Space sera affiché.

nologo 

Le logo Crystal Space ne sera pas affiché.

colldet 

Détection de collision activée.

nocolldet 

Détection de collision désactivée.

saveable 

Drapeau de sauvegarde moteur activé.

nosaveable 

Drapeau de sauvegarde moteur désactivé.

help 

Affiche l'aide sur la ligne de commande.

Fichiers de script du Walktest

Le Walktest peut exécuter des scripts. Ces scripts sont des commandes standard pour le Walktest, elles exécuteront une frame par commande. Le Walktest lit par défaut le fichier /cs/data/config/autoexec.cfg au démarrage. Voici le contenu du fichier :

bind f8 exec /this/perfscript
bind tab console toggle
bind space jump
bind ctrl-l lightning
bind shift-a p_alpha ++1
bind alt-a p_alpha --1
bind a action
bind b turn
bind shift-c coordsave
bind c coordload
bind ctrl-c coordshow toggle
bind d emode front2back
bind shift-d emode back2front
bind alt-d emode zbuffer
bind shift-e frustum toggle
bind shift-l addlight 1,1,1,1000
bind alt-l addstlight 1,1,1,1000
bind l do_logo toggle
bind p perftest
bind q quit
bind esc quit
bind r record
bind shift-r play
bind alt-r playo nce
bind ctrl-t things toggle
bind z cosfact ++.1
bind shift-z cosfact --.1
bind shift-1 dellight
bind 1 addlight
bind alt-1 dellights
bind 2 picklight
bind shift-2 droplight
bind f1 extension sim_pal
bind f2 extension sim_grey
bind f3 extension sim_332
bind f4 fs_inter .01,100
bind f5 fs_fadeout
bind f6 fs_fadetxt spark
bind \ freelook toggle
bind ) db_procpol 0
bind _ db_procpol --1
bind + db_procpol ++1
bind ) db_octree 0
bind _ db_octree --1
bind + db_octree ++1
bind = lod 0
bind [ lod --.01
bind ] lod ++.01
bind = db_frustum 0
bind [ db_frustum --1
bind ] db_frustum ++1
bind status-left strafe_left
bind status-right strafe_right
bind status-alt-left strafe_left
bind status-alt-right strafe_right
bind status-left rotate_left
bind status-shift-left rotate_left
bind status-right rotate_right
bind status-shift-right rotate_right
bind status-up step_forward
bind status-shift-up step_forward
bind status-down step_backward
bind status-shift-down step_backward
bind status-pgup look_up
bind status-pgdn look_down
bind ctrl-left i_rotleftc 1,0
bind ctrl-right i_rotrightc 1,0
bind ctrl-alt-left i_left 1,0
bind ctrl-alt-right i_right 1,0
bind ctrl-up i_forward 1,0
bind ctrl-down i_backward 1,0
bind ctrl-alt-up i_up 1,0
bind ctrl-alt-down i_down 1,0
bind ctrl-pgdn i_rotleftx 1,0
bind ctrl-pgup i_rotrightx 1,0
bind ctrl-alt-pgdn i_rotleftz 1,0
bind ctrl-alt-pgup i_rotrightz 1,0
bind ctrl-shift-left i_rotleftc 0,1
bind ctrl-shift-right i_rotrightc 0,1
bind ctrl-shift-alt-left i_left 0,1
bind ctrl-shift-alt-right i_right 0,1
bind ctrl-shift-up i_forward 0,1
bind ctrl-shift-down i_backward 0,1
bind ctrl-shift-alt-up i_up 0,1
bind ctrl-shift-alt-down i_down 0,1
bind ctrl-shift-pgdn i_rotleftx 0,1
bind ctrl-shift-pgup i_rotrightx 0,1
bind ctrl-shift-alt-pgdn i_rotleftz 0,1
bind ctrl-shift-alt-pgup i_rotrightz 0,1
bind ctrl-alt-up i_up 0,0
bind ctrl-alt-down i_down 0,0
bind ` inverse_mouse toggle
bind status-0 fire
bind 3 move3d toggle
bind shift-8 colldet toggle
bind 8 do_gravity toggle
bind s sprlight toggle
bind f9 addsprite bot,1
bind f10 delsprite bot
bind alt-enter fullscreen
bind ' speed toggle
bind shift-s split_view
bind shift-u unsplit_view
bind shift-t toggle_view
bind alt-c cubemapshots

La commande bind (comme dans les jeu du style Quake) lie les touches aux actions. Quand vous réécrivez ce fichier, vous pouvez changer les liaisons par défaut des touches, mais vous devez savoir que le Walktest possède une option en ligne de commande pour exécuter des scritps au démarrage :

walktest –exec=’filename’

De cette façon, vous pouvez ajouter votre propre fichier de configuration sans modifier le fichier autoexec.cfg original. Dans le fichier de script, toutes les commandes du Walktest sont possibles.

Il y a beaucoup d'autres commandes pour le Walktest auxquelles vous pouvez vous essayer et pourquoi pas être impresionné. Vous pourrez les trouver dans le manuel.

Have fun!