khanat-opennel-code/code/tool/zviewer/readme.txt

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


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


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

Le r<>pertoire d'o<> est ex<65>cut<75> le programme doit contenir le fichier ZVIEWER.CFG
qui contient les param<61>tres de configuration. Sans ce fichier aucune zone ne sera 
affich<EFBFBD>e.
Lorsqu'il n'y a pas de fichier de configuration <20> l'execution un fichier type est
g<EFBFBD>n<EFBFBD>r<EFBFBD>.

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<6E>es dans Max (Generic Units).
La position est automatiquement snap<61>e au sol quelque soit la coordonn<6E>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<69> pour la subdivision adaptative. Quand la valeur augmente, la qualit<69>
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 <20> 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, <20> hauteur des yeux. 
  L'utilisateur reste coll<6C> 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<69>rer ou capturer la souris
UP       : avancer
DOWN     : reculer
LEFT     : d<>placement lat<61>ral <20> gauche
RIGHT    : d<>placement lat<61>ral <20> 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