README file for the "CubeIt" example programs

* Document written 10/22/2007 by Mike Gleicher

The "CubeIt" example programs (and their supporting files) are meant
to serve as an example of how to create interactive OpenGL programs
using FlTk. They illustrate some basic user interfaces that you might
try out, and provide some example code that you might find useful.

What's Here:
* RunButton.H / RunButton.cpp - a utility for dealing with FlTk idle
  callbacks. This provides a nice encapsulation, uniform timing, and a
  controllable time slider. ''We recommend using this in your own
  programs.''
* GlUtilities.H / GlUtilities.cpp - a bunch of little utility routines
  that you might find useful. ''We recommend using this in your own
  programs.'' The big pieces are: 
  - code for handling shadows (which is tricky since it uses blending
    and stencil buffers to make things look nice)
  - code for the "mousepole" user interface (which is a little tricky
    since it involves some geometry)
  - some really trivial drawing code 
  - some data structures used in other things
* ArcBallCam.cpp / ArcBallCam.H - a Camera control class that you can
  add into an FlTk OpenGL window that will use the right mouse button
  to control the camera. This isn't the best interface, but its easy
  to put into your program. ''We recommend using this in your own
  programs.''
* CubeIt.H / CubeIt.cpp - some rather simple things that all of the
  different demo programs need. 

* CubeIt0.cpp - a very simple program that fullfills the requirements
  for the Project 2 Checkpoint. It uses sliders to provide the user
  interface. 
* CubeIt1.cpp - a variant of CubeIt0 that uses the arc ball for camera
  controls. (it leaves out the animation object)
* CubeIt2.cpp - a variant of CubeIt1 that uses the mouse pole
  interface

Remember:
* If you use example code in your CS559 project, give proper
  attribution