GLUT for BeOS
-------------

INTRODUCTION:

This is a port of GLUT, the OpenGL Utility Toolkit library written by Mark
Kilgard.  Features of this release:

* All GLUT calls implemented as fully as possible.
* Subwindows implemented as child BGLViews.
* Popup menus work.
* Should be fully threadsafe (callbacks called in the correct order)
* Nearly all tests pass.
* Nearly all demos work reasonably.
* Supports custom mouse cursors (the "bdftobcursor" program I wrote to
	generate the cursors from the original X sources will be available
	as a separate archive called "FunWithCursors.zip").
* Includes full source (much of which was written from scratch in C++
	specifically for BeOS).

For more information on GLUT, visit the web site:

	http://reality.sgi.com/mjk_asd/glut3/glut3.html

LIMITATIONS:

* GLUT is not intended for writing programs with complex user interfaces.
By its "least common denominator" nature, GLUT programs do not have access
to Be features such as Be controls (buttons, pulldown menus, etc.) or a
multithreaded user interface.  For large projects, the BGLView class is
highly recommended.

* BGLView doesn't support single buffered windows.  For some programs, it's
sufficient to fake it by simply swapping buffers after the display callback
finishes, and this is what GLUT does.

KNOWN BUGS:

* Resizing a window rapidly may cause OpenGL to crash.
* Some of the mouse cursors look funny.  This is a bug in the program I used to
	convert them.
* Some of the demos fail because of limitations in our OpenGL implementation.
	For these demos, the source is included, but not the binaries.

If you find any other bugs, please mail them to jehamby@be.com.

USAGE:

Run the setup.sh shell script to copy the libraries and the new glut.h
header file to your ~/config/lib directory.  It will then run the ideas 
demo to verify that everything is working correctly.

Look in the progs folder for lots of interesting demo programs.

NOTES:

* The GLUT_ACTIVE_ALT modifier key is mapped to the Option key (or
	the right Control key on a BeBox keyboard).  The real Command/Alt
	key is swallowed by the BWindow.

* For those of you with one button mice, remember that to activate the
	"middle" mouse button, hold down control and option while pressing
	the mouse button.  For the "right" mouse button, hold down control
	and command.  Many GLUT programs bind a popup menu to the right
	mouse button, so be sure to try that if a program doesn't have any
	obvious controls.

BUILDING FROM SOURCE:

I built GLUT using a Codewarrior project file.  I built the other programs
using the Makefiles.

VERSION HISTORY:

1.0  (97/10/14)  First solid port.  Implements all GLUT calls as fully as
	possible.  Passes nearly all tests.
