khanat-opennel-code/code/tool/zviewer

 ====================
      ZVIEWER 
 ====================


ZVIEWER permet de visioner une ou plusieurs zones exportées depuis 3DSMax 
au format de NeL, en utilisant le moteur.


1. Le fichier zviewer.cfg
   -----------------------

Le répertoire d'où est exécuté le programme doit contenir le fichier ZVIEWER.CFG
qui contient les paramètres de configuration. Sans ce fichier aucune zone ne sera 
affichée.
Lorsqu'il n'y a pas de fichier de configuration à l'execution un fichier type est
généré.

Exemple de config :

FullScreen = 0;	
Width = 800;    
Height = 600; 
Depth = 32;	
Position = { 1088.9, -925.7, -1234.0 }; 
EyesHeight = 1.80;  
Background = { 100, 100, 255 }; 
ZFar = 1000.0;	               
LandscapeTileNear = 50.0;       
LandscapeThreshold = 0.001;    
BanksPath = "C:\WINDOWS\Bureau\zviewer\" ;
Bank = "fyros_landf.bank" ;
TilesPath = "C:\WINDOWS\Bureau\zviewer\tiles" ;
ZonesPath = "C:\WINDOWS\Bureau\zviewer\zones" ;
IgPath = "C:\WINDOWS\Bureau\zviewer\ig" ;
ShapePath = "C:\WINDOWS\Bureau\zviewer\shapes" ;
MapsPath = "C:\WINDOWS\Bureau\zviewer\maps" ;
Zones = { "3_AC.zonel","3_AD.zonel" }; 
Zonessave = { "3_AC.zonel","3_AD.zonel" }; 
Zones = { "3_AC.zonel","3_AD.zonel" }; 
Ig = { "3_AC.ig","3_AD.ig" }; 

Avec :

Fullscreen :
0 : windowed 
1 : fullscreen

Width :
largeur de la fenetre.

Height :
hauteur de la fenetre.

Depth :
nombre de couleurs (32bits,24bits,...).

Position :
position initiale (x,y,z). Correspond aux coordonnées dans Max (Generic Units).
La position est automatiquement snapée au sol quelque soit la coordonnée en z.

EyesHeight :
hauteur des yeux pour le mode Walk.

Background :
couleur rgb du fond.

ZFar :
distance de clipping. Plus la distance est grande, plus on voit loin.

LandscapeTileNear :
valeur du near. Plus cette valeur est grande, plus la zone du near est grande.

LandscapeThreshold :
seuil utilisé pour la subdivision adaptative. Quand la valeur augmente, la qualité
de la subdivision diminue (reduit le temps de calcul). Mis au minimum par defaut (0.001).

BanksPath :
chemin des banks (<bank>.bank et <bank>.farbank).

Bank :
nom de la bank (meme racine que la farbank)

ZonesPath :
chemin des zones.

Zones :
liste des noms des zones


2. Les déplacements
   ----------------

Les déplacements se font à l'aide de la combinaison clavier/souris. 
Il existe 2 modes de déplacement : FreeLook et Walk (defaut). 

- Le mode FreeLook permet de se déplacer dans la direction du regard(idem cstrike). 
- Dans le mode Walk le déplacement se fait au niveau du sol, à hauteur des yeux. 
  L'utilisateur reste collé au sol.

La souris permet d'orienter le regard dans toutes les directions
Le clavier permet de se déplacer.


3. Les touches
   -----------
ESC      : quitter le viewer
F1       : Afficher/Masquer les infos
F3       : basculer entre le mode plein et le mode fil de fer
F12      : faire un screenshot
ESPACE   : basculer entre les modes Walk et Free-Look
RETURN   : libérer ou capturer la souris
UP       : avancer
DOWN     : reculer
LEFT     : déplacement latéral à gauche
RIGHT    : déplacement latéral à droite
SHIFT    : augmenter l'altitude 
CTRL     : baisser d'altitude 
1        : 5 km/h
2        : 10 km/h
3        : 20 km/h
4        : 40 km/h
5        : 80 km/h
6        : 160 km/h
7        : 320 km/h
8        : 640 km/h
PAGEUP   : augmenter la distance de clipping
PAGEDOWN : diminuer la distance de clipping
HOME     : augmenter le near
END      : diminuer le near
INSERT   : augmenter le threshold
DELETE   : diminuer le threshold
ADD      : augmenter la hauteur des yeux
SUBTRACT : diminuer la hauteur des yeux

==================== ZVIEWER ENGLISH ====================
 
ZViewer allows you to view one or more zones exported from 3DSMax inside the NeL Engine


When you run ZViewer for the first time if no configuration file is located one will be created with default values.
The Configuration file defines the zones to load and other vital information and will not work in it's default state


Keys 

ESC: exit ZViewer
F1: toggles information
F3: toggles between full and the wire frame mode
F12: screenshot
SPACE: toggles between Walk and Free-Look mode
RETURN: release or capture mouse
UP: move forward
DOWN: move back
LEFT: turn left
RIGHT: turn right
SHIFT: increases altitude
CTRL: decreases altitude
1: 5 km/h
2: 10 km/h
3: 20 km/h
4: 40 km/h
5: 80 km/h
6: 160 km/h
7: 320 km/h
8: 640 km/h
PAGEUP: increases the clipping distance
PAGEDOWN: decreases the clipping distance
HOME: increases tilenear
END: decreases the tilenear
INSERT: increases threshold
DELETE: decreases threshold
ADD: increases the eye height
SUBTRACT: decreases the eye height