version 1.9, 2001/02/16 09:29:04 |
version 1.24, 2002/03/28 13:08:45 |
| |
| |
If you find any bugs use the Nevrax Bug Tracking System : | |
| |
<URL:/bugs/> | |
| |
If you need any help contact us on the NeL mailing-list : | |
| |
<URL:/mail/> | |
| |
| |
Requirements | Requirements |
============ | ============ |
| |
The NeL library need the following libraries : | The NeL library needs the following libraries : |
| |
- STLPort 4.0 <URL:http://www.stlport.org/> | - STLPort 4.5 <URL:http://www.stlport.org/> (Mandatory) |
- FreeType 2 <URL:http://www.freetype.org/> | - LibXML 2.4.13 <URL:http://www.xmlsoft.org/> (Mandatory) |
- Python 1.5 <URL:http://www.python.org/> | - FreeType 2 <URL:http://freetype.sourceforge.net/> (NeL 3D) |
| - OpenAL <URL:http://www.openal.org/> (NeL Sound) |
| - Python 1.5 <URL:http://www.python.org/> (NeL AI) |
| - Direct Input 8 <URL:http://www.microsoft.com/directx> (NeL MISC, Windows version) |
| |
| STLPort needs 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 : |
| |
- 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> |
- Mesa 3.3 <URL:http://www.mesa3d.org/> | |
| |
Some of the GNU/Linux distributions uses a "custom" version of Mesa which | - Mesa 3.3 <URL:http://www.mesa3d.org/> (NeL 3D) |
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, | On some OpenGL implementations, you migth have some troubles, coming from |
which migth use an older version of that file. So if you encounter | the <GL/glext.h> file, to get NeL to compile. This file could be missing |
some problems during the NeL compilation concerning the GL_GLEXT_VERSION, | or not up to date. You will find the latest version of this file on SGI's |
you should download the last version of the glext.h on SGI's website : | website : |
<URL:http://oss.sgi.com/projects/ogl-sample/ABI/glext.h>. | |
| - 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 | 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 | to read our prose and our code documentation. If you want have nice |
| |
provided on your installation disk. | provided on your installation disk. |
| |
The given sofware or library version numbers are the ones that we are | 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) | using. We don't know if NeL will work with other (older or more recent) |
versions of these softwares or libraries. You are welcome to help us | versions of these softwares or libraries. You are welcome to help us |
to define more precisely these informations ;-) | to define more precisely these informations ;-) |
| |
| For windows users, note that you don't need to have the Direct Input (verion 8) dll |
| on your system for NeL to run, but in this case, there will be no joystick support, and |
| no low level access to keyboard and mouse. Anyway, you need dinput.lib to compile |
| |
| |
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 | You first need to compile STLport and FreeType libraries. It's a quite |
long compilation process. | 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 : |
| |
The STLPort include *must* be inserted before the microsoft one or | The STLPort include *must* be inserted before the microsoft one or |
the compiler will take microsoft STL instead of STLPort STL. | the compiler will take microsoft STL instead of STLPort STL. |
(use the arrow button to put the STLPort include at the top) | (use the arrow button to put the STLPort include at the top) |
ex: D:/stlport-4.0/stlport | ex: D:/stlport-4.5/stlport |
| |
- Add the STLPort library directory to the "Library Files" category. | - Add the STLPort library directory to the "Library Files" category. |
ex: D:/stlport-4.0/lib | ex: D:/stlport-4.5/lib |
| |
- Add the FreeType include directory to the "Include Files" category. | - Add the FreeType include directory to the "Include Files" category. |
ex: D:/freetype-2.0/include | ex: D:/freetype-2.0/include |
| |
- Add the FreeType library directory to the "Library Files" category. | - Add the FreeType library directory to the "Library Files" category. |
ex: D:/freetype-2.0/obj | ex: D:/freetype-2.0/obj |
| |
| - For DirectX8 : install the SDK, then setup your directories as follow : |
| mssdkdir/include/dx8/ |
| mssdkdir/lib |
| Add mssdkdir/include to the "Include Files" category. |
| Add mssdkdir/lib to the "Library Files" category. |
| Make sure these appear before visual includes, as an older version of directX |
| may be present in Visual C++ headers. |
| |
| |
Open the workspace file "nel.dsw" (in the menu [File -> Workspace]). | Open the workspace file "nel.dsw" (in the menu [File -> Workspace]). |
| |
Setup Visual C++ to find the NeL include and library files : | Setup Visual C++ to find the NeL include and library files : |
| |
- Add the NEL include directory to the "Library Files" category. | - Add the NEL include directory to the "Include Files" category. |
ex: D:/test/code/nel/include | ex: D:/test/code/nel/include |
| |
- Add the STLPort library directory to the "Library Files" category. | - Add the NEL source directory to the "Include Files" category. |
| ex: D:/test/code/nel/src |
| |
| - Add the NeL library directory to the "Library Files" category. |
ex: D:/test/code/nel/lib | ex: D:/test/code/nel/lib |
| |
| |
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 |
--with-python=<Path_to_the_python_headers_files> | "configure" script and/or the "Makefile.in" files, execute the |
| "bootstrap" script in the NeL directory : |
| |
| % ./bootstrap |
| |
| % ./configure --with-stlport=<Path_to_the_stlport_install_directory> |
| |
% make | % make |
| |
The "configure" script must be call with the "--with-stlport" and | The "configure" script must be call with the "--with-stlport". |
"--with-python" options. | |
The option "--with-stlport" allow to override the default STL headers | 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 | It is possible to compile and install only the needed part of NeL. |
the "--with-freetype" argument (ex: "/usr/local" will look for the | So you may, by using --disable-<net|3d|pacs> and --enable-<sound|ai> : |
header files in "/usr/local/include" and the library files in the | |
"/usr/local/lid/ directory). | - misc |
| default: Mandatory |
| - net |
| default: Enables |
| desativate with: --disable-net |
| - 3d |
| default: Enable |
| desativate with: --disable-3d |
| - pacs |
| default: Enable |
| desativate with: --disable-pacs |
| - sound |
| default: Disable |
| ativate with: --enable-sound |
| - ai |
| default: Disable |
| ativate with: --enable-ai |
| |
To pass additional arguments to the C++ compiler, use the command line : | To pass additional arguments to the C++ compiler, use the command line : |
| |
| |
| |
% ./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 |
============ | ============ |
| |
| |
% make install | % make install |
| |
| |
| Contact us |
| ========== |
| |
| If you find any bugs use the Nevrax Bug Tracking System : |
| |
| <URL:/bugs/> |
| |
| If you need any help contact us on the NeL mailing-list : |
| |
| <URL:/mail/> |
| |
| |