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.