version 1.6, 2001/01/23 15:13:27 |
version 1.15, 2001/04/10 13:44:50 |
| |
The NeL library need the following libraries : | The NeL library need the following libraries : |
| |
- STLPort 4.0 <URL:http://www.stlport.org/> | - STLPort 4.0 <URL:http://www.stlport.org/> |
- FreeType 2 <URL:http://www.freetype.org/> | - FreeType 2 <URL:http://freetype.sourceforge.net/> |
- Python 1.5 <URL:http://www.python.org/> | - Python 1.5 <URL:http://www.python.org/> |
| |
| STLPort need to be compiled. NeL is using the SGI iostreams and it require |
| the STLPort compilation and a linking of NeL with the STLPort library. |
| |
On a GNU/Linux platform you will need the following libraries and | On a GNU/Linux platform you will need the following libraries and |
softwares : | softwares : |
| |
| |
- Yacc / Bison <URL:http://www.gnu.org/software/bison/bison.html> | - Yacc / Bison <URL:http://www.gnu.org/software/bison/bison.html> |
- Mesa 3.3 <URL:http://www.mesa3d.org/> | - Mesa 3.3 <URL:http://www.mesa3d.org/> |
| |
Some of the GNU/Linux distributions uses a "custom" version of Mesa which | On some OpenGL implementations, you migth have some troubles, coming from |
include the last SGI's version of the glext.h file, which is good :-). | the <GL/glext.h> file, to get NeL to compile. This file could be missing |
The other GNU/Linux distributions use a strict distribution of Mesa, | or not up to date. You will find the latest version of this file on SGI's |
which migth use an older version of that file. So if you encounter | website : |
some problems during the NeL compilation concerning the GL_GLEXT_VERSION, | |
you should download the last version of the glext.h on SGI's website : | - glext.h <URL:http://oss.sgi.com/projects/ogl-sample/ABI/glext.h> |
<URL:http://oss.sgi.com/projects/ogl-sample/ABI/glext.h>. | |
| Most of our documentation is done using Doxygen, so you might need it |
| to read our prose and our code documentation. If you want have nice |
| graphs like dependency graphs, collaboration diagrams, or graphical |
| class hierarchy graphs you will need Graphviz : |
| |
| - Doxygen <URL:http://www.stack.nl/~dimitri/doxygen/> |
| - Graphviz <URL:http://www.research.att.com/sw/tools/graphviz/> |
| |
Most of these softwares should be already installed on your system or | Most of these softwares should be already installed on your system or |
provided on your installation disk. | provided on your installation disk. |
| |
| |
The compilation on Windows has been done only with Visual C++ 6.0 SP4. | The compilation on Windows has been done only with Visual C++ 6.0 SP4. |
| |
| You first need to compile STLport and FreeType libraries. It's a quite |
| long compilation process, and you should carefully read these libraries |
| documentation (at least the README and INSTALL files) before compiling |
| and installing them. |
| |
| STLport Compilation : |
| |
| - Open a Dos window and go in the STLPort's src directory. |
| |
| - Rename or copy the "vc6-unicode.mak" to "Makefile". |
| |
| - Execute `nmake clean all` followed by `nmake install`. |
| |
| FreeType compilation, by using GNU Make : |
| |
| - You need to intall GNU make and to place it in the PATH. |
| |
| <URL:http://ftpsearch.lycos.com/swadv/AdvResults.asp?query=gnumake-win32> |
| |
| - Open a Dos window and go in the FreeType's directory. |
| |
| - Execute `make setup visualc' followed by `make`. |
| |
| FreeType compilation, by using an IDE : |
| |
| - Compile every (base and optionnal) library components listed |
| at the end of the FreeType's INSTALL file. |
| |
Set up Visual C++ to find the STLPort and FreeType libraries. This | Set up Visual C++ to find the STLPort and FreeType libraries. This |
is done in the [Tools -> Options -> Directories] menu : | is done in the [Tools -> Options -> Directories] menu : |
| |
- Add the STLPort include directory to the "Library Files" category. | - Add the STLPort include directory to the "Library Files" category. |
| The STLPort include *must* be inserted before the microsoft one or |
| the compiler will take microsoft STL instead of STLPort STL. |
| (use the arrow button to put the STLPort include at the top) |
ex: D:/stlport-4.0/stlport | ex: D:/stlport-4.0/stlport |
| |
- Add the STLPort library directory to the "Library Files" category. | - Add the STLPort library directory to the "Library Files" category. |
| |
2. GNU/Linux compilation | 2. GNU/Linux compilation |
------------------------ | ------------------------ |
| |
The compilation on GNU/Linux has been done only on RedHat 6.2 with | |
GCC 2.96. | |
| |
In the NeL directory do : | In the NeL directory do : |
| |
| In the case (ex: after a cvs checkout) that you need to rebuild the |
| "configure" script and/or the "Makefile.in" files, execute the |
| "bootstrap" script in the NeL directory : |
| |
| % ./bootstrap |
| |
% ./configure --with-stlport=<Path_to_the_stlport_headers_files> \ | % ./configure --with-stlport=<Path_to_the_stlport_headers_files> \ |
--with-python=<Path_to_the_python_headers_files> | --with-python=<Path_to_the_python_headers_files> |
% make | % make |
| |
following command : | following command : |
| |
% ./configure --help | % ./configure --help |
| |
In the case (ex: after a cvs checkout) that you need to rebuild the | |
"configure" script and/or the "Makefile.in" files, execute the | |
"bootstrap" script in the NeL directory : | |
| |
% ./bootstrap | |
| |
| |
Installation | Installation |