-----------------------------------------------------------------
 running the program
-----------------------------------------------------------------
When the program is compiled, you can run it like this:

  % p2 /afs/engin.umich.edu/class/perm/eecs487/models/simple/icosahedron-sub2.sm

On a Caen machine, you can create a symbolic link to the models
directory from your proj2 directory: cd to proj2 and do:

  % ln -s /afs/engin.umich.edu/class/perm/eecs487/models .

Otherwise you might want to copy the models directory to your
proj2 directory.

Then run it like:

  % p2 models/simple/icosahedron-sub2.sm

The above model is nearly a sphere, so is good for checking
environment maps and generally debugging shaders.

-----------------------------------------------------------------
 compiling: linux
-----------------------------------------------------------------
To compile:

On linux, define the following environment variables:

  JOT_ROOT=/path/to/your/jot/install
  ARCH=linux

(Use export for bash, setenv for tcsh and csh).

If you are using CAEN linux, the path to precompiled jot is:

  /afs/engin.umich.edu/class/perm/eecs487/jot

Then you should be able to build the project by typing 'make'.
(No need to edit the Makefile.)

-----------------------------------------------------------------
 compiling: windows
-----------------------------------------------------------------
On Windows, you have to compile using a DOS shell, but can
otherwise use cygwin for running p2 with command-line arguments.

If using the pre-compiled jot libraries on CAEN, ensure that
/afs/engin.umich.edu/class/perm/eecs487/ is accessible; do this
by mapping a networked drive:

Start menu --> My Computer --> Tools --> "Map Network Drive"

Choose a letter for the drive (e.g. Z:)
Enter the folder: \\afs\engin.umich.edu\class\perm\eecs487

Edit proj2/setup.bat according to the instructions (look for 'XXX').
You need to define VSYEAR, JOT_ROOT and the path to your proj2 directory.

Note slashes go backward:

set JOT_ROOT=z:\eecs487\jot
set VSYEAR=2005

(Use VSYEAR=2005 for Visual Studio 8, and VSYEAR=2003 for Visual Studio 7.)

Also edit the Makefile to define JOT_ROOT (in the WIN32 section).
Note slashes go forward in the Makefile:

JOT_ROOT = Z:/eecs487/jot

On your desktop, create a shortcut for launching a DOS shell with
environment variables set for compiling p2:

E.g., if your proj2 directory is H:\Private\proj2, 
the shortcut should have the following target:

  %SystemRoot%\system32\cmd.exe /k H:\Private\proj2\setup.bat

Give the shortcut a reasonable name, e.g.: 'proj2'

4. Double click the shortcut to start a DOS shell.
   In that shell, type "make" -- the project should compile!