File diff r8408:9bba0f36017f → r8409:2e7aa818987b
docs/Readme_Windows_MSVC.txt
Show inline comments
 
@@ -3,17 +3,17 @@ January 2, 2007
 
--------------------------------------------
 
PLEASE READ THE ENTIRE DOCUMENT BEFORE DOING ANY ACTUAL CHANGES!!
 

	
 

	
 
SUPPORTED MSVC COMPILERS
 
------------------------
 
OpenTTD includes projects for MSVC 2003.NET and MSVC 2005.NET. Both will
 
OpenTTD includes projects for MSVC 2005.NET and MSVC 2008.NET. Both will
 
compile out of the box, providing you have the required libraries/headers;
 
which ones, see below. There is no support for VS6, you are therefore
 
strongly encouraged to either upgrade to MSVC 2005 Express (free) or use GCC.
 
MSVC 2002 probably works as well, but it has not been tested.
 
which ones, see below. There is no support for VS6 or MSVC 2002, or
 
MSVC 2003.NET. You are therefore strongly encouraged to either upgrade to
 
MSVC 2005 Express (free) or use GCC.
 

	
 

	
 
1) REQUIRED FILES
 
-----------------
 
You might already have some of the files already installed, so check before
 
downloading; mostly because the DirectX SDK and Platform SDK are about
 
@@ -71,26 +71,12 @@ Tools > Options > Projects and Solutions
 
	* Library files: Add the path to the SDK custom lib dir
 

	
 
NOTE: make sure that the directory for the DirectX SDK is the first one in the
 
list, above all others, otherwise compilation will most likely fail!!
 

	
 

	
 
2.3) DEBUGGING - WORKING DIRECTORY (MSVC 2003 ONLY!)
 
----------------------------------------------------
 
The very first time you check out and compile OpenTTD with Visual Studio 2003, running
 
the binary will complain about missing files. You need to go into and change a setting
 

	
 
OpenTTD > Project > Properties > Configuration (All Configurations) > ...
 
 Configuration Properties > Debugging >
 

	
 
	* Working Directory: ..\bin
 

	
 
VS 2005 works out of the box because Microsoft allowed a user to supply a humanly-
 
readable defaults file (openttd_vs80.vcproj.user), whereas 2003 is braindead.
 

	
 

	
 
3) TTD GRAPHICS FILES
 
---------------------
 
Copy the following files from Transport Tycoon Deluxe to the bin/data folder
 

	
 
	* sample.cat
 
	* trg1r.grf
 
@@ -99,18 +85,18 @@ Copy the following files from Transport 
 
	* trgir.grf
 
	* trgtr.grf
 

	
 

	
 
4) COMPILING
 
------------
 
Open trunk/openttd[_vs80].sln
 
Open trunk/openttd_vs[89]0.sln
 
Set the build mode to 'Release' in
 
Build > Configuration manager > Active solution configuration > select "Release"
 
Compile...
 

	
 
If everything works well the binary should be in trunk/objs/[Win32]/Release/openttd.exe
 
If everything works well the binary should be in trunk/objs/Win[32|64]/Release/openttd.exe
 

	
 

	
 
5) EDITING, CHANGING SOURCE CODE
 
--------------------------------
 
Set the build mode (back to) 'Debug'
 
Change the startup project to openttd by right-clicking the 'openttd' project
 
@@ -123,7 +109,7 @@ 6) PROBLEMS?
 
If compilation fails, double-check that you are using the latest SVN (!)
 
source. If it still doesn't work, check in on IRC (irc://irc.oftc.net/openttd),
 
to ask about reasons; or just wait. The problem will most likely solve itself
 
within a few days as the problem is noticed and fixed.
 

	
 
An up-to-date version of this README can be found on the wiki:
 
http://wiki.openttd.org/index.php/MicrosoftVisualCExpress
 
\ No newline at end of file
 
http://wiki.openttd.org/index.php/MicrosoftVisualCExpress