
  Shallow Water <-> Rigid Body Interaction
  ========================================

    by Christian Oberholzer & Stefan Lienhard


  Requirements
  ------------

    Even though Ogre3d supports OpenGL the water rendering module doesn't without
    some tuning inside it's source code. Because of this OpenGL has been disabled.
    To run the demos you therefore need DirectX. (At least the August 2008 version).
    If it doesn't run with some strange error missing some kind of d3dx_**.dll you
    have to install the newest version of DirectX.



  'Installation'
  --------------

    With unpacking installation has already been done. Executable files can be found
    inside the bin/vc1500/release/win32 subdirectory.


  
  'Uninstallation'
  ----------------

    You can just delete all the files. As far as I know Ogre3d doesn't pollute your
    system with whatever kind of trash. (Registry, etc.) It keeps its files inside
    the directory tree you give it.


  
  Configuration
  -------------

    The first time you run any of the executable files a configuration dialog will
    pop up where you can choose the desired settings (like resolution and so on...).
    These settings will be saved inside a file ogre.cfg. As long as this file exists
    the demonstration programs will not pop up the configuration dialog anymore. If you
    want to change your configuration, just delete the file and run the demonstration
    programs again.


  Executables
  -----------
    There are different executables provided with the package. They are
      - *_demo_*: demonstration programs. Those programs demonstrate the capabilities of this
                  project
      - *_test_*: test programs. The project has been tested using those programs. In many of those
                  tests rigid bodies are kept in a invisible cube bounded by 4 planes on the sides.
      - *_test_hydrax.exe: this is the offical test program of the hydrax water module.


  Keyboard shortcuts
  ------------------

    Keyboard and mouse settings are:
      - Mouse: Use it to orientate the camera in the Scene
      - W/A/S/D: use those keys to move the camera.
      - Q/ESQ: quits the demo.

    The Hydrax demonstration program (And it is just and only the one of the official 
    hydrax page uses one additional shortcut.
      - M toggles the skybox and the sun position. 