CAVE OpenGL IGram Software Interface
Written by Todd Margolis on 11-1-99
Property of the Electronic Visualization Laboratory 
	at the University of Illinois of Chicago
Please do not distribute this software without the 
	express written approval of EVL
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Well, here is the whole sha-bang!

This is the whole application just so you can see how 
	I put it all together, but you won't need it all.

Here are the components that you will need to compile 
	into your program:

You will need to include the rgb_image class from 
	rgb_image.C and rgb_image.h

You will need to include the frame class from 
	frame.C and frame.h 
		(probably will be removed from a seperate class & 
			incorporated into rgb_image class)

You should include the my_wand class from 
	my_wand.C and my_wand.h It's not totally necessary 
	to use this class if you allready have a way of 
	dealing with wand input, but I'm giving it to you 
	just in case. If you don't want to use it, just 
	replace the stuff in mp_app.C's frame function with 
	your own code.

-----------------------------------------------------------------------------

OK, here's the scoop.

I'm using C++ and SNEW shared memory. 
	If you are not using SNEW or C++, then you will 
	have to convert it to the malloc method of doing 
	shared memory.

Put all the stuff in my frame_function in your 
	frame function. Copy the write_files function 
	into your program. Copy the move_cave function 
	into your program.

===================================================================================================

So, once inside your program, how do you use it?
	The left button cycles through diferent viewport 
		sizes.
	Hold down the middle button to start taking the 
		pictures.
	The right button scales the world smaller or 
		larger based on if the wand is pointed up 
		or down.
If you have allready attached your own functions to the 
	wand buttons, you may just want to change them to 
	keyboard input or combination wand button presses.

Well, that's the basic idea. If you have more questions 
	once you try to put it all together, please feel 
	free to call or email me anytime.

Todd Margolis
todd@evl.uic.edu
EVL - 312.996.3002
(art)n Laboratory - 312.432.1871