version 1.3, 2001/01/10 16:24:38 |
version 1.10, 2001/02/19 16:27:32 |
| |
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/> |
| |
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 : |
| |
- Libtool <URL:http://www.gnu.org/software/libtool/libtool.html> | - Libtool <URL:http://www.gnu.org/software/libtool/libtool.html> |
- Lex / Flex <URL:http://www.gnu.org/software/flex/flex.html> | - Lex / Flex <URL:http://www.gnu.org/software/flex/flex.html> |
- Yacc / Bison <URL:http://www.gnu.org/software/bison/bison.html> | - Yacc / Bison <URL:http://www.gnu.org/software/bison/bison.html> |
- Python <URL:http://www.python.org/> | - Mesa 3.3 <URL:http://www.mesa3d.org/> |
- Mesa <URL:http://www.mesa3d.org/> | |
| Some of the GNU/Linux distributions uses a "custom" version of Mesa which |
| include the last SGI's version of the glext.h file, which is good :-). |
| The other GNU/Linux distributions use a strict distribution of Mesa, |
| which migth use an older version of that file. So if you encounter |
| 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 : |
| <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 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. |
| |
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. |
| |
| |
In the NeL directory do : | In the NeL directory do : |
| |
% ./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> |
% 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 |
| |
| |
% ./configure --help | % ./configure --help |
| |
In the case that you need to rebuild the "configure" script and/or the | In the case (ex: after a cvs checkout) that you need to rebuild the |
"Makefile.in" files, execute the "bootstrap" script in the NeL | "configure" script and/or the "Makefile.in" files, execute the |
directory : | "bootstrap" script in the NeL directory : |
| |
% ./bootstrap | % ./bootstrap |
| |