diff options
author | neodarz <neodarz@neodarz.net> | 2018-08-11 20:21:34 +0200 |
---|---|---|
committer | neodarz <neodarz@neodarz.net> | 2018-08-11 20:21:34 +0200 |
commit | 0ea5fc66924303d1bf73ba283a383e2aadee02f2 (patch) | |
tree | 2568e71a7ccc44ec23b8bb3f0ff97fb6bf2ed709 /cvs/cvsweb.cgi/code/nel/INSTALL?rev=1.27&content-type=text | |
download | nevrax-website-self-hostable-0ea5fc66924303d1bf73ba283a383e2aadee02f2.tar.xz nevrax-website-self-hostable-0ea5fc66924303d1bf73ba283a383e2aadee02f2.zip |
Initial commit
Diffstat (limited to '')
3 files changed, 732 insertions, 0 deletions
diff --git a/cvs/cvsweb.cgi/code/nel/INSTALL?rev=1.27&content-type=text/x-cvsweb-markup&hideattic=0&sortby=rev/index.html b/cvs/cvsweb.cgi/code/nel/INSTALL?rev=1.27&content-type=text/x-cvsweb-markup&hideattic=0&sortby=rev/index.html new file mode 100644 index 00000000..aa5cb60b --- /dev/null +++ b/cvs/cvsweb.cgi/code/nel/INSTALL?rev=1.27&content-type=text/x-cvsweb-markup&hideattic=0&sortby=rev/index.html @@ -0,0 +1,244 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML> +<HEAD><style> A { color:black }</style> +<!-- hennerik CVSweb $Revision: 1.93 $ --> +<TITLE>code/nel/INSTALL - view - 1.27</TITLE></HEAD> +<BODY BGCOLOR="#eeeeee"> +<table width="100%" border=0 cellspacing=0 cellpadding=1 bgcolor="#aaaaaa"><tr valign=bottom><td><a href="INSTALL?hideattic=0&sortby=rev"><IMG SRC="http://www.nevrax.org/inc/img/picto-up.gif" ALT="[BACK]" BORDER="0" WIDTH="14" HEIGHT="13"></a> <b>Return to <A HREF="INSTALL?hideattic=0&sortby=rev">INSTALL</A> + CVS log</b> <IMG SRC="http://www.nevrax.org/inc/img/picto-news.gif" ALT="[TXT]" BORDER="0" WIDTH="13" HEIGHT="15"></td><td align=right><IMG SRC="http://www.nevrax.org/inc/img/picto-dir.gif" ALT="[DIR]" BORDER="0" WIDTH="15" HEIGHT="13"> <b>Up to <a href="/cvs/cvsweb.cgi/?hideattic=0&sortby=rev">Nevrax</a> / <a href="/cvs/cvsweb.cgi/code/?hideattic=0&sortby=rev">code</a> / <a href="/cvs/cvsweb.cgi/code/nel/?hideattic=0&sortby=rev">nel</a></b></td></tr></table><HR noshade><table width="100%"><tr><td bgcolor="#ffffff">File: <a href="/cvs/cvsweb.cgi/?hideattic=0&sortby=rev">Nevrax</a> / <a href="/cvs/cvsweb.cgi/code/?hideattic=0&sortby=rev">code</a> / <a href="/cvs/cvsweb.cgi/code/nel/?hideattic=0&sortby=rev">nel</a> / <a href="/cvs/cvsweb.cgi/code/nel/INSTALL?hideattic=0&sortby=rev">INSTALL</a> (<A HREF="/cvs/cvsweb.cgi/~checkout~/code/nel/INSTALL?rev=1.27&hideattic=0&sortby=rev" target="cvs_checkout" onClick="window.open('/cvs/cvsweb.cgi/~checkout~/code/nel/INSTALL?rev=1.27','cvs_checkout','resizeable,scrollbars');"><b>download</b></A>)<BR> +Revision <B>1.27</B>, <i>Fri Mar 29 15:12:18 2002 UTC</i> (4 months ago) by <i>vizerie</i> +<BR>Branch: <b>MAIN</b> +<BR>Changes since <b>1.26: +5 -7 + lines</b><PRE> +CHANGE direct input install +</PRE> +</td></tr></table><HR noshade><PRE> +Requirements +============ + + The NeL library needs the following libraries : + + - STLPort 4.5 <URL:<A HREF="http://www.stlport.org/">http://www.stlport.org/</A>> (Mandatory) + - LibXML 2.4.13 <URL:<A HREF="http://www.xmlsoft.org/">http://www.xmlsoft.org/</A>> (Mandatory) + - FreeType 2 <URL:<A HREF="http://freetype.sourceforge.net/">http://freetype.sourceforge.net/</A>> (NeL 3D) + - OpenAL <URL:<A HREF="http://www.openal.org/">http://www.openal.org/</A>> (NeL Sound) + - Python 1.5 <URL:<A HREF="http://www.python.org/">http://www.python.org/</A>> (NeL AI) + - Direct Input 8 <URL:<A HREF="http://www.microsoft.com/directx">http://www.microsoft.com/directx</A>> (NeL MISC, Windows version) + - EAX 2 <URL:<A HREF="http://eax.creative.com/">http://eax.creative.com/</A>> (NeL Sound, 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 + softwares : + + - Autoconf <URL:<A HREF="http://www.gnu.org/software/autoconf/autoconf.html">http://www.gnu.org/software/autoconf/autoconf.html</A>> + - Automake <URL:<A HREF="http://www.gnu.org/software/automake/automake.html">http://www.gnu.org/software/automake/automake.html</A>> + - Libtool <URL:<A HREF="http://www.gnu.org/software/libtool/libtool.html">http://www.gnu.org/software/libtool/libtool.html</A>> + - Lex / Flex <URL:<A HREF="http://www.gnu.org/software/flex/flex.html">http://www.gnu.org/software/flex/flex.html</A>> + - Yacc / Bison <URL:<A HREF="http://www.gnu.org/software/bison/bison.html">http://www.gnu.org/software/bison/bison.html</A>> + + - Mesa 3.3 <URL:<A HREF="http://www.mesa3d.org/">http://www.mesa3d.org/</A>> (NeL 3D) + + 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:<A HREF="http://oss.sgi.com/projects/ogl-sample/ABI/glext.h">http://oss.sgi.com/projects/ogl-sample/ABI/glext.h</A>> + + 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:<A HREF="http://www.stack.nl/~dimitri/doxygen/">http://www.stack.nl/~dimitri/doxygen/</A>> + - Graphviz <URL:<A HREF="http://www.research.att.com/sw/tools/graphviz/">http://www.research.att.com/sw/tools/graphviz/</A>> + + 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 NeL will work with other (older or more recent) + versions of these softwares or libraries. You are welcome to help us + 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 +=========== + + 1. Windows compilation + ---------------------- + + 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:<A HREF="http://msdn.microsoft.com/vstudio/downloads/ppack/download.asp">http://msdn.microsoft.com/vstudio/downloads/ppack/download.asp</A>> + + + 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:<A HREF="http://ftpsearch.lycos.com/swadv/AdvResults.asp?query=gnumake-win32">http://ftpsearch.lycos.com/swadv/AdvResults.asp?query=gnumake-win32</A>> + + - 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 + is done in the [Tools -> Options -> Directories] menu : + + - 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.5/stlport + + - Add the STLPort library directory to the "Library Files" category. + ex: D:/stlport-4.5/lib + + - Add the FreeType include directory to the "Include Files" category. + ex: D:/freetype-2.0/include + + - Add the FreeType library directory to the "Library Files" category. + ex: D:/freetype-2.0/obj + + + Requirements for Nel Misc: Direct Input 8 + + - Install the DirectX8 SDK + - Add mssdk/include to the "Include Files" category. + Add mssdk/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]). + + Setup Visual C++ to find the NeL include and library files : + + - Add the NEL include directory to the "Include Files" category. + ex: D:/test/code/nel/include + + - 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 + + + 2. GNU/Linux compilation + ------------------------ + + 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_install_directory> + + % make + + The "configure" script must be call with the "--with-stlport". + The option "--with-stlport" allow to override the default STL headers + + It is possible to compile and install only the needed part of NeL. + So you may, by using --disable-<net|3d|pacs> and --enable-<sound|ai> : + + - 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 : + + % CXXFLAGS=-pipe ./configure --with-stlport=<STLPort_headers_path> + + To get the complete list of arguments of the "configure" script use the + following command : + + % ./configure --help + + +Installation +============ + + 1. Windows installation + ----------------------- + + Not done yet. + + + 2. GNU/Linux installation + -------------------------- + + % make install + + +Contact us +========== + + If you find any bugs use the Nevrax Bug Tracking System : + + <URL:<A HREF="http://www.nevrax.org/bugs/">http://www.nevrax.org/bugs/</A>> + + If you need any help contact us on the NeL mailing-list : + + <URL:<A HREF="http://www.nevrax.org/mail/">http://www.nevrax.org/mail/</A>> + + +</PRE>
\ No newline at end of file diff --git a/cvs/cvsweb.cgi/code/nel/INSTALL?rev=1.27&content-type=text/x-cvsweb-markup&sortby=author/index.html b/cvs/cvsweb.cgi/code/nel/INSTALL?rev=1.27&content-type=text/x-cvsweb-markup&sortby=author/index.html new file mode 100644 index 00000000..2e5dfb50 --- /dev/null +++ b/cvs/cvsweb.cgi/code/nel/INSTALL?rev=1.27&content-type=text/x-cvsweb-markup&sortby=author/index.html @@ -0,0 +1,244 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML> +<HEAD><style> A { color:black }</style> +<!-- hennerik CVSweb $Revision: 1.93 $ --> +<TITLE>code/nel/INSTALL - view - 1.27</TITLE></HEAD> +<BODY BGCOLOR="#eeeeee"> +<table width="100%" border=0 cellspacing=0 cellpadding=1 bgcolor="#aaaaaa"><tr valign=bottom><td><a href="INSTALL?sortby=author"><IMG SRC="http://www.nevrax.org/inc/img/picto-up.gif" ALT="[BACK]" BORDER="0" WIDTH="14" HEIGHT="13"></a> <b>Return to <A HREF="INSTALL?sortby=author">INSTALL</A> + CVS log</b> <IMG SRC="http://www.nevrax.org/inc/img/picto-news.gif" ALT="[TXT]" BORDER="0" WIDTH="13" HEIGHT="15"></td><td align=right><IMG SRC="http://www.nevrax.org/inc/img/picto-dir.gif" ALT="[DIR]" BORDER="0" WIDTH="15" HEIGHT="13"> <b>Up to <a href="/cvs/cvsweb.cgi/?sortby=author">Nevrax</a> / <a href="/cvs/cvsweb.cgi/code/?sortby=author">code</a> / <a href="/cvs/cvsweb.cgi/code/nel/?sortby=author">nel</a></b></td></tr></table><HR noshade><table width="100%"><tr><td bgcolor="#ffffff">File: <a href="/cvs/cvsweb.cgi/?sortby=author">Nevrax</a> / <a href="/cvs/cvsweb.cgi/code/?sortby=author">code</a> / <a href="/cvs/cvsweb.cgi/code/nel/?sortby=author">nel</a> / <a href="/cvs/cvsweb.cgi/code/nel/INSTALL?sortby=author">INSTALL</a> (<A HREF="/cvs/cvsweb.cgi/~checkout~/code/nel/INSTALL?rev=1.27&sortby=author" target="cvs_checkout" onClick="window.open('/cvs/cvsweb.cgi/~checkout~/code/nel/INSTALL?rev=1.27','cvs_checkout','resizeable,scrollbars');"><b>download</b></A>)<BR> +Revision <B>1.27</B>, <i>Fri Mar 29 15:12:18 2002 UTC</i> (3 months, 1 week ago) by <i>vizerie</i> +<BR>Branch: <b>MAIN</b> +<BR>Changes since <b>1.26: +5 -7 + lines</b><PRE> +CHANGE direct input install +</PRE> +</td></tr></table><HR noshade><PRE> +Requirements +============ + + The NeL library needs the following libraries : + + - STLPort 4.5 <URL:<A HREF="http://www.stlport.org/">http://www.stlport.org/</A>> (Mandatory) + - LibXML 2.4.13 <URL:<A HREF="http://www.xmlsoft.org/">http://www.xmlsoft.org/</A>> (Mandatory) + - FreeType 2 <URL:<A HREF="http://freetype.sourceforge.net/">http://freetype.sourceforge.net/</A>> (NeL 3D) + - OpenAL <URL:<A HREF="http://www.openal.org/">http://www.openal.org/</A>> (NeL Sound) + - Python 1.5 <URL:<A HREF="http://www.python.org/">http://www.python.org/</A>> (NeL AI) + - Direct Input 8 <URL:<A HREF="http://www.microsoft.com/directx">http://www.microsoft.com/directx</A>> (NeL MISC, Windows version) + - EAX 2 <URL:<A HREF="http://eax.creative.com/">http://eax.creative.com/</A>> (NeL Sound, 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 + softwares : + + - Autoconf <URL:<A HREF="http://www.gnu.org/software/autoconf/autoconf.html">http://www.gnu.org/software/autoconf/autoconf.html</A>> + - Automake <URL:<A HREF="http://www.gnu.org/software/automake/automake.html">http://www.gnu.org/software/automake/automake.html</A>> + - Libtool <URL:<A HREF="http://www.gnu.org/software/libtool/libtool.html">http://www.gnu.org/software/libtool/libtool.html</A>> + - Lex / Flex <URL:<A HREF="http://www.gnu.org/software/flex/flex.html">http://www.gnu.org/software/flex/flex.html</A>> + - Yacc / Bison <URL:<A HREF="http://www.gnu.org/software/bison/bison.html">http://www.gnu.org/software/bison/bison.html</A>> + + - Mesa 3.3 <URL:<A HREF="http://www.mesa3d.org/">http://www.mesa3d.org/</A>> (NeL 3D) + + 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:<A HREF="http://oss.sgi.com/projects/ogl-sample/ABI/glext.h">http://oss.sgi.com/projects/ogl-sample/ABI/glext.h</A>> + + 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:<A HREF="http://www.stack.nl/~dimitri/doxygen/">http://www.stack.nl/~dimitri/doxygen/</A>> + - Graphviz <URL:<A HREF="http://www.research.att.com/sw/tools/graphviz/">http://www.research.att.com/sw/tools/graphviz/</A>> + + 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 NeL will work with other (older or more recent) + versions of these softwares or libraries. You are welcome to help us + 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 +=========== + + 1. Windows compilation + ---------------------- + + 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:<A HREF="http://msdn.microsoft.com/vstudio/downloads/ppack/download.asp">http://msdn.microsoft.com/vstudio/downloads/ppack/download.asp</A>> + + + 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:<A HREF="http://ftpsearch.lycos.com/swadv/AdvResults.asp?query=gnumake-win32">http://ftpsearch.lycos.com/swadv/AdvResults.asp?query=gnumake-win32</A>> + + - 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 + is done in the [Tools -> Options -> Directories] menu : + + - 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.5/stlport + + - Add the STLPort library directory to the "Library Files" category. + ex: D:/stlport-4.5/lib + + - Add the FreeType include directory to the "Include Files" category. + ex: D:/freetype-2.0/include + + - Add the FreeType library directory to the "Library Files" category. + ex: D:/freetype-2.0/obj + + + Requirements for Nel Misc: Direct Input 8 + + - Install the DirectX8 SDK + - Add mssdk/include to the "Include Files" category. + Add mssdk/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]). + + Setup Visual C++ to find the NeL include and library files : + + - Add the NEL include directory to the "Include Files" category. + ex: D:/test/code/nel/include + + - 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 + + + 2. GNU/Linux compilation + ------------------------ + + 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_install_directory> + + % make + + The "configure" script must be call with the "--with-stlport". + The option "--with-stlport" allow to override the default STL headers + + It is possible to compile and install only the needed part of NeL. + So you may, by using --disable-<net|3d|pacs> and --enable-<sound|ai> : + + - 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 : + + % CXXFLAGS=-pipe ./configure --with-stlport=<STLPort_headers_path> + + To get the complete list of arguments of the "configure" script use the + following command : + + % ./configure --help + + +Installation +============ + + 1. Windows installation + ----------------------- + + Not done yet. + + + 2. GNU/Linux installation + -------------------------- + + % make install + + +Contact us +========== + + If you find any bugs use the Nevrax Bug Tracking System : + + <URL:<A HREF="http://www.nevrax.org/bugs/">http://www.nevrax.org/bugs/</A>> + + If you need any help contact us on the NeL mailing-list : + + <URL:<A HREF="http://www.nevrax.org/mail/">http://www.nevrax.org/mail/</A>> + + +</PRE>
\ No newline at end of file diff --git a/cvs/cvsweb.cgi/code/nel/INSTALL?rev=1.27&content-type=text/x-cvsweb-markup&sortby=date/index.html b/cvs/cvsweb.cgi/code/nel/INSTALL?rev=1.27&content-type=text/x-cvsweb-markup&sortby=date/index.html new file mode 100644 index 00000000..8d3b501f --- /dev/null +++ b/cvs/cvsweb.cgi/code/nel/INSTALL?rev=1.27&content-type=text/x-cvsweb-markup&sortby=date/index.html @@ -0,0 +1,244 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML> +<HEAD><style> A { color:black }</style> +<!-- hennerik CVSweb $Revision: 1.93 $ --> +<TITLE>code/nel/INSTALL - view - 1.27</TITLE></HEAD> +<BODY BGCOLOR="#eeeeee"> +<table width="100%" border=0 cellspacing=0 cellpadding=1 bgcolor="#aaaaaa"><tr valign=bottom><td><a href="INSTALL?sortby=date"><IMG SRC="http://www.nevrax.org/inc/img/picto-up.gif" ALT="[BACK]" BORDER="0" WIDTH="14" HEIGHT="13"></a> <b>Return to <A HREF="INSTALL?sortby=date">INSTALL</A> + CVS log</b> <IMG SRC="http://www.nevrax.org/inc/img/picto-news.gif" ALT="[TXT]" BORDER="0" WIDTH="13" HEIGHT="15"></td><td align=right><IMG SRC="http://www.nevrax.org/inc/img/picto-dir.gif" ALT="[DIR]" BORDER="0" WIDTH="15" HEIGHT="13"> <b>Up to <a href="/cvs/cvsweb.cgi/?sortby=date">Nevrax</a> / <a href="/cvs/cvsweb.cgi/code/?sortby=date">code</a> / <a href="/cvs/cvsweb.cgi/code/nel/?sortby=date">nel</a></b></td></tr></table><HR noshade><table width="100%"><tr><td bgcolor="#ffffff">File: <a href="/cvs/cvsweb.cgi/?sortby=date">Nevrax</a> / <a href="/cvs/cvsweb.cgi/code/?sortby=date">code</a> / <a href="/cvs/cvsweb.cgi/code/nel/?sortby=date">nel</a> / <a href="/cvs/cvsweb.cgi/code/nel/INSTALL?sortby=date">INSTALL</a> (<A HREF="/cvs/cvsweb.cgi/~checkout~/code/nel/INSTALL?rev=1.27&sortby=date" target="cvs_checkout" onClick="window.open('/cvs/cvsweb.cgi/~checkout~/code/nel/INSTALL?rev=1.27','cvs_checkout','resizeable,scrollbars');"><b>download</b></A>)<BR> +Revision <B>1.27</B>, <i>Fri Mar 29 15:12:18 2002 UTC</i> (3 months, 2 weeks ago) by <i>vizerie</i> +<BR>Branch: <b>MAIN</b> +<BR>Changes since <b>1.26: +5 -7 + lines</b><PRE> +CHANGE direct input install +</PRE> +</td></tr></table><HR noshade><PRE> +Requirements +============ + + The NeL library needs the following libraries : + + - STLPort 4.5 <URL:<A HREF="http://www.stlport.org/">http://www.stlport.org/</A>> (Mandatory) + - LibXML 2.4.13 <URL:<A HREF="http://www.xmlsoft.org/">http://www.xmlsoft.org/</A>> (Mandatory) + - FreeType 2 <URL:<A HREF="http://freetype.sourceforge.net/">http://freetype.sourceforge.net/</A>> (NeL 3D) + - OpenAL <URL:<A HREF="http://www.openal.org/">http://www.openal.org/</A>> (NeL Sound) + - Python 1.5 <URL:<A HREF="http://www.python.org/">http://www.python.org/</A>> (NeL AI) + - Direct Input 8 <URL:<A HREF="http://www.microsoft.com/directx">http://www.microsoft.com/directx</A>> (NeL MISC, Windows version) + - EAX 2 <URL:<A HREF="http://eax.creative.com/">http://eax.creative.com/</A>> (NeL Sound, 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 + softwares : + + - Autoconf <URL:<A HREF="http://www.gnu.org/software/autoconf/autoconf.html">http://www.gnu.org/software/autoconf/autoconf.html</A>> + - Automake <URL:<A HREF="http://www.gnu.org/software/automake/automake.html">http://www.gnu.org/software/automake/automake.html</A>> + - Libtool <URL:<A HREF="http://www.gnu.org/software/libtool/libtool.html">http://www.gnu.org/software/libtool/libtool.html</A>> + - Lex / Flex <URL:<A HREF="http://www.gnu.org/software/flex/flex.html">http://www.gnu.org/software/flex/flex.html</A>> + - Yacc / Bison <URL:<A HREF="http://www.gnu.org/software/bison/bison.html">http://www.gnu.org/software/bison/bison.html</A>> + + - Mesa 3.3 <URL:<A HREF="http://www.mesa3d.org/">http://www.mesa3d.org/</A>> (NeL 3D) + + 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:<A HREF="http://oss.sgi.com/projects/ogl-sample/ABI/glext.h">http://oss.sgi.com/projects/ogl-sample/ABI/glext.h</A>> + + 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:<A HREF="http://www.stack.nl/~dimitri/doxygen/">http://www.stack.nl/~dimitri/doxygen/</A>> + - Graphviz <URL:<A HREF="http://www.research.att.com/sw/tools/graphviz/">http://www.research.att.com/sw/tools/graphviz/</A>> + + 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 NeL will work with other (older or more recent) + versions of these softwares or libraries. You are welcome to help us + 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 +=========== + + 1. Windows compilation + ---------------------- + + 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:<A HREF="http://msdn.microsoft.com/vstudio/downloads/ppack/download.asp">http://msdn.microsoft.com/vstudio/downloads/ppack/download.asp</A>> + + + 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:<A HREF="http://ftpsearch.lycos.com/swadv/AdvResults.asp?query=gnumake-win32">http://ftpsearch.lycos.com/swadv/AdvResults.asp?query=gnumake-win32</A>> + + - 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 + is done in the [Tools -> Options -> Directories] menu : + + - 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.5/stlport + + - Add the STLPort library directory to the "Library Files" category. + ex: D:/stlport-4.5/lib + + - Add the FreeType include directory to the "Include Files" category. + ex: D:/freetype-2.0/include + + - Add the FreeType library directory to the "Library Files" category. + ex: D:/freetype-2.0/obj + + + Requirements for Nel Misc: Direct Input 8 + + - Install the DirectX8 SDK + - Add mssdk/include to the "Include Files" category. + Add mssdk/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]). + + Setup Visual C++ to find the NeL include and library files : + + - Add the NEL include directory to the "Include Files" category. + ex: D:/test/code/nel/include + + - 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 + + + 2. GNU/Linux compilation + ------------------------ + + 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_install_directory> + + % make + + The "configure" script must be call with the "--with-stlport". + The option "--with-stlport" allow to override the default STL headers + + It is possible to compile and install only the needed part of NeL. + So you may, by using --disable-<net|3d|pacs> and --enable-<sound|ai> : + + - 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 : + + % CXXFLAGS=-pipe ./configure --with-stlport=<STLPort_headers_path> + + To get the complete list of arguments of the "configure" script use the + following command : + + % ./configure --help + + +Installation +============ + + 1. Windows installation + ----------------------- + + Not done yet. + + + 2. GNU/Linux installation + -------------------------- + + % make install + + +Contact us +========== + + If you find any bugs use the Nevrax Bug Tracking System : + + <URL:<A HREF="http://www.nevrax.org/bugs/">http://www.nevrax.org/bugs/</A>> + + If you need any help contact us on the NeL mailing-list : + + <URL:<A HREF="http://www.nevrax.org/mail/">http://www.nevrax.org/mail/</A>> + + +</PRE>
\ No newline at end of file |