1

/* $Id$ */

     2

     3

/** @file gfxinit.cpp Initializing of the (GRF) graphics. */

     4

     5

#include "stdafx.h"

     6

#include "openttd.h"

     7

#include "debug.h"

     8

#include "gfxinit.h"

     9

#include "spritecache.h"

    10

#include "fileio_func.h"

    11

#include "fios.h"

    12

#include "newgrf.h"

    13

#include "md5.h"

    14

#include "variables.h"

    15

#include "fontcache.h"

    16

#include "gfx_func.h"

    17

#include "core/alloc_func.hpp"

    18

#include "core/bitmath_func.hpp"

    19

#include "core/smallvec_type.hpp"

    20

#include <string.h>

    21

#include "settings_type.h"

    22

#include "string_func.h"

    23

#include "ini_type.h"

    24

    25

#include "table/sprites.h"

    27

    28

/** The currently used palette */

    29

PaletteType _use_palette = PAL_AUTODETECT;

    37

char _ini_graphics_set[32];

    38

    39

/** Structure holding filename and MD5 information about a single file */

    40

struct MD5File {

    41

	const char *filename;        ///< filename

    42

	uint8 hash[16];              ///< md5 sum of the file

    43

	const char *missing_warning; ///< warning when this file is missing

    44

};

    45

    46

/** Types of graphics in the base graphics set */

    47

enum GraphicsFileType {

    48

	GFT_BASE,     ///< Base sprites for all climates

    49

	GFT_LOGOS,    ///< Logos, landscape icons and original terrain generator sprites

    50

	GFT_ARCTIC,   ///< Landscape replacement sprites for arctic

    51

	GFT_TROPICAL, ///< Landscape replacement sprites for tropical

    52

	GFT_TOYLAND,  ///< Landscape replacement sprites for toyland

    53

	GFT_EXTRA,    ///< Extra sprites that were not part of the original sprites

    54

	MAX_GFT       ///< We are looking for this amount of GRFs

    55

};

    56

    57

/** Information about a single graphics set. */

    58

struct GraphicsSet {

    59

	const char *name;          ///< The name of the graphics set

    60

	const char *description;   ///< Description of the graphics set

    61

	uint32 shortname;          ///< Four letter short variant of the name

    62

	uint32 version;            ///< The version of this graphics set

    63

	PaletteType palette;       ///< Palette of this graphics set

    64

    65

	MD5File files[MAX_GFT];    ///< All GRF files part of this set

    66

	uint found_grfs;           ///< Number of the GRFs that could be found

    67

    68

	GraphicsSet *next;         ///< The next graphics set in this list

    69

    70

	/** Free everything we allocated */

    71

	~GraphicsSet()

    72

	{

    73

		free((void*)this->name);

    74

		free((void*)this->description);

    75

		for (uint i = 0; i < MAX_GFT; i++) {

    76

			free((void*)this->files[i].filename);

    77

			free((void*)this->files[i].missing_warning);

    78

		}

    79

    80

		delete this->next;

    81

	}

    82

};

    83

    84

/** All graphics sets currently available */

    85

static GraphicsSet *_available_graphics_sets = NULL;

    86

/** The one and only graphics set that is currently being used. */

    87

static const GraphicsSet *_used_graphics_set = NULL;

    88

    89

#include "table/files.h"

    90

#include "table/landscape_sprite.h"

    91

    92

static const SpriteID * const _landscape_spriteindexes[] = {

    93

	_landscape_spriteindexes_1,

    94

	_landscape_spriteindexes_2,

    95

	_landscape_spriteindexes_3,

    96

};

    97

    98

static uint LoadGrfFile(const char *filename, uint load_index, int file_index)

    99

{

   100

	uint load_index_org = load_index;

   101

	uint sprite_id = 0;

   102

   103

	FioOpenFile(file_index, filename);

   104

   105

	DEBUG(sprite, 2, "Reading grf-file '%s'", filename);

   106

   107

	while (LoadNextSprite(load_index, file_index, sprite_id)) {

   108

		load_index++;

   109

		sprite_id++;

   110

		if (load_index >= MAX_SPRITES) {

   111

			usererror("Too many sprites. Recompile with higher MAX_SPRITES value or remove some custom GRF files.");

   112

		}

   113

	}

   114

	DEBUG(sprite, 2, "Currently %i sprites are loaded", load_index);

   115

   116

	return load_index - load_index_org;

   117

}

   118

   119

   120

void LoadSpritesIndexed(int file_index, uint *sprite_id, const SpriteID *index_tbl)

   121

{

   122

	uint start;

   123

	while ((start = *index_tbl++) != END) {

   124

		uint end = *index_tbl++;

   125

   126

		do {

   127

			bool b = LoadNextSprite(start, file_index, *sprite_id);

   128

			assert(b);

   129

			(*sprite_id)++;

   130

		} while (++start <= end);

   131

	}

   132

}

   133

   134

static void LoadGrfIndexed(const char* filename, const SpriteID* index_tbl, int file_index)

   135

{

   136

	uint sprite_id = 0;

   137

   138

	FioOpenFile(file_index, filename);

   139

   140

	DEBUG(sprite, 2, "Reading indexed grf-file '%s'", filename);

   141

   142

	LoadSpritesIndexed(file_index, &sprite_id, index_tbl);

   143

}

   144

   145

   146

/**

   147

 * Calculate and check the MD5 hash of the supplied filename.

   148

 * @param file filename and expected MD5 hash for the given filename.

   149

 * @return true if the checksum is correct.

   150

 */

   151

static bool FileMD5(const MD5File file)

   152

{

   153

	size_t size;

   154

	FILE *f = FioFOpenFile(file.filename, "rb", DATA_DIR, &size);

   155

   156

	if (f != NULL) {

   157

		Md5 checksum;

   158

		uint8 buffer[1024];

   159

		uint8 digest[16];

   160

		size_t len;

   161

   162

		while ((len = fread(buffer, 1, (size > sizeof(buffer)) ? sizeof(buffer) : size, f)) != 0 && size != 0) {

   163

			size -= len;

   164

			checksum.Append(buffer, len);

   165

		}

   166

   167

		FioFCloseFile(f);

   168

   169

		checksum.Finish(digest);

   170

		return memcmp(file.hash, digest, sizeof(file.hash)) == 0;

   171

	} else { // file not found

   172

		return false;

   173

	}

   174

}

   175

   176

/**

   177

 * Determine the graphics pack that has to be used.

   178

 * The one with the most correct files wins.

   179

 */

   180

static bool DetermineGraphicsPack()

   181

{

   182

	if (_used_graphics_set != NULL) return true;

   183

   184

	const GraphicsSet *best = _available_graphics_sets;

   185

	for (const GraphicsSet *c = _available_graphics_sets; c != NULL; c = c->next) {

   186

		if (best->found_grfs < c->found_grfs ||

   190

			best = c;

   191

		}

   192

	}

   193

   194

	_used_graphics_set = best;

   195

	return _used_graphics_set != NULL;

   196

}

   197

   198

/**

   199

 * Determine the palette that has to be used.

   200

 *  - forced palette via command line -> leave it that way

   201

 *  - otherwise -> palette based on the graphics pack

   202

 */

   203

static void DeterminePalette()

   204

{

   205

	assert(_used_graphics_set != NULL);

   207

   222

}

   223

   224

/**

   225

 * Checks whether the MD5 checksums of the files are correct.

   226

 *

   227

 * @note Also checks sample.cat and other required non-NewGRF GRFs for corruption.

   228

 */

   229

void CheckExternalFiles()

   230

{

   231

	DeterminePalette();

   232

   235

	static const size_t ERROR_MESSAGE_LENGTH = 128;

   236

	char error_msg[ERROR_MESSAGE_LENGTH * (MAX_GFT + 1)];

   237

	error_msg[0] = '\0';

   238

	char *add_pos = error_msg;

   239

   240

	for (uint i = 0; i < lengthof(_used_graphics_set->files); i++) {

   241

		if (!FileMD5(_used_graphics_set->files[i])) {

   242

			add_pos += snprintf(add_pos, ERROR_MESSAGE_LENGTH, "Your '%s' file is corrupted or missing! %s\n", _used_graphics_set->files[i].filename, _used_graphics_set->files[i].missing_warning);

   243

		}

   244

	}

   245

   246

	bool sound = false;

   247

	for (uint i = 0; !sound && i < lengthof(_sound_sets); i++) {

   248

		sound = FileMD5(_sound_sets[i]);

   249

	}

   250

   251

	if (!sound) {

   252

		add_pos += snprintf(add_pos, ERROR_MESSAGE_LENGTH, "Your 'sample.cat' file is corrupted or missing! You can find 'sample.cat' on your Transport Tycoon Deluxe CD-ROM.\n");

   253

	}

   254

   255

	if (add_pos != error_msg) ShowInfoF(error_msg);

   256

}

   257

   258

   259

static void LoadSpriteTables()

   260

{

   262

	uint i = FIRST_GRF_SLOT;

   263

   265

	LoadGrfFile(_used_graphics_set->files[GFT_BASE].filename, 0, i++);

   266

   267

	/*

   268

	 * The second basic file always starts at the given location and does

   269

	 * contain a different amount of sprites depending on the "type"; DOS

   270

	 * has a few sprites less. However, we do not care about those missing

   271

	 * sprites as they are not shown anyway (logos in intro game).

   272

	 */

   274

	LoadGrfFile(_used_graphics_set->files[GFT_LOGOS].filename, 4793, i++);

   275

   276

	/*

   277

	 * Load additional sprites for climates other than temperate.

   278

	 * This overwrites some of the temperate sprites, such as foundations

   279

	 * and the ground sprites.

   280

	 */

   281

	if (_settings_game.game_creation.landscape != LT_TEMPERATE) {

   283

		LoadGrfIndexed(

   284

			_used_graphics_set->files[GFT_ARCTIC + _settings_game.game_creation.landscape - 1].filename,

   285

			_landscape_spriteindexes[_settings_game.game_creation.landscape - 1],

   286

			i++

   287

		);

   288

	}

   289

   290

	/* Initialize the unicode to sprite mapping table */

   291

	InitializeUnicodeGlyphMap();

   292

   293

	/*

   294

	 * Load the base NewGRF with OTTD required graphics as first NewGRF.

   295

	 * However, we do not want it to show up in the list of used NewGRFs,

   296

	 * so we have to manually add it, and then remove it later.

   297

	 */

   298

	GRFConfig *top = _grfconfig;

   299

	GRFConfig *master = CallocT<GRFConfig>(1);

   300

	master->filename = strdup(_used_graphics_set->files[GFT_EXTRA].filename);

   301

	FillGRFDetails(master, false);

   302

	ClrBit(master->flags, GCF_INIT_ONLY);

   303

	master->next = top;

   304

	_grfconfig = master;

   305

   307

	LoadNewGRF(SPR_NEWGRFS_BASE, i);

   308

   309

	/* Free and remove the top element. */

   310

	ClearGRFConfig(&master);

   311

	_grfconfig = top;

   312

}

   313

   314

   315

void GfxLoadSprites()

   316

{

   317

	DEBUG(sprite, 2, "Loading sprite set %d", _settings_game.game_creation.landscape);

   318

   319

	GfxInitSpriteMem();

   320

	LoadSpriteTables();

   321

	GfxInitPalettes();

   322

}

   323

   324

/**

   325

 * Try to read a single piece of metadata and return false if it doesn't exist.

   326

 * @param name the name of the item to fetch.

   327

 */

   328

#define fetch_metadata(name) \

   329

	item = metadata->GetItem(name, false); \

   330

	if (item == NULL || strlen(item->value) == 0) { \

   331

		DEBUG(grf, 0, "Base graphics set detail loading: %s field missing", name); \

   332

		return false; \

   333

	}

   334

   335

/** Names corresponding to the GraphicsFileType */

   336

static const char *_gft_names[MAX_GFT] = { "base", "logos", "arctic", "tropical", "toyland", "extra" };

   337

   338

/**

   339

 * Read the graphics set information from a loaded ini.

   340

 * @param graphics the graphics set to write to

   341

 * @param ini      the ini to read from

   342

 * @param path     the path to this ini file (for filenames)

   343

 * @return true if loading was successful.

   344

 */

   345

static bool FillGraphicsSetDetails(GraphicsSet *graphics, IniFile *ini, const char *path)

   346

{

   347

	memset(graphics, 0, sizeof(*graphics));

   348

   349

	IniGroup *metadata = ini->GetGroup("metadata");

   350

	IniItem *item;

   351

   352

	fetch_metadata("name");

   353

	graphics->name = strdup(item->value);

   354

   355

	fetch_metadata("description");

   356

	graphics->description = strdup(item->value);

   357

   358

	fetch_metadata("shortname");

   359

	for (uint i = 0; item->value[i] != '\0' && i < 4; i++) {

   360

		graphics->shortname |= ((uint8)item->value[i]) << (32 - i * 8);

   361

	}

   362

   363

	fetch_metadata("version");

   364

	graphics->version = atoi(item->value);

   365

   366

	fetch_metadata("palette");

   367

	graphics->palette = (*item->value == 'D' || *item->value == 'd') ? PAL_DOS : PAL_WINDOWS;

   368

   369

	/* For each of the graphics file types we want to find the file, MD5 checksums and warning messages. */

   370

	IniGroup *files  = ini->GetGroup("files");

   371

	IniGroup *md5s   = ini->GetGroup("md5s");

   372

	IniGroup *origin = ini->GetGroup("origin");

   373

	for (uint i = 0; i < MAX_GFT; i++) {

   374

		MD5File *file = &graphics->files[i];

   375

		/* Find the filename first. */

   376

		item = files->GetItem(_gft_names[i], false);

   377

		if (item == NULL) {

   378

			DEBUG(grf, 0, "No graphics file for: %s", _gft_names[i]);

   379

			return false;

   380

		}

   381

   382

		const char *filename = item->value;

   383

		file->filename = MallocT<char>(strlen(filename) + strlen(path) + 1);

   384

		sprintf((char*)file->filename, "%s%s", path, filename);

   385

   386

		/* Then find the MD5 checksum */

   387

		item = md5s->GetItem(filename, false);

   388

		if (item == NULL) {

   389

			DEBUG(grf, 0, "No MD5 checksum specified for: %s", filename);

   390

			return false;

   391

		}

   392

		char *c = item->value;

   393

		for (uint i = 0; i < sizeof(file->hash) * 2; i++, c++) {

   394

			uint j;

   395

			if ('0' <= *c && *c <= '9') {

   396

				j = *c - '0';

   397

			} else if ('a' <= *c && *c <= 'f') {

   398

				j = *c - 'a' + 10;

   399

			} else if ('A' <= *c && *c <= 'F') {

   400

				j = *c - 'A' + 10;

   401

			} else {

   402

				DEBUG(grf, 0, "Malformed MD5 checksum specified for: %s", filename);

   403

				return false;

   404

			}

   405

			if (i % 2 == 0) {

   406

				file->hash[i / 2] = j << 4;

   407

			} else {

   408

				file->hash[i / 2] |= j;

   409

			}

   410

		}

   411

   412

		/* Then find the warning message when the file's missing */

   413

		item = origin->GetItem(filename, false);

   414

		if (item == NULL) item = origin->GetItem("default", false);

   415

		if (item == NULL) {

   416

			DEBUG(grf, 1, "No origin warning message specified for: %s", filename);

   417

			file->missing_warning = strdup("");

   418

		} else {

   419

			file->missing_warning = strdup(item->value);

   420

		}

   421

   422

		if (FileMD5(*file)) graphics->found_grfs++;

   423

	}

   424

   425

	return true;

   426

}

   427

   428

/** Helper for scanning for files with GRF as extension */

   429

class OBGFileScanner : FileScanner {

   430

public:

   431

	/* virtual */ bool AddFile(const char *filename, size_t basepath_length);

   432

   433

	/** Do the scan for OBGs. */

   434

	static uint DoScan()

   435

	{

   436

		OBGFileScanner fs;

   437

		return fs.Scan(".obg", DATA_DIR);

   438

	}

   439

};

   440

   441

/**

   442

 * Try to add a graphics set with the given filename.

   443

 * @param filename        the full path to the file to read

   444

 * @param basepath_length amount of characters to chop of before to get a relative DATA_DIR filename

   445

 * @return true if the file is added.

   446

 */

   447

bool OBGFileScanner::AddFile(const char *filename, size_t basepath_length)

   448

{

   449

	bool ret = false;

   450

	DEBUG(grf, 1, "Found %s as base graphics set", filename);

   451

   452

	GraphicsSet *graphics = new GraphicsSet();;

   453

	IniFile *ini = new IniFile();

   454

	ini->LoadFromDisk(filename);

   455

   456

	char *path = strdup(filename + basepath_length);

   457

	char *psep = strrchr(path, PATHSEPCHAR);

   458

	if (psep != NULL) {

   459

		psep[1] = '\0';

   460

	} else {

   461

		*path = '\0';

   462

	}

   463

   464

	if (FillGraphicsSetDetails(graphics, ini, path)) {

   465

		bool duplicate = false;

   466

		for (const GraphicsSet *c = _available_graphics_sets; !duplicate && c != NULL; c = c->next) {

   467

			duplicate = (strcmp(c->name, graphics->name) == 0) || (c->shortname == graphics->shortname && c->version == graphics->version);

   468

		}

   469

		if (duplicate) {

   470

			delete graphics;

   471

		} else {

   472

			graphics->next = _available_graphics_sets;

   473

			_available_graphics_sets = graphics;

   474

			ret = true;

   475

		}

   476

	} else {

   477

		delete graphics;

   478

	}

   479

	free(path);

   480

   481

	delete ini;

   482

	return ret;

   483

}

   484

   485

   486

   487

/** Scan for all Grahpics sets */

   488