This directory contains the executable as well as all files necessary
to run this program (in sub-directories).  


RUNNING THE DEMO:
------------------

The executable takes one (optional) command-line parameter, the scene file
to load and display.  Since only one scene has been included in this demo,
that scene is automatically loaded.



THINGS TO KNOW ABOUT THE DEMO:
-------------------------------

The default resolution for the demo is 1024 x 1024.  This is specified in
the scene file (boxScene.txt in the "scenes" directroy).  This may be changed
simply by changing the values in the file, and the demo should handle this
"reasonably" gracefully.  

We developed at 1024 x 1024 and some values, such as the low-resolution fog 
image are hard coded.  Changing the resolution to very large images, 
especially widescreen ones (i.e., 1920x1200) will thus introduce some jaggies
into the fog volume.  Images smaller than 1024 X 1024 and larger square images 
should have reasonably good quality, however.  (We've generated pretty good
looking images as high as 4096 x 4096 for publication with this code base.)



ISSUES RUNNING THE DEMO (AKA TROUBLESHOOTING):
-----------------------------------------------

To run this demo program, you need:
  1) GLUT (a .dll is included in this directory)
  2) GLEW (a .dll is included in this directory)
  3) A DirectX 10-class GPU that supports the EXT_geometry_shader4 extension.
  4) (Possibly) an nVidia card.  I have not had the opportunity to test
     this on an ATI card, though I do not use any nVidia-specific features.  

You do _not_ need Windows Vista, since we are using OpenGL to access 
DirectX 10 features.  Theoretically, you can recompile this to run on Linux
(I have done so with this framework before).  However, it's probably more
trouble that it's worth for you to simply run a demo.

Please note, if you already have GLUT or GLEW in your path, the .dlls
in the current directory may conflict (i.e., be different versions than)
those elsewhere in your path, giving .dll errors during execution.
These can be eliminated by:
 (a) deleting the .dlls from the current directory (so there is only one copy)
 (b) updating your other .dlls to at least GLUT 3.7.6 and GLEW 1.4.0 (what I 
     used to compile the executable)
     
As a side note, my nVidia drivers were version 175.19.  If you have problems
on nVidia hardware, please upgrade to that driver or later.

If the program exits rather unceremoniously, it probably detected some missing
functionality from your graphics card.  (Run the program from a command line,
as it prints error messages about any missing capabilities.)

Other questions can be directed to me at: cwyman (at) cs.uiowa.edu


-Chris