GAMEX R5 - BUILD NOTES
======================

Required Libraries
------------------
*  DirectX 9.0c SDK (Oct 2005, 10/13/2005) - known good
      http://www.microsoft.com/downloads/details.aspx?FamilyID=1c8dc451-2dbe-4ecc-8c57-c52eea50c20a&DisplayLang=en
    
*  Microsoft Platform SDK, Windows Server 2003 SP1 SDK (5/2/2005) - known good  
      http://www.microsoft.com/downloads/details.aspx?FamilyID=a55b6b43-e24f-4ea3-a93e-40c0ec4f68e5&DisplayLang=en


Troubleshooting
---------------

PROBLEM:
   cannot open file 'GameXR5-VS2005-Debug.lib' (or similar)
SOLUTION:
   You must include the GameXR5 path in your Visual Studio search paths.
   For example, in Tools->Options->VC++ Directories, in Library Paths, you must have an entry like:
      E:\GameX\GameXR5  (where to find GameXR5-VS2005-Debug.lib)

PROBLEM:
   cannot open file 'libcpd.lib'
SOLUTION:
   You are attempt to link a Visual Studio 2005 game project with the GameX library for .NET 2003.
   Libraries are not compatible between compilers. To build a VS2005 game, you need to
   link to GameXR5-VS2005-Debug.lib.

PROBLEM: 
   warning LNK4098: defaultlib 'LIBCMT' conflicts with use of other libs; use /NODEFAULTLIB:library
SOLUTION:
   You are mixing debug and release libraries. For example, if you build the GameXR5 library in
   Debug mode using the Multi-threaded (/MT), a release mode library, when it should be Multi-threaded Debug (/MTd).

PROBLEM: 
   error LNK2001: unresolved external symbol __RTC_CheckEsp
SOLUTION:
   You are using Multi-threaded Debug (/MT) to build GameXR5 with Visual Studio 2005.
   This should be Multi-threaded Debug DLL (/MDd). Do not use (/MT) or (/MTd) to build GameX.

PROBLEM:
   cannot open ddraw.lib
SOLUTION:
   You have not installed DirectX 9, or included it in your search paths.
   For example, in Tools->Options->VC++ Directories, in Library Paths, you must have an entry like:
      C:\Program Files\DX9SDK\Lib\x86

PROBLEM:
   cannot open strmiids.lib
SOLUTION:
   You have not installed Microsoft Platform SDK, or included it in your search paths.
   For example, in Tools->Options->VC++ Directories, in Library Paths, you must have an entry like:
      C:\Program Files\Microsoft Platform SDK\Lib

Visual Studio - Search Paths
----------------------------
Found in Tools -> Options -> VC++ Directories

Library Paths:
 C:\Program Files\DX9SDK\Lib\x86				Cannot open ddraw.lib
 C:\Program Files\Microsoft Platform SDK\Lib		Cannot open file 'strmiids.lib'
 C:\Program Files\NVIDIA\Cg\lib
 C:\Program Files\NVIDIA\Cg\bin

Include Paths:
 C:\Program Files\DX9SDK\Include
 C:\Program Files\NVIDIA\Cg\include
 C:\Program Files\Microsoft Platform SDK\Samples\Multimedia\DirectShow\BaseClasses
 C:\Program Files\Microsoft Platform SDK\Include


Build Configurations
--------------------

Visual Studio 2005
------------------
Debug Config
 Configuration Type: Static Library (.lib)
 Preprocessor Defines:  WIN32;_DEBUG;_WINDOWS;_WIN32_WINNT=0x400
 Runtime Library:  Multi-threaded Debug DLL (/MDd)
 Ignore Specific Library:  libc.lib, libcmt.lib
 Output: GameXR5-VS2005-Debug.lib

Release Config
 Configuration Type: Static Library (.lib)
 Preprocessor Defines:  WIN32;NDEBUG;_WINDOWS;_WIN32_WINNT=0x400
 Runtime Library:  Multi-threaded DLL (/MD)
 Ignore Specific Library:  libcd.lib, libcmtd.lib
 Output: GameXR5-VS2005-Release.lib

.NET 2003
---------
Debug Config
 Configuration Type: Static Library (.lib)
 Preprocessor Defines: WIN32;_DEBUG;_WINDOWS
 Runtime Library:  Single-threaded Debug (/MLd)
 Ignore Specific Library:  None
 Output: GameXR5-NET2003-Debug.lib

Release Config
 Configuration Type: Static Library (.lib)
 Preprocessor Defines: WIN32;NDEBUG;_WINDOWS
 Runtime Library:  Single-threaded Debug (/ML)
 Ignore Specific Library:  None
 Output: GameXR5-NET2003-Release.lib