Compiling the Viewer (MSVS2008)

In current release branches, only MSVS 2005 is officially supported, however other versions of Visual Studio may work. If you run into problems, members of the SLDev mailing list will generally help. It's good form to update the wiki with what you learn, or file JIRAs against source deficiencies. If this is your first build, consider referring back to the list of supported compilers on Microsoft Windows.

Download Express (optional)

If you do not already own Visual Studio, then you may download Microsoft's free IDE and compiler editions.

Click here to download Visual C++ Express - currently VS2008 only

Install Microsoft Platform & DirectX SDKs

Download and install:

• Windows SDK for Windows Server 2008 and .NET Framework 3.5
• DirectX SDK (August 2008)

If you have previously installed an older version of the DirectX 9.0 SDK, remove it first (from Control Panel -> Add or Remove Programs) before installing this version. Installing the new SDK "on top" of an older version may cause problems. Upon installing DirectX, it is sufficient to install the include and libraries part. Other DX development tools are not necessary.

Setup the project globals

• Start Visual Studio
• Go to Tools > Options > Projects > VC++ Directories
• Make sure that the includes and libraries paths ("Include files" and "Library files" in the "show directories for" dropdown) exist, and add them if they don't, in the following order: (see screenshots below)
  1. Platform SDK paths
  2. DirectX SDK paths
  3. Visual C++ paths
  • NOTE: The newest DirectX SDK ("December 2006") lib folder has two sub-folders, x64 and x86. Make sure your path goes to one of them (select lib/x86, not just lib), or you will get a Link error. For the Windows Platform SDK, there is not a subfolder for x86 (even though there are subfolders for AMD64, IA64, etc.), so do not select a subfolder for the Windows Platform SDK.
• Also, make sure that your cygwin (default C:\cygwin\bin) and ActivePython (default C:\Python25) directories are under the "Executable files" dirs and moved to the bottom of the list. (Even if you update your PATH environment variable, those changes will NOT be reflected inside Visual Studio!)

Screenshots

• Example screenshot of Tools > Options > Projects > VC++ Directories > Includes files

• Example screenshot of Tools > Options > Projects > VC++ Directories > Libraries files