This is an executable & source distribution of a reflection model
(BRDF) viewer written by some students in my global illumination course
and me.
See http://www.cs.cmu.edu/afs/cs/project/classes-ph/860.96/pub/www/860.html
for info on the course.

The program is written in C++ using OpenGL for 3-D graphics and Xforms
and Xwindows for user interface.  We run it on SGI's, but it could
probably run on anything capable of running X and OpenGL.

It's in an unfinished state, so caveat emptor.

Please Let me know if you have comments, find bugs, use it a lot,
or make enhancements!

===== HOW TO GET PROGRAM

You can get it from the World Wide Web at
    http://www.cs.cmu.edu/~ph/src/illum/
if you can run IRIX 5.3 executables, then get the files
    brdfview.gz		- IRIX 5.3 executable (runs on SGI's)
    libforms.so.gz	- shared SGI object file for xforms library
			    that is dynamically linked when brdfview is run
    DISTRIB		- this file, says how to get program & how to compile
    README		- how to run program, guide to source code
don't forget to uncompress with
    gunzip *.gz

if you can't run IRIX 5.3 executables, then the source code is available
in the same dir
    illum.tar.gz	- brdf modules & viewer
    svl.tar.gz		- "simple" vector library by Andrew Willmott
			    we use the Vec3 class from here
to unpack a .tar.gz file, run
    gunzip <whatever.tar.gz | tar xvf -

If you don't have web access, then use anonymous FTP instead
    ftp ftp.cs.cmu.edu
    cd /afs/cs/user/ph/www/src/illum

===== HOW TO COMPILE PROGRAM

If brdfview won't run and you need to recompile our source code, you'll also
need the xforms library, which is available at
    http://bragg.phys.uwm.edu/xforms
It should be version 0.81 (check the forms.h that comes with the distribution).

Then:
    make xforms (the two files you need most are forms.h and libforms.so)
    make svl (the files you need are the include files and libVLd.a,
	the "double" version of the library.
	You'll need to modify the Makefile to set DEST appropriately.
    make brdfview in the illum dir
	You'll need to modify the Makefile to set IPATH & LIBS appropriately.

===== HOW TO RUN PROGRAM

see README

===== SEE ALSO

http://www-graphics.stanford.edu/~smr/brdf/bv/
for Szymon Rusinkiewicz's BRDF viewer

Paul Heckbert   9 Nov 1996, 23 June 1997
ph@cs.cmu.edu
