DevEnvironment – HoverRace

  1. Development Environment
    1. Checking out the source code
    2. Visual Studio .suo setup
    3. Library dependencies
      1. Boost
      2. OpenAL SDK
      3. DirectX SDK

Development Environment

Currently, HoverRace only builds on Windows, using Microsoft Visual Studio 2010. All editions of Visual Studio 2010, including the free  Visual C++ Express edition, are supported.

A native Linux port is planned for the HoverRace 2.0 timeframe, and portability is a high priority for current development. See ticket #20 and LinuxDevEnvironment.

Checking out the source code

See SVN for more information about how to check out the source code. The repository is at 

svn://svn.igglybob.com/hoverrace/

Visual Studio .suo setup

Since the user-dependent .suo files are not included in the Subversion repository, The 'client' project should be set to the default build project. Everything else should work out of the box.

Library dependencies

In general, because of the hassle of building and installing development libraries in Windows environments, we provide some precompiled DLLs and headers in the Subversion checkout.

Exceptions are:

  • Boost
  • OpenAL SDK
  • DirectX SDK

Boost

The  Boost library is quite large. Until precompiled Boost libraries are available, you will need to compile Boost yourself.

Don't worry! It's not hard. Here's how:  http://stackoverflow.com/questions/2629421/how-to-use-boost-in-visual-studio-2010/2655683#2655683

Once installed, you'll need to point Visual Studio at where you installed the Boost library:

  1. View -> Property Manager
  2. Open any of the projects, then any configuration, and double-click on the "Microsoft.Cpp.Win32.user" item.
  3. Select "VC++ Directories"
  4. In "Include Directories", add the folder for where Boost was installed (e.g. "C:\Program Files\boost\boost_1_43_0").
  5. In "Library Directories", add the "lib" folder under where Boost was installed (e.g. "C:\Program Files\boost\boost_1_43_0\lib").

OpenAL SDK

Creative Labs distributes a Windows installer for the OpenAL SDK:
 http://connect.creativelabs.com/openal/Downloads/Forms/AllItems.aspx

However, the OpenAL SDK is not listed on that page, and as of September 2009, can be found here:
 http://connect.creativelabs.com/openal/Downloads/OpenAL11CoreSDK.zip

Once installed, you'll need to point Visual Studio at where you installed the OpenAL SDK:

  1. View -> Property Manager
  2. Open any of the projects, then any configuration, and double-click on the "Microsoft.Cpp.Win32.user" item.
  3. Select "VC++ Directories"
  4. In "Include Directories", add the "include" folder under where the SDK was installed (e.g. "C:\OpenAL\include").
  5. In "Library Directories", add the "libs\Win32" folder under where the SDK was installed (e.g. "C:\OpenAL\libs\Win32").

DirectX SDK

Install the June 2010 DirectX SDK:
 http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=3021d52b-514e-41d3-ad02-438a3ba730ba

(Note: The February 2010 release of the DirectX SDK will also probably work, but no guarantees).

Once installed (like Boost) you will need to tell Visual Studio where to find the DirectX SDK:

  1. View -> Property Manager
  2. Open any of the projects, then any configuration, and double-click on the "Microsoft.Cpp.Win32.user" item.
  3. Select "VC++ Directories"
  4. In "Include Directories", add the "Include" folder under where the SDK was installed (e.g. "D:\DirectX SDK\Include").
  5. In "Library Directories", add the "Lib\x86" folder under where the SDK was installed (e.g. "D:\DirectX SDK\Lib\x86").