Compiling OpenTTD using Microsoft Visual C++

January 2, 2007

--------------------------------------------

PLEASE READ THE ENTIRE DOCUMENT BEFORE DOING ANY ACTUAL CHANGES!!

SUPPORTED MSVC COMPILERS

------------------------

compile out of the box, providing you have the required libraries/headers;

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

500MB each.

Download the following files:

	* openttd-useful.zip (http://sf.net/project/showfiles.php?group_id=103924&package_id=114307)

	* DirectX 8.1 SDK (http://neuron.tuke.sk/~mizanin/eng/Dx81sdk-include-lib.rar) (or alternatively the latest DirectX SDK from Microsoft)

	* MS Windows Platform SDK (http://www.microsoft.com/downloads/details.aspx?FamilyId=A55B6B43-E24F-4EA3-A93E-40C0EC4F68E5&displaylang=en)

If you have put the above include and/or library files into custom folders,

MSVC will not find them by default. You need to add these paths to VC through:

Tools > Options > Projects and Solutions > VC++ Directories > show directories for

	* Include files: Add the DirectX/Platform SDK include dir you've created

	* 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!!

3) TTD GRAPHICS FILES

---------------------

Copy the following files from Transport Tycoon Deluxe to the bin/data folder

	* sample.cat

	* trg1r.grf

	* trgcr.grf

	* trghr.grf

	* trgir.grf

	* trgtr.grf

4) COMPILING

------------

Set the build mode to 'Release' in

Build > Configuration manager > Active solution configuration > select "Release"

Compile...

5) EDITING, CHANGING SOURCE CODE

--------------------------------

Set the build mode (back to) 'Debug'

Change the startup project to openttd by right-clicking the 'openttd' project

in the Solution Explorer and selecting 'Set as Startup Project'. The 'openttd'

project should now show up bold instead of 'strgen'.

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:

fi

# openttd_vs90.sln    is for MSVC 2008

# openttd_vs90.vcproj is for MSVC 2008

# langs_vs90.vcproj   is for MSVC 2008

# strgen_vs90.vcproj  is for MSVC 2008

# openttd_vs80.sln    is for MSVC 2005

# openttd_vs80.vcproj is for MSVC 2005

# langs_vs80.vcproj   is for MSVC 2005

# strgen_vs80.vcproj  is for MSVC 2005

# First, collect the list of Windows files

sdl_config="1"

png_config="1"

os="MSVC"

enable_dedicated="0"

with_cocoa="0"

enable_directmusic="1"

with_threads="1"

file_prefix="..\\\\src\\\\"

				gsub("	", "", $0);

				gsub("^#", "", $0);

				gsub("^ ", "", $0);

				if (first_time != 0) {

					print "		</Filter>";

				} else {

					first_time = 1;

				}

				print "		<Filter";

				print "			Name=\\""$0"\\"";

			}

			next;

		}

		/^$/ { next }

		{

			if (deep == skip) {

				gsub("	", "", $0);

				gsub("/", "\\\\", $0);

				print "			<File";

				print "			</File>";

			}

		}

		END { print "		</Filter>"; }

	'`"

	eval "$2=\"\$RES\""

}

load_lang_data() {

	RES=""

	for i in `ls $1`

	do

		i=`basename $i | sed s/.txt$//g`

		RES="$RES

		<File

			<FileConfiguration

				<Tool

					Name=\"VCCustomBuildTool\"

					Description=\"Generating "$i" language file\"

					CommandLine=\"..\\objs\\strgen\\strgen.exe -s ..\\src\\lang -d ..\\bin\\lang "\$(InputPath)"
\"

					AdditionalDependencies=\"\"

			</FileConfiguration>

		</File>"

	done

	eval "$2=\"\$RES\""

}

generate() {

	echo "Generating $2..."

	# Everything above the !!FILES!! marker

	cat "$ROOT_DIR/projects/$2".in | tr '\r' '\n' | awk '

		/^$/ { next }

		/!!FILES!!/ { stop = 1; }

		{

			if (stop == 0) { print $0 }

		}

	' > "$ROOT_DIR/projects/$2"

	# Everything below the !!FILES!! marker

	cat "$ROOT_DIR/projects/$2".in | tr '\r' '\n' | awk '

		BEGIN { stop = 1; }

		/^$/ { next }

		/!!FILES!!/ { stop = 2; }

		{

			if (stop == 0) { print $0 }

			if (stop == 2) { stop = 0 }

		}

	' >> "$ROOT_DIR/projects/$2"

}

safety_check "$ROOT_DIR/source.list"

load_main_data "$ROOT_DIR/source.list" openttd

load_lang_data "$ROOT_DIR/src/lang/*.txt" lang

	DEBUG_LEVEL(oldloader),

	DEBUG_LEVEL(ntp),

	DEBUG_LEVEL(npf),

	DEBUG_LEVEL(yapf),

	DEBUG_LEVEL(freetype),

	DEBUG_LEVEL(sl),

	DEBUG_LEVEL(station),

	};

#undef DEBUG_LEVEL

#if !defined(NO_DEBUG_MESSAGES)

void CDECL debug(const char *dbg, ...)

{

	va_list va;

	va_start(va, dbg);

#if defined(ENABLE_NETWORK)

#endif /* ENABLE_NETWORK */

#if defined(WINCE)

#else

#endif

	}

}

#endif /* NO_DEBUG_MESSAGES */

void SetDebugString(const char *s)

{

	int v;

	char *end;

	const char *t;

	/* global debugging level? */

	if (*s >= '0' && *s <= '9') {

 * maximum debugging level should be 10 if really deep, deep

 * debugging is needed.

 * (there is room for exceptions, but you have to have a good cause):

 * 0   - errors or severe warnings

 * 1   - other non-fatal, non-severe warnings

 * 2   - crude progress indicator of functionality

 * 3   - important debugging messages (function entry)

 * 4   - debugging messages (crude loop status, etc.)

 * 5   - detailed debugging information

 * 6.. - extremely detailed spamming

 */

#ifdef NO_DEBUG_MESSAGES

		#define DEBUG(name, level, args...)

	#else

		#define DEBUG(name, level, ...)

	#endif

#else /* NO_DEBUG_MESSAGES */

		#define DEBUG(name, level, args...) if ((level == 0) || ( _debug_ ## name ## _level >= level)) debug(#name, args)

	#else

		#define DEBUG(name, level, ...) if (level == 0 || _debug_ ## name ## _level >= level) debug(#name, __VA_ARGS__)

	#endif

	extern int _debug_ai_level;

	extern int _debug_driver_level;

	extern int _debug_grf_level;

	extern int _debug_map_level;

	extern int _debug_misc_level;

	extern int _debug_ms_level;

	extern int _debug_net_level;

	extern int _debug_sprite_level;

	extern int _debug_oldloader_level;

	extern int _debug_ntp_level;

	extern int _debug_npf_level;

	extern int _debug_yapf_level;

	extern int _debug_freetype_level;

	extern int _debug_sl_level;

	extern int _debug_station_level;

#endif /* NO_DEBUG_MESSAGES */

void SetDebugString(const char *s);

const char *GetDebugString();

/* MSVCRT of course has to have a different syntax for long long *sigh* */

#if defined(_MSC_VER) || defined(__MINGW32__)

	#define OTTD_PRINTF64 "I64"

#else

	#define OTTD_PRINTF64 "ll"

#endif

	GRAPH_AXIS_LINE_COLOUR  = 215,

	GRAPH_X_POSITION_BEGINNING  = 44,  ///< Start the graph 44 pixels from gw->left

	GRAPH_X_POSITION_SEPARATION = 22,  ///< There are 22 pixels between each X value

	GRAPH_NUM_LINES_Y = 9, ///< How many horizontal lines to draw.

	/* 9 is convenient as that means the distance between them is the height of the graph / 8,

	 * which is the same

	 * as height >> 3. */

};

/* Apparently these don't play well with enums. */

static const uint INVALID_DATAPOINT_POS = UINT_MAX;  // Used to determine if the previous point was drawn.

struct GraphDrawer {

	uint excluded_data; ///< bitmask of the datasets that shouldn't be displayed.

	byte num_dataset;

	byte num_on_x_axis;

	bool has_negative_values;

	byte num_vert_lines;

	/* The starting month and year that values are plotted against. If month is

	 * 0xFF, use x_values_start and x_values_increment below instead. */

	byte month;

	#define _WIN32_WINNT 0x0500       // Windows 2000

	#define _WIN32_WINDOWS 0x400      // Windows 95

	#if !defined(WINCE)

		#define WINVER 0x0400     // Windows NT 4.0 / Windows 95

	#endif

	#define _WIN32_IE_ 0x0401         // 4.01 (win98 and NT4SP5+)

	#define WIN32_LEAN_AND_MEAN     // Exclude rarely-used stuff from Windows headers

	#pragma warning(disable: 4244)  // 'conversion' conversion from 'type1' to 'type2', possible loss of data

	#pragma warning(disable: 4761)  // integral size mismatch in argument : conversion supplied

	#pragma warning(disable: 4200)  // nonstandard extension used : zero-sized array in struct/union

	#include <malloc.h> // alloca()

	#define NORETURN __declspec(noreturn)

	#define FORCEINLINE __forceinline

	#define inline _inline

	#if !defined(WINCE)

		#define CDECL _cdecl

	#endif

	int CDECL snprintf(char *str, size_t size, const char *format, ...);

	#if (_MSC_VER < 1400) || defined(WINCE)