Installation
************

This file documents the installation of the GNU 3DKit.  Copyright (C) 1999-2001
Philippe C.D. Robert  You may copy, distribute, and modify it freely as long as
you preserve this copyright notice and permission notice.

This package contains the core GNU 3DKit libraries. You may need to install 
other packages in order to use them, mainly GNUstep and OpenGL.  Other 
documentation is available on-line at http://www.3dkit.org/

Installing GNU 3DKit
====================

Here is a quick-and-dirty example of installation commands:

	cd 3DKit/
	make
	make install

*or*

        open the PC.projects in GeometryKit and RenderKit from ProjectCenter.app
        and hit the 'make install' button, that's it.

Before doing so, be aware to follow the instructions below:

  1. Install `gcc'.  The library requires gcc version 2.8.0 or later.

  2. Install GNUstep. GNUstep can be found at 'http://www.gnustep.org'

  3. Install Mesa (or any OpenGL 1.2 compliant library), if needed. 
	Mesa can be found at 'http://www.mesa3d.org'

Tips for 3Dfx users
===================

When using a 3Dfx VooDoo card together with Mesa, you might add the flag 

	-DXMESA

to the GNUmakefile.preamble in the RenderKit directory. This could result in
useful speed improvements, when Mesa is compiled with Glide support. Also,
don't forget to setthe environment variable MESA_GLX_FX to fullscreen, if
possible.  

