1

/* $Id$ */

     2

     3

/** @file newgrf_commons.cpp Implementation of the class OverrideManagerBase

     4

 * and its descendance, present and futur

     5

 */

     6

     7

#include "stdafx.h"

     8

#include "openttd.h"

     9

#include "variables.h"

    10

#include "landscape.h"

    11

#include "town.h"

    12

#include "industry.h"

    13

#include "newgrf.h"

    14

#include "newgrf_commons.h"

    15

    16

/** Constructor of generic class

    17

 * @param offset end of original data for this entity. i.e: houses = 110

    18

 * @param maximum of entities this manager can deal with. i.e: houses = 512

    19

 * @param invalid is the ID used to identify an invalid entity id

    20

 */

    21

OverrideManagerBase::OverrideManagerBase(uint16 offset, uint16 maximum, uint16 invalid)

    22

{

    23

	max_offset = offset;

    24

	max_new_entities = maximum;

    25

	invalid_ID = invalid;

    26

    27

	mapping_ID = CallocT<EntityIDMapping>(max_new_entities);

    28

	entity_overrides = MallocT<uint16>(max_offset);

    29

	memset(entity_overrides, invalid, sizeof(entity_overrides));

    30

	grfid_overrides = CallocT<uint32>(max_offset);

    31

}

    32

    33

/** Destructor of the generic class.

    34

 * Frees allocated memory of constructor

    35

 */

    36

OverrideManagerBase::~OverrideManagerBase()

    37

{

    38

	free(mapping_ID);

    39

	free(entity_overrides);

    40

	free(grfid_overrides);

    41

}

    42

    43

/** Since the entity IDs defined by the GRF file does not necessarily correlate

    44

 * to those used by the game, the IDs used for overriding old entities must be

    45

 * translated when the entity spec is set.

    46

 * @param local_id ID in grf file

    47

 * @param grfid  ID of the grf file

    48

 * @param entity_type original entity type

    49

 */

    50

void OverrideManagerBase::Add(uint8 local_id, uint32 grfid, uint entity_type)

    51

{

    52

	assert(entity_type < max_offset);

    55

	entity_overrides[entity_type] = local_id;

    56

	grfid_overrides[entity_type] = grfid;

    57

}

    58

    59

/** Resets the mapping, which is used while initializing game */

    60

void OverrideManagerBase::ResetMapping()

    61

{

    62

	memset(mapping_ID, 0, (max_new_entities - 1) * sizeof(EntityIDMapping));

    63

}

    64

    65

/** Resets the override, which is used while initializing game */

    66

void OverrideManagerBase::ResetOverride()

    67

{

    68

	for (uint16 i = 0; i < max_offset; i++) {

    69

		entity_overrides[i] = invalid_ID;

    70

		grfid_overrides[i] = 0;

    71

	}

    72

}

    73

    74

/** Return the ID (if ever available) of a previously inserted entity.

    75

 * @param grf_local_id ID of this enity withing the grfID

    76

 * @param grfid ID of the grf file

    77

 * @return the ID of the candidate, of the Invalid flag item ID

    78

 */

    79

uint16 OverrideManagerBase::GetID(uint8 grf_local_id, uint32 grfid)

    80

{

    81

	const EntityIDMapping *map;

    82

    83

	for (uint16 id = 0; id < max_new_entities; id++) {

    84

		map = &mapping_ID[id];

    85

		if (map->entity_id == grf_local_id && map->grfid == grfid) {

    86

			return id;

    87

		}

    88

	}

    89

	return invalid_ID;

    90

}

    91

    92

/** Reserves a place in the mapping array for an entity to be installed

    93

 * @param grf_local_id is an arbitrary id given by the grf's author.  Also known as setid

    94

 * @param grfid is the id of the grf file itself

    95

 * @param substitute_id is the original entity from which data is copied for the new one

    96

 * @return the proper usable slot id, or invalid marker if none is found

    97

 */

    98

uint16 OverrideManagerBase::AddEntityID(byte grf_local_id, uint32 grfid, byte substitute_id)

    99

{

   100

	uint16 id = this->GetID(grf_local_id, grfid);

   101

	EntityIDMapping *map;

   102

   103

	/* Look to see if this entity has already been added. This is done

   104

	 * separately from the loop below in case a GRF has been deleted, and there

   105

	 * are any gaps in the array.

   106

	 */

   107

	if (id != invalid_ID) {

   108

		return id;

   109

	}

   110

   111

	/* This entity hasn't been defined before, so give it an ID now. */

   112

	for (id = max_offset; id < max_new_entities; id++) {

   113

		map = &mapping_ID[id];

   114

   115

		if (CheckValidNewID(id) && map->entity_id == 0 && map->grfid == 0) {

   116

			map->entity_id     = grf_local_id;

   117

			map->grfid         = grfid;

   118

			map->substitute_id = substitute_id;

   119

			return id;

   120

		}

   121

	}

   122

   123

	return invalid_ID;

   124

}

   125

   126

/** Gives the substitute of the entity, as specified by the grf file

   127

 * @param entity_id of the entity being queried

   128

 * @return mapped id

   129

 */

   130

uint16 OverrideManagerBase::GetSubstituteID(byte entity_id)

   131

{

   132

	return mapping_ID[entity_id].substitute_id;

   133

}

   134

   135

/** Install the specs into the HouseSpecs array

   136

 * It will find itself the proper slot onwhich it will go

   137

 * @param hs HouseSpec read from the grf file, ready for inclusion

   138

 */

   139

void HouseOverrideManager::SetEntitySpec(const HouseSpec *hs)

   140

{

   141

	HouseID house_id = this->AddEntityID(hs->local_id, hs->grffile->grfid, hs->substitute_id);

   142

   143

	if (house_id == invalid_ID) {

   144

		grfmsg(1, "House.SetEntitySpec: Too many houses allocated. Ignoring.");

   145

		return;

   146

	}

   147

   148

	memcpy(&_house_specs[house_id], hs, sizeof(*hs));

   149

   150

	/* Now add the overrides. */

   151

	for (int i = 0; i != max_offset; i++) {

   152

		HouseSpec *overridden_hs = GetHouseSpecs(i);

   153

   154

		if (entity_overrides[i] != hs->local_id || grfid_overrides[i] != hs->grffile->grfid) continue;

   155

   156

		overridden_hs->override = house_id;

   157

		entity_overrides[i] = invalid_ID;

   158

		grfid_overrides[i] = 0;

   159

	}

   160

}

   161

   162

/** Method to find an entity ID and to mark it as reserved for the Industry to be included.

   163

 * @param grf_local_id ID used by the grf file for pre-installation work (equivalent of TTDPatch's setid

   164

 * @param grfid ID of the current grf file

   165

 * @param substitute_id industry from which data has been copied

   166

 * @return a free entity id (slotid) if ever one has been found, or Invalid_ID marker otherwise

   167

 */

   168

uint16 IndustryOverrideManager::AddEntityID(byte grf_local_id, uint32 grfid, byte substitute_id)

   169

{

   170

	/* This entity hasn't been defined before, so give it an ID now. */

   171

	for (uint16 id = 0; id < max_new_entities; id++) {

   172

		/* Get the real live industry */

   173

		const IndustrySpec *inds = GetIndustrySpec(id);

   174

   175

		/* This industry must be one that is not available(enabled), mostly because of climate.

   176

		 * And it must not already be used by a grf (grffile == NULL).

   177

		 * So reseve this slot here, as it is the chosen one */

   178

		if (!inds->enabled && inds->grf_prop.grffile == NULL) {

   179

			EntityIDMapping *map = &mapping_ID[id];

   180

   181

			if (map->entity_id == 0 && map->grfid == 0) {

   182

				/* winning slot, mark it as been used */

   183

				map->entity_id     = grf_local_id;

   184

				map->grfid         = grfid;

   185

				map->substitute_id = substitute_id;

   186

				return id;

   187

			}

   188

		}

   189

	}

   190

   191

	return invalid_ID;

   192

}

   193

   194

/** Method to install the new indistry data in its proper slot

   195

 * The slot assigment is internal of this method, since it requires

   196

 * checking what is available

   197

 * @param inds Industryspec that comes from the grf decoding process

   198

 */

   199

void IndustryOverrideManager::SetEntitySpec(IndustrySpec *inds)

   200

{

   201

	/* First step : We need to find if this industry is already specified in the savegame data */

   202

	IndustryType ind_id = this->GetID(inds->grf_prop.local_id, inds->grf_prop.grffile->grfid);

   203

   204

	if (ind_id == invalid_ID) { // not found?  So this is the introduction of a new industry

   205

		/* Second step is dealing with the override. */

   206

		if (inds->grf_prop.override != invalid_ID && _industry_specs[inds->grf_prop.override].grf_prop.grffile == NULL) {

   207

			/* this is an override, which means it will take the place of the industry it is

   208

			 * designed to replace. Before we conclude that the override is allowed,

   209

			* we first need to verify that the slot is not holding another industry from a grf

   210

			* If it's the case,it will be considered as a normal substitute */

   211

			ind_id = inds->grf_prop.override;

   212

		} else {

   213

			/* It has already been overriden, so you've lost your place old boy.

   214

			 * Or it is a simple substitute.

   215

			 * In both case, we need to find a free available slot */

   216

			ind_id = this->AddEntityID(inds->grf_prop.local_id, inds->grf_prop.grffile->grfid, inds->grf_prop.subst_id);

   217

			inds->grf_prop.override = invalid_ID;  // make sure it will not be detected as overriden

   218

		}

   219

	}

   220

   221

	if (ind_id == invalid_ID) {

   222

		grfmsg(1, "Industry.SetEntitySpec: Too many industries allocated. Ignoring.");

   223

		return;

   224

	}

   225

   226

	/* Now that we know we can use the given id, copy the spech to its final destination*/

   227

	memcpy(&_industry_specs[ind_id], inds, sizeof(*inds));

   228

	/* and mark it as usable*/

   229

	_industry_specs[ind_id].enabled = true;

   230

}

   231

   232

void IndustryTileOverrideManager::SetEntitySpec(const IndustryTileSpec *its)

   233

{

   234

	IndustryGfx indt_id = this->AddEntityID(its->grf_prop.local_id, its->grf_prop.grffile->grfid, its->grf_prop.subst_id);

   235

   236

	if (indt_id == invalid_ID) {

   237

		grfmsg(1, "IndustryTile.SetEntitySpec: Too many industry tiles allocated. Ignoring.");

   238

		return;

   239

	}

   240

   241

	memcpy(&_industry_tile_specs[indt_id], its, sizeof(*its));

   242

   243

	/* Now add the overrides. */

   244

	for (int i = 0; i < max_offset; i++) {

   245

		IndustryTileSpec *overridden_its = &_industry_tile_specs[i];

   246

   247

		if (entity_overrides[i] != its->grf_prop.local_id || grfid_overrides[i] != its->grf_prop.grffile->grfid) continue;

   248

   249

		overridden_its->grf_prop.override = indt_id;

   250

		overridden_its->enabled = false;

   251

		entity_overrides[i] = invalid_ID;

   252

		grfid_overrides[i] = 0;

   253

	}

   254

}

   255

   256

/** Function used by houses (and soon industries) to get information

   257

 * on type of "terrain" the tile it is queries sits on.

   258

 * @param tile TileIndex of the tile been queried

   259

 * @return value corresponding to the grf expected format:

   260

 *         Terrain type: 0 normal, 1 desert, 2 rainforest, 4 on or above snowline */

   261

uint32 GetTerrainType(TileIndex tile)

   262

{

   263

	switch (_opt.landscape) {

   264

		case LT_TROPIC: return GetTropicZone(tile) == TROPICZONE_DESERT ? 1 : 2;

   265

		case LT_ARCTIC: return GetTileZ(tile) > GetSnowLine() ? 4 : 0;

   266

		default:        return 0;

   267

	}

   268

}

   269

   270

TileIndex GetNearbyTile(byte parameter, TileIndex tile)

   271

{

   272

	int8 x = GB(parameter, 0, 4);

   273

	int8 y = GB(parameter, 4, 4);

   274

   275

	if (x >= 8) x -= 16;

   276

	if (y >= 8) y -= 16;

   277

   278

	/* Make sure we never roam outside of the map */

   279

	return TILE_MASK(tile + TileDiffXY(x, y));

   280

}