version 1.1, 2000/11/24 14:05:12 |
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/> |
| |
| 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 |
| softwares : |
| |
| - Autoconf <URL:http://www.gnu.org/software/autoconf/autoconf.html> |
| - Automake <URL:http://www.gnu.org/software/automake/automake.html> |
| - Libtool <URL:http://www.gnu.org/software/libtool/libtool.html> |
| - Lex / Flex <URL:http://www.gnu.org/software/flex/flex.html> |
| - Yacc / Bison <URL:http://www.gnu.org/software/bison/bison.html> |
| - Mesa 3.3 <URL:http://www.mesa3d.org/> |
| |
| On some OpenGL implementations, you migth have some troubles, coming from |
| the <GL/glext.h> file, to get NeL to compile. This file could be missing |
| or not up to date. You will find the latest version of this file on SGI's |
| website : |
| |
| - 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 |
| provided on your installation disk. |
| |
| The given sofware or library version numbers are the ones that we are |
| using. We don't know if it working with other (older or more recent) |
| versions of these softwares or libraries. You are welcome to help us |
| to define more precisely these informations ;-) |
| |
| |
Compilation | Compilation |
| |
| |
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 : |
| |
% ./configure --with-stlport=<Path_to_the_stlport_headers_files> | 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> \ |
| --with-python=<Path_to_the_python_headers_files> |
% make | % make |
| |
The "configure" script must be call with the "--with-stlport" option. | The "configure" script must be call with the "--with-stlport" and |
This option permit to override the default STL headers. | "--with-python" options. |
| The option "--with-stlport" allow to override the default STL headers |
| and the option "--with-python" tell to the configuration script, where |
| to find the Python headers files. |
| |
You migth need to specify the FreeType 2 installation prefix by using | You migth need to specify the FreeType 2 installation prefix by using |
the "--with-freetype" argument (ex: "/usr/local" will look for the | the "--with-freetype" argument (ex: "/usr/local" will look for the |
| |
following command : | following command : |
| |
% ./configure --help | % ./configure --help |
| |
In the case 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 |