COMPILING

   1 Scorched 3D - http://www.scorched3d.co.uk\r
   2 \r
   3 Overview\r
   4 --------\r
   5 \r
   6 Scorched3D supports multiple platforms : Win32, Linux, OSX and Solaris.\r
   7 Each platform requires different libraries and compilers.  The\r
   8 following sections outline a brief guide to compiling.\r
   9 \r
  10 If any errors are encountered please see the FAQ and Forums at\r
  11 http://www.scorched3d.co.uk\r
  12 \r
  13 \r
  14 Windows (Win32)\r
  15 ---------------\r
  16 \r
  17 Compilation of Scorched3D is supported on windows via the \r
  18 Microsoft Visual Studio .NET compiler :- \r
  19  http://www.microsoft.com/visualc\r
  20 and the free borland compiler :-\r
  21  http://www.borland.com/products/downloads/download_cbuilder.html.\r
  22 \r
  23 To compile using Visual Studio .NET compiler :- \r
  24 1) Load the scorched.sln file in the base directory.\r
  25 2) Choose build from the build menu.  No extra libraries are required\r
  26 as they are all bundled in the source distribution.\r
  27 \r
  28 Linux\r
  29 -----\r
  30 Compiling requirements  : \r
  31 \r
  32  * GNU tools (http://www.gnu.org/directory/GNU/)\r
  33     aclocal (GNU aclocal) 1.6           [aclocal --version]\r
  34     automake (GNU automake) 1.6         [automake --version]\r
  35     autoconf (GNU autoconf) 2.57        [autoconf --version]\r
  36     GNU Make 3.80                       [make --version]\r
  37     gcc version 3.2                     [g++ --version]\r
  38 \r
  39  * Simple Directmedia Layer (http://www.libsdl.org/)\r
  40     SDL 1.2.4\r
  41 \r
  42  * FreeType2 (http://www.freetype.org)\r
  43     freetype 7.0.1                      [freetype-config --version]\r
  44 \r
  45  * OpenAL (http://www.openal.org)\r
  46     openal 0.0.8  [openal-config --version]\r
  47 \r
  48   cvs -d:pserver:guest@opensource.creative.com:/usr/local/cvs-repository login\r
  49   (use password "guest")\r
  50   cvs -d:pserver:guest@opensource.creative.com:/usr/local/cvs-repository co openal \r
  51 \r
  52  * WX-windows (http://www.wxwindows.org)\r
  53     wx-windows 2.4.2                    [wx-config --version]\r
  54 \r
  55  * OpenGL (http://www.opengl.org)       [glxinfo | grep -i version]\r
  56     server glx version string: 1.3\r
  57     client glx version string: 1.3\r
  58     OpenGL version string: 1.4.0 \r
  59     glu version: 1.3\r
  60 \r
  61 Make sure at least all these are properly installed.\r
  62 Any required m4 files are now packaged as part of the scorched3d\r
  63 distribution.\r
  64 \r
  65 Run the following commands to compile scorched :-\r
  66 \r
  67 1) chmod +x autogen.sh\r
  68 2) ./autogen.sh\r
  69 3) make \r
  70 (on some systems build times can be reduced by using the -j2\r
  71 flag for make)\r
  72 4) make install (may need to be done as root)\r
  73 \r
  74 If you are compiling from CVS or a development version and the\r
  75 compiler complains of missing files at link time you may need to \r
  76 run the createAMMakefile.pl script in the scripts directory.\r
  77 Do this before step 1.\r
  78 \r
  79 By default Scorched3D will be installed in /usr/local/games/scorched3d.\r
  80 The Scorched3D executable is called scorched3d and is located\r
  81 in the bin directory off this directory.  \r
  82 \r
  83 MacOSX\r
  84 ------\r
  85 The Mac version has now been updated to be compiled in the same\r
  86 way as the linux version.  See above.\r
  87 Use wxmac instead of wxgtk to allow the user to run without X11.\r
  88 \r
  89 \r