version 1.15, 2001/04/10 13:44:50 |
version 1.26, 2002/03/28 16:40:55 |
| |
| |
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://freetype.sourceforge.net/> | - 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) |
| - EAX 2 <URL:http://eax.creative.com/> (NeL Sound, Windows version) |
| |
STLPort need to be compiled. NeL is using the SGI iostreams and it require | 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. | 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 |
| |
- 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/> | |
| - Mesa 3.3 <URL:http://www.mesa3d.org/> (NeL 3D) |
| |
On some OpenGL implementations, you migth have some troubles, coming from | 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 | the <GL/glext.h> file, to get NeL to compile. This file could be missing |
| |
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 |
=========== | =========== |
| |
1. Windows compilation | 1. Windows 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 SP5 + Processor Pack for SP5. |
| |
| SP5 and Processor Pack for SP5 can be found at: |
| |
| <URL:http://msdn.microsoft.com/vstudio/downloads/ppack/download.asp> |
| |
| |
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, and you should carefully read these libraries | long compilation process, and you should carefully read these libraries |
| |
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 |
| |
| Requirements for Nel Misc: Direct Input 8 |
| |
| - Install the DirectX8 SDK, then create a subdirectory called |
| dx8 in mssdkdir/include/ and move all files from mssdkdir/include/ |
| to mssdkdir/include/dx8/. |
| |
| - Add mssdkdir/include to the "Include Files" category. |
| Add mssdkdir/lib to the "Library Files" category. |
| Make sure these appear before visual c++ includes, as an older |
| version of directX may be present in Visual C++ headers. |
| |
| Requirements for NeL Sound: OpenAL and EAX 2 |
| |
| - Add the include and library directories for OpenAL: |
| Add openaldir/win/ to the "Include Files" category. |
| Add openaldir/win/al/ to the "Include Files" category. |
| Add openaldir/win/openal32/release to the "Library Files" category. |
| Add openaldir/win/alut/release to the "Library Files" category. |
| (Please note the include directories are not located in |
| openaldir/include/ but in openaldir/win/ on the Windows platform) |
| |
| - Add the include and library directories for EAX: |
| Add eaxdir/include to the "Include Files" category. |
| Add eaxdir/libs to the "Library Files" category. |
| |
| - At runtime, you will need openal32.dll and eax.dll in your path. |
| |
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 |
| |
| |
| |
| |
% ./bootstrap | % ./bootstrap |
| |
% ./configure --with-stlport=<Path_to_the_stlport_headers_files> \ | % ./configure --with-stlport=<Path_to_the_stlport_install_directory> |
--with-python=<Path_to_the_python_headers_files> | |
% 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 : |
| |
| |
| |
% 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/> |
| |
| |