
This is Linux Glide version 2.4

To use glide for linux you'll need a relatively current Linux
system. The libraries are in ELF format. They were developed on Red Hat
Linux 4.1, but should work with any current Linux release. You'll also
need a 3Dfx Voodoo based graphics card. It has been tested on the
Righteous 3D, Monster 3D, Obsidian 4220, and SLI Obsidian 4220.

Please read the license file LICENSE before installing this
software. Enclosed in this directory is a simple shell script which will
install the package into a specified directory. To use this install
script you must be root and run ./install. It will prompt you for the
destination directory and ask if you want to modify the system library
paths.

If you prefer to install the package by hand, you can unpack the tar
file dist.tar.gz. Inside you will find a bin, lib, include, and src
directory for Glide.

Test applications should be run from the src directory in the
distribution so that they find all of their texture map files. If you
are running your applications under X, be sure not to move the mouse
outside the window, or you will not be able to control the demo.

Assuming you install glide in the default location (/usr/local/glide)
then to compile an application with libGlide you'll need
	-I/usr/local/glide/include
on your compile lines, and
	-L/usr/local/glide/lib -lglide2x
on your link lines.

To run any glide application, Linux will need to find the glide shared
library. If you asked the install script to modify the system library
paths this should work automatically. If not, you'll need to modify your
LD_LIBRARY_PATH environment variable to indicate the location of
libglide. If glide is installed in the standard location shell users
would need to type
	export LD_LIBRARY_PATH=/usr/local/glide/lib
and csh users would need to type
	setenv LD_LIBRARY_PATH /usr/local/glide/lib

Finally, glide applications will need to run as root to access the
graphics card hardware. The application can also be made setuid root if
the library is set up correctly. See the notes about setuid below.

There is still a significant amount of optimization to be done on these
drivers. Keep an eye out on the 3dfx web site for updates.

This library is unsupported. Questions can be posted to 3Dfx's news
server on the 3dfx.glide newsgroup. 


						Enjoy!




Notes about setuid:

If you want to make your application setuid for release there's a few
things you should know.

	First, the library gains its access to the board the first time
the board is called. So you can release your root privledges after the
first call to grGlideInit(). It is generally a bad idea to run
applications as root any longer than is absolutely necessary.

	Second, if the libraries are installed in a standard place and
the system library path is updated, libglide will be found
automatically.

	Third, LD_LIBRARY_PATH is ignored for setuid programs. You'll
need to specify -Xlinker -rpath /usr/local/glide if the system library
path has not been updated.

Known Bugs:

	Does not work with the Voodoo Rush.

	Will crash badly if multiple Glide applications are run at once.

