TrackView GL v1.0.0
===================================
March 2004, Oliver Pieper (pieper@viaregio.de)

<see history.txt for progress log>

Keyboard:
----------------------
*** Camera:
Ctrl+0, Ctrl+1 to Ctrl+5
  Save up to six camera settings for each track. On track load, TVGL will
  try to restore position 0 if, available.
0, 1 to 5
  Restore up to six previously saved camera settings for each track. Setting
  0 will also be restored on track load, if available.
9 toggles map view. Camera is restrained to look straight down.
Ctrl+9
  reset map view
*** Display
'b' toggles display of ground boxes (hardly any impact on frame rate)
'w' toggles display of water level (hardly any impact on frame rate)
'c' toggles display of checkpoints (uses custom BIN model TVGLCHK.BIN)
'o' toggles display of objects (press twice to display invisible objects, too).
's' toggles area shape between round and square
'd' toggles display of backdrop
*** Backdrop
Alt+(Num+), Alt+(Num-) moves backdrop and sky up/down

Camera movement:
----------------
- left click and move mouse to rotate camera
- right click and move mouse to move camera horizontally
- left+right click and move mouse up/down to raise/lower camera
- middle click (where available) and move mouse up/down to zoom in/out
  (changes FoV).
- Ctrl + 'f' toggles follow terrain mode
(Pressing Shift will speed up camera movement, 
 Alt will slow it down for higher precision, 
 Ctrl will restrict camera rotation to whole numbers (jerky...))

Trackshot:
----------
Ctrl + 'j' prompts to save current image (see preferences for options)
  
Command line parameters
-----------------------
"<path to pod file>"  -- load this POD file on startup
-w<width>  -- set view width
-h<height>  -- set view height

The order of the command line parameters is not important. All parameters are
independent of each other and all parameters are optional.

Examples:
1. Open crazy98.pod with default view size:
  TrackViewGL "c:\program files\mtm2\crazy98.pod"
2. Open crazy98.pod with a view size of 640 x 480 pixels
  TrackViewGL "c:\program files\mtm2\crazy98.pod" -w640 -h480
3. as above, but different order of parameters
  TrackViewGL -h640 "c:\program files\mtm2\crazy98.pod" -w480
4.do not auto-load track, but set view width to 640 pixels
  TrackViewGL -w640

Tip.  Hold shift and right click a pod file to bring up the 'open with' box.
      Browse to TrackViewGL.exe and open.  Next time you right click a pod,
      Open Using Trackview 'should' already be an option.

Known Issues/To do:
-------------------
Critical:
High priority or easy to fix:
- currently none
Low priority:
- better/more forgiving error handling
- Use higher precision for camera position when turning billboard objects.
- Some billboard objects (trees in C98, for example) suddenly flip direction
  at a certain viewing angle.
- Lleap.pod crashes. Why? No idea!
- going to map view from follow terrain mode interferes with altitude
- save position in map view mode causes unpredictable altitude results
Needs investigating/cannot be avoided/won't fix (yet):
- Menu shows German keyboard shortcuts (Strg instead of Ctrl).
- Crash on LLEAP.POD (Lover's Leap).
  [Strange one, may be dealing with nasty memory leak/overwrite issue here :-( ]
- Crash on Exit
  [Cannot reproduce. Probably NVidia/OpenGL issue. Still no idea.]
  [Note. This can happen with other programs, even Internet Explorer]
- 2003-10-11 Phin: Screenshots larger than screen don't work well
  [Not really a bug. Cannot be avoided with the current screenshot method]
- 2003-10-09 Phin: "You Can Jump But Not Hide" by Scoby, wonky color palette in the backdrop
  [Wrong palette in POD. Looks same in MTM if first in POD.INI]
- 2003-10-08 Phin: crash on initial pod open (several PODs)
  [Cannot reproduce]
- 2003-10-06 Phin: St Louis MJ (from the '03 page) has a transparency thingie
  [abuse of a BIN model as stadium screws my depth sorting for transparent objects,
   and I'm happy to announce that MTM2 has the same problem with the track.]
- Some more exotic "features" (or bugs) of the MTM graphics engine are not
  implemented (transparent ground box tops when ground box bottom below water
  level, wrong terrain texture for rare constellations of ground box and terrain,
  terrain transparent at level 0).
- two minute easter egg on about screen.

Requests/Ideas:
---------------
- 2003-10-09 Phin: Return to starting position key.
- 2003-10-09 Phin: User control to return to the same location from one track to the next.
- Old: True OpenGL lighting with adjustable light(s)
- Old: camera movement with keyboard
- Old: Support for EVO(2), CPR, ...

