¦¦¦¦¦¦¦+¦¦+      ¦¦¦¦¦¦+ ¦¦+  ¦¦+
¦¦+----+¦¦¦     ¦¦+---¦¦++¦¦+¦¦++    
¦¦¦¦¦+  ¦¦¦     ¦¦¦   ¦¦¦ +¦¦¦++      
¦¦+--+  ¦¦¦     ¦¦¦   ¦¦¦ ¦¦+¦¦+     
¦¦¦     ¦¦¦¦¦¦¦++¦¦¦¦¦¦++¦¦++ ¦¦+     
+-+     +------+ +-----+ +-+  +-+     

 ¦¦+   ¦¦+¦¦+¦¦¦¦¦¦¦+¦¦+    ¦¦+¦¦¦¦¦¦¦+¦¦¦¦¦¦+    
 ¦¦¦   ¦¦¦¦¦¦¦¦+----+¦¦¦    ¦¦¦¦¦+----+¦¦+--¦¦+    
 ¦¦¦   ¦¦¦¦¦¦¦¦¦¦¦+  ¦¦¦ ¦+ ¦¦¦¦¦¦¦¦+  ¦¦¦¦¦¦++   
 +¦¦+ ¦¦++¦¦¦¦¦+--+  ¦¦¦¦¦¦+¦¦¦¦¦+--+  ¦¦+--¦¦+    
 +¦¦¦¦++ ¦¦¦¦¦¦¦¦¦¦++¦¦¦+¦¦¦++¦¦¦¦¦¦¦+¦¦¦  ¦¦¦    
  +---+  +-++------+ +--++--+ +------++-+  +-+ 
  
v0.1, 11.05.2017


keyboard:
- [ESC]
- close application

- arrow keys
- move forward, backward, sideways

- [i]
- toggle through loaded objects

- [o]
- toggle through draw modes of selected object

- [k]
- toggle background between black and white

- [q] / [a]
- go up/down in z-axis

- [+] / [-]
- increase or decrease movement speed

- [m]
- create a screenshot of current view in out_dir

- [n]
- create a series of screenshots from tif_dir in out_dir
- see tif_dir command for more details

- [SPACE]
- show current position and angles in console

input file:

>>>> grid
- loads a grid (raster) in any GDAL compatible format and assigns a color for display
- syntax: 
- grid <grid_file> <red> <green> <blue> [add]
- the first grid in the text file is treated specially: it serves as a base for all other grids that can later be "added" to it
- the first grid cannot have the "add" switch enabled
- values for colors are from 0 to 255
- examples: 
- grid c:\proj\dtm.tif 255 255 0  #yellow grid
- grid c:\flox\proj\d_max.tif 0 128 255 add #the heights of this grid will be added to the first grid loaded in the file (e.g. a DTM). 


>>>> mesh
- loads a triangle mesh (.node .edge .ele are required) and assigns a color for display
- syntax: 
- mesh <mesh_name (no extension)> <red> <green> <blue> 
- values for colors are from 0 to 255
- examples: 
- grid c:\proj\mesh 255 255 255  #white mesh


>>>> vector
- loads a point or polyline shapefile in ESRI format (.shp)
- syntax :
- vector <shapefile.shp> <red> <green> <blue>
- values for colors are from 0 to 255
- examples: 
- vector c:\proj\breaklines.shp 255 0 0  #red lines


>>>> vector_field
- loads 3 grids and merges them to a vector field
- syntax:
- vector_field <grid_z> <grid_x> <grid_y> <stride> <red> <green> <blue>
- grid_x and grid_y contain the vector components in x and y direction as GDAL compativle grid (eg. .tif)
- grid_z gives the absolute height of each vector. As example you could use waterlevel.tif as z and velocity (u/v) as x and y
- stride sets the number of cells between each vector. Eg. stride == 10 leaves out 9 cells between 2 neighbouring vectors
- values for colors are from 0 to 255
- examples: 
- vector_field c:\flox\proj\observers\w\w__00001000.062012.tif c:\flox\proj\observers\u\u__00001000.062012.tif c:\flox\proj\observers\v\v__00001000.062012.tif 0 150 0  #green vector field of speed at time 1000.062


>>>> tif_dir
- used to create a series of screenshots using the grids in a directory
- only 1 tif_dir can be specified per file
- the process of creating screenshots unloads the last grid loaded and loads the first, second, third etc. grid of the tif_dir and creates a screenshot each
- the unloading is done so a grid (for example the first grid in the directory) can be used to create a preview for the series
- syntax:
- tif_dir <directory> <red> <green> <blue> [add]
- add works on the first grid loaded (eg. DTM)
- example:
- tif_dir c:\flox\proj\observers\observers\glob\w 12 12 240 #blue water surface for all grids in w
- to work both tif_dir and out_dir parameter have to be set


>>>> out_dir
- sets an output directory for screenshots
- syntax:
- out_dir <directory)
- example:
- out_dir c:\flox\screenshots


>>>> pos
- sets position of camera in the current coordinate system
- syntax:
- pos <x> <y> <z>
- example:
- pos 213422.33 645442.43 431.15


>>>> angles
- sets camera angles
- syntax:
- angles <heading> <pitch>
- example: 
- angles 180 25


>>>> tilesize
- number of grid rows an columns that will be displayed at any given time
- this is independent of cellsize
- syntax:
- tilesize 4000
- default value is 1000
- meshes, vector files and vector fields are not affected by this setting