WindowsInstall

Windows installation

Installing from a binary package

1. Download the Windows installer
2. Run it and follow the on-screen instructions
3. Read carefully the README file in case you can't start the game. You probably need to install the MS VC 2005 SP1 redistributable package (get it here : http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en)

Installing from sources

See source:tags/2.0.0/INSTALL.txt

---

Installing from 1.4.0 sources (obsolete)

Pre-requisites

WARNING: If you build these libs yourself, be careful to compile everything for multithreaded DLL integration (/MD & /MDd)

You can download a pre-built package (built with MSVC 2005 Pro no SP) here.

• Working OpenGL Driver and header files / associated libraries
• PLIB 1.8.3 / 4 / 5 (http://plib.sourceforge.net/).
• OpenAL soft 1.5 (http://connect.creativelabs.com/openal)
• ALUT 1.1 (http://connect.creativelabs.com/openal)
• libpng
• zlib
• jpeg

MS VC++ 2005 (8) / 2008 (9)

Note: If you use an "Express" version, don't forget to also install the Windows SDK.

For a Release build

1. Unzip the source archives
2. Download the "MSCV2005" release of "3rdParty" package from SF.net. It contains necessary 3rd party libs compiled for MSVC2005

3. Extract from the zip file the "3rdParty" directory to the directory level where Speed Dreams is installed. Example:

   If sources are in D:\speed-dreams\trunk,
   extract 3rd party zip in D:\speed-dreams
   and you should have a D:\speed-dreams\3rdParty directory.
   

4. Run prebuild.bat (double-click on it in the explorer window)

5. Open speed-dreams.sln with MSVC 2005/2008 (Pro/Express)
6. Select the Win32-Release configuration
7. Right click on the speed-dreams solution, and then on Build solution (many warnings)
8. Run postbuild.bat (double-click on it in the explorer window)
9. Go to the "runtime" directory
10. double-click on speed-dreams.exe

For a Debug build all steps are the same, except for the following ones :

1. Run prebuild-debug.bat (double-click on it in the explorer window)
2. Open the speed-dreams.sln with MSVC 2005/2008 (Pro/Express)
3. Select the Win32-Debug configuration
4. Right click on the speed-dreams solution, and then on Build solution (many warnings)
5. Run postbuild-debug.bat (double-click on it in the explorer window)
6. Set "speed-dreams" as the run-time project (right-click menu on the project)

7. Change run-time settings for "speed-dreams" project (right-click menu on the project, then Settings):

   target executable : select <the dir where speed-dreams.sln is>/runtimed/speed-dreams.exe
   working directory : select <the dir where speed-dreams.sln is>/runtimed
   

8. Run Speed Dreams (Debug / Start debugging)

Hints

• You can enjoy a Release and a Debug build side by side, the Release version goes to the "runtime" directory, and the Debug one to the "runtimed" one.

• If you want all the source tree robots to be built (even unmaintained ones), use speed-dreams-unmaitained.sln, and just before, in a console windows:

  $ cd <the dir that contains runtime (or runtimed)>
  $ prebuild runtime full (or prebuild runtimed full)
  

• If you want to play with ALL the source tree cars and tracks (even unmaintained ones), issue the following commands before or after the MSVC build (but after the prebuild step):

  $ cd <the dir that contains runtime (or runtimed)>
  $ postbuild runtime full (or postbuild runtimed full)
  

• you can mix (or not) the unmaitained robots and unmaintained cars and tracks

MS VC++ 6 SP6

It was also working in the past (no more maintained)

Be aware that shipped speed-dreams.dsw and associated .dsp files are old and no more maintained, so they are very likely to not work at all... and consider downloading free MSVC2005/2008 Express and Windows SDK from Microsoft's site ...

Same procedure as above, except that you'll need first to build your own 3rdParty package with MSVC6 (MSVC 2005 built libs are NOT compatible with MSVC6 builds). See 3rdParty/ReadMe.txt for details on where to get the sources ...

Note

VC++ 6 settings:

View->Properties
    tab size = 8
    Indent size = 4
Tools->Options (Tab)
    tab size = 8
    Indent size = 4