1

/* $Id$ */

     2

     3

/** @file industry.h */

     4

     5

#ifndef INDUSTRY_H

     6

#define INDUSTRY_H

     7

     8

#include "oldpool.h"

     9

#include "helpers.hpp"

    10

    11

typedef byte IndustryGfx;

    12

typedef uint8 IndustryType;

    13

    14

enum {

    15

	INVALID_INDUSTRY       = 0xFFFF,

    16

	NEW_INDUSTRYOFFSET     = 37,                         ///< original number of industries

    17

	NUM_INDUSTRYTYPES      = 37,                         ///< total number of industries, new and old

    18

	INDUSTRYTILE_NOANIM    = 0xFF,                       ///< flag to mark industry tiles as having no animation

    19

	NEW_INDUSTRYTILEOFFSET = 175,                        ///< original number of tiles

    20

	INVALID_INDUSTRYTYPE   = NUM_INDUSTRYTYPES,          ///< one above amount is considered invalid

    21

	NUM_INDUSTRYTILES      = NEW_INDUSTRYTILEOFFSET,     ///< total number of industry tiles, new and old

    22

	INVALID_INDUSTRYTILE   = NUM_INDUSTRYTILES,          ///< one above amount is considered invalid

    23

};

    24

    25

enum {

    26

	CLEAN_RANDOMSOUNDS,    ///< Free the dynamically allocated sounds table

    27

	CLEAN_TILELSAYOUT,     ///< Free the dynamically allocated tile layout structure

    28

};

    29

    30

enum IndustryLifeType {

    31

	INDUSTRYLIFE_BLACK_HOLE =      0, ///< Like power plants and banks

    32

	INDUSTRYLIFE_EXTRACTIVE = 1 << 0, ///< Like mines

    33

	INDUSTRYLIFE_ORGANIC    = 1 << 1, ///< Like forests

    34

	INDUSTRYLIFE_PROCESSING = 1 << 2, ///< Like factories

    35

};

    36

    37

/* Procedures that can be run to check whether an industry may

    38

 * build at location the given to the procedure */

    39

enum CheckProc {

    40

	CHECK_NOTHING,

    41

	CHECK_FOREST,

    42

	CHECK_REFINERY,

    43

	CHECK_FARM,

    44

	CHECK_PLANTATION,

    45

	CHECK_WATER,

    46

	CHECK_LUMBERMILL,

    47

	CHECK_BUBBLEGEN,

    48

	CHECK_OIL_RIG,

    49

	CHECK_END,

    50

};

    51

    52

enum IndustryConstructionType {

    53

	ICT_UNKNOWN,

    54

	ICT_NORMAL_GAMEPLAY,

    55

	ICT_MAP_GENERATION,

    56

	ICT_SCENARIO_EDITOR

    57

};

    58

    59

enum IndustyBehaviour {

    60

	INDUSTRYBEH_NONE                  =      0,

    61

	INDUSTRYBEH_PLANT_FIELDS          = 1 << 0,  ///< periodically plants fileds around itself (temp and artic farms)

    62

	INDUSTRYBEH_CUT_TREES             = 1 << 1,  ///< cuts trees and produce first output cargo from them (lumber mill)

    63

	INDUSTRYBEH_BUILT_ONWATER         = 1 << 2,  ///< is built on water (oil rig)

    64

	INDUSTRYBEH_TOWN1200_MORE         = 1 << 3,  ///< can only be built in towns larger then 1200 inhabitants (temperate bank)

    65

	INDUSTRYBEH_ONLY_INTOWN           = 1 << 4,  ///< can only be built in towns (arctic/tropic banks, water tower)

    66

	INDUSTRYBEH_ONLY_NEARTOWN         = 1 << 5,  ///< is always built near towns (toy shop)

    67

	INDUSTRYBEH_PLANT_ON_BUILT        = 1 << 6,  ///< Fields are planted around when built (all farms)

    68

	INDUSTRYBEH_DONT_INCR_PROD        = 1 << 7,  ///< do not increase production (oil wells) in the temperate climate

    69

	INDUSTRYBEH_BEFORE_1950           = 1 << 8,  ///< can only be built before 1950 (oil wells)

    70

	INDUSTRYBEH_AFTER_1960            = 1 << 9,  ///< can only be built after 1960 (oil rigs)

    71

	INDUSTRYBEH_AI_AIRSHIP_ROUTES     = 1 << 10, ///< ai will attempt to establish air/ship routes to this industry (oil rig)

    72

	INDUSTRYBEH_AIRPLANE_ATTACKS      = 1 << 11, ///< can be exploded by a military airplane (oil refinery)

    73

	INDUSTRYBEH_CHOPPER_ATTACKS       = 1 << 12, ///< can be exploded by a military helicopter (factory)

    74

	INDUSTRYBEH_CAN_SUBSIDENCE        = 1 << 13, ///< can cause a subsidence (coal mine, shaft that collapses)

    75

};

    76

    77

    78

DECLARE_ENUM_AS_BIT_SET(IndustyBehaviour);

    79

    80

/**

    81

 * Defines the internal data of a functionnal industry

    82

 */

    83

struct Industry {

    84

	TileIndex xy;                       ///< coordinates of the primary tile the industry is built one

    85

	byte width;

    86

	byte height;

    87

	const Town *town;                   ///< Nearest town

    88

	uint16 produced_cargo_waiting[2];   ///< amount of cargo produced per cargo

    89

	uint16 incoming_cargo_waiting[3];   ///< incoming cargo waiting to be processed

    90

	byte production_rate[2];            ///< production rate for each cargo

    91

	byte prod_level;                    ///< general production level

    92

	uint16 this_month_production[2];    ///< stats of this month's production per cargo

    93

	uint16 this_month_transported[2];   ///< stats of this month's transport per cargo

    94

	byte last_month_pct_transported[2]; ///< percentage transported per cargo in the last full month

    95

	uint16 last_month_production[2];    ///< total units produced per cargo in the last full month

    96

	uint16 last_month_transported[2];   ///< total units transported per cargo in the last full month

    97

	uint16 counter;                     ///< used for animation and/or production (if available cargo)

    98

    99

	IndustryType type;                  ///< type of industry. see IT_COAL_MINE and others

   100

	OwnerByte owner;                    ///< owner of the industry.  Which SHOULD always be (imho) OWNER_NONE

   101

	byte random_color;                  ///< randomized colour of the industry, for display purpose

   102

	Year last_prod_year;                ///< last year of production

   103

	byte was_cargo_delivered;           ///< flag that indicate this has been the closest industry chosen for cargo delivery by a station. see DeliverGoodsToIndustry

   104

   105

	IndustryID index;                   ///< index of the industry in the pool of industries

   106

   107

	OwnerByte founder;                  ///< Founder of the industry

   108

	Date construction_date;             ///< Date of the construction of the industry

   109

	uint8 construction_type;            ///< Way the industry was constructed (@see IndustryConstructionType)

   110

	Date last_cargo_accepted_at;        ///< Last day cargo was accepted by this industry

   111

};

   112

   113

struct IndustryTileTable {

   114

	TileIndexDiffC ti;

   115

	IndustryGfx gfx;

   116

};

   117

   118

/** Data related to the handling of grf files.  Common to both industry and industry tile */

   119

struct GRFFileProps {

   120

	uint8 subst_id;

   121

	uint16 local_id;                      ///< id defined by the grf file for this industry

   122

	struct SpriteGroup *spritegroup;      ///< pointer to the different sprites of the industry

   123

	const struct GRFFile *grffile;        ///< grf file that introduced this industry

   124

	uint16 override;                      ///< id of the entity been replaced by

   125

};

   126

   127

/**

   128

 * Defines the data structure for constructing industry.

   129

 */

   130

struct IndustrySpec {

   131

	const IndustryTileTable *const *table;///< List of the tiles composing the industry

   132

	byte num_table;                       ///< Number of elements in the table

   133

	uint8 cost_multiplier;                ///< Base cost multiplier.

   134

	uint16 raw_industry_cost_multiplier;  ///< Multiplier for the raw industries cost

   135

	uint32 prospecting_chance;            ///< Chance prospecting succeeds

   136

	IndustryType conflicting[3];          ///< Industries this industry cannot be close to

   137

	byte check_proc;                      ///< Index to a procedure to check for conflicting circumstances

   138

	CargoID produced_cargo[2];

   139

	byte production_rate[2];

   140

	byte minimal_cargo;                   ///< minimum amount of cargo transported to the stations

   141

	                                      ///< If the waiting cargo is less than this number, no cargo is moved to it

   142

	CargoID accepts_cargo[3];             ///< 3 accepted cargos

   143

	uint16 input_cargo_multiplier[3][2];  ///< Input cargo multipliers (multiply amount of incoming cargo for the produced cargos)

   144

	IndustryLifeType life_type;           ///< This is also known as Industry production flag, in newgrf specs

   145

	byte climate_availability;            ///< Bitmask, giving landscape enums as bit position

   146

	IndustyBehaviour behaviour;           ///< How this industry will behave, and how others entities can use it

   147

	byte map_colour;                      ///< colour used for the small map

   148

	StringID name;                        ///< Displayed name of the industry

   149

	StringID new_industry_text;           ///< Message appearing when the industry is built

   150

	StringID closure_text;                ///< Message appearing when the industry closes

   151

	StringID production_up_text;          ///< Message appearing when the industry's production is increasing

   152

	StringID production_down_text;        ///< Message appearing when the industry's production is decreasing

   153

	byte appear_ingame[NUM_LANDSCAPE];    ///< Probability of appearance in game

   154

	byte appear_creation[NUM_LANDSCAPE];  ///< Probability of appearance during map creation

   155

	uint8 number_of_sounds;               ///< Number of sounds available in the sounds array

   156

	const uint8 *random_sounds;           ///< array of random sounds.

   157

	/* Newgrf data */

   158

	uint16 callback_flags;                ///< Flags telling which grf callback is set

   159

	uint8 cleanup_flag;                   ///< flags indicating which data should be freed upon cleaning up

   160

	bool enabled;                         ///< entity still avaible (by default true).newgrf can disable it, though

   161

	struct GRFFileProps grf_prop;         ///< properties related the the grf file

   162

   163

	/**

   164

	 * Is an industry with the spec a raw industry?

   165

	 * @return true if it should be handled as a raw industry

   166

	 */

   167

	bool IsRawIndustry() const;

   168

   169

	/**

   170

	 * Get the cost for constructing this industry

   171

	 * @return the cost (inflation corrected etc)

   172

	 */

   173

	Money GetConstructionCost() const;

   174

};

   175

   176

/**

   177

 * Defines the data structure of each indivudual tile of an industry.

   178

 */

   179

struct IndustryTileSpec {

   180

	CargoID accepts_cargo[3];             ///< Cargo accepted by this tile

   181

	uint8 acceptance[3];                  ///< Level of aceptance per cargo type

   182

	Slope slopes_refused;                 ///< slope pattern on which this tile cannot be built

   183

	byte anim_production;                 ///< Animation frame to start when goods are produced

   184

	byte anim_next;                       ///< Next frame in an animation

   185

	bool anim_state;                      ///< When true, the tile has to be drawn using the animation

   186

	                                      ///< state instead of the construction state

   187

	/* Newgrf data */

   188

	uint8 callback_flags;                 ///< Flags telling which grf callback is set

   193

	bool enabled;                         ///< entity still avaible (by default true).newgrf can disable it, though

   194

	struct GRFFileProps grf_prop;

   195

};

   196

   197

/* industry_cmd.cpp*/

   198

const IndustrySpec *GetIndustrySpec(IndustryType thistype);    ///< Array of industries data

   199

const IndustryTileSpec *GetIndustryTileSpec(IndustryGfx gfx);  ///< Array of industry tiles data

   200

void ResetIndustries();

   201

void PlantRandomFarmField(const Industry *i);

   202

   203

/* writable arrays of specs */

   204

extern IndustrySpec _industry_specs[NUM_INDUSTRYTYPES];

   205

extern IndustryTileSpec _industry_tile_specs[NUM_INDUSTRYTILES];

   206

   207

/* smallmap_gui.cpp */

   208

void BuildIndustriesLegend();

   209

   210

DECLARE_OLD_POOL(Industry, Industry, 3, 8000)

   211

   212

/**

   213

 * Check if an Industry really exists.

   214

 * @param industry to check

   215

 * @return true if position is a valid one

   216

 */

   217

static inline bool IsValidIndustry(const Industry *industry)

   218

{

   219

	return industry->xy != 0;

   220

}

   221

   222

/**

   223

 * Check if an Industry exists whithin the pool of industries

   224

 * @param index of the desired industry

   225

 * @return true if it is inside the pool

   226

 */

   227

static inline bool IsValidIndustryID(IndustryID index)

   228

{

   229

	return index < GetIndustryPoolSize() && IsValidIndustry(GetIndustry(index));

   230

}

   231

   232

   233

static inline IndustryID GetMaxIndustryIndex()

   234

{

   235

	/* TODO - This isn't the real content of the function, but

   236

	 *  with the new pool-system this will be replaced with one that

   237

	 *  _really_ returns the highest index. Now it just returns

   238

	 *  the next safe value we are sure about everything is below.

   239

	 */

   240

	return GetIndustryPoolSize() - 1;

   241

}

   242

   243

extern int _total_industries;  // general counter

   244

extern uint16 _industry_counts[NUM_INDUSTRYTYPES]; // Number of industries per type ingame

   245

   246

static inline uint GetNumIndustries()

   247

{

   248

	return _total_industries;

   249

}

   250

   251

/** Increment the count of industries for this type

   252

 * @param type IndustryType to increment

   253

 * @pre type < INVALID_INDUSTRYTYPE */

   254

static inline void IncIndustryTypeCount(IndustryType type)

   255

{

   256

	assert(type < INVALID_INDUSTRYTYPE);

   257

	_industry_counts[type]++;

   258

	_total_industries++;

   259

}

   260

   261

/** Decrement the count of industries for this type

   262

 * @param type IndustryType to decrement

   263

 * @pre type < INVALID_INDUSTRYTYPE */

   264

static inline void DecIndustryTypeCount(IndustryType type)

   265

{

   266

	assert(type < INVALID_INDUSTRYTYPE);

   267

	_industry_counts[type]--;

   268

	_total_industries--;

   269

}

   270

   271

/** get the count of industries for this type

   272

 * @param type IndustryType to query

   273

 * @pre type < INVALID_INDUSTRYTYPE */

   274

static inline uint8 GetIndustryTypeCount(IndustryType type)

   275

{

   276

	assert(type < INVALID_INDUSTRYTYPE);

   277

	return min(_industry_counts[type], 0xFF); // callback expects only a byte, so cut it

   278

}

   279

   280

/** Resets both the total_industries and the _industry_counts

   281

 * This way, we centralize all counts activities */

   282

static inline void ResetIndustryCounts()

   283

{

   284

	_total_industries = 0;

   285

	memset(&_industry_counts, 0, sizeof(_industry_counts));

   286

}

   287

   288

/**

   289

 * Return a random valid industry.

   290

 */

   291

static inline Industry *GetRandomIndustry()

   292

{

   293

	int num = RandomRange(GetNumIndustries());

   294

	IndustryID index = INVALID_INDUSTRY;

   295

   296

	if (GetNumIndustries() == 0) return NULL;

   297

   298

	while (num >= 0) {

   299

		num--;

   300

		index++;

   301

   302

		/* Make sure we have a valid industry */

   303

		while (!IsValidIndustryID(index)) {

   304

			index++;

   305

			assert(index <= GetMaxIndustryIndex());

   306

		}

   307

	}

   308

   309

	return GetIndustry(index);

   310

}

   311

   312

void DestroyIndustry(Industry *i);

   313

   314

static inline void DeleteIndustry(Industry *i)

   315

{

   316

	DestroyIndustry(i);

   317

	i->xy = 0;

   318

}

   319

   320

#define FOR_ALL_INDUSTRIES_FROM(i, start) for (i = GetIndustry(start); i != NULL; i = (i->index + 1U < GetIndustryPoolSize()) ? GetIndustry(i->index + 1U) : NULL) if (IsValidIndustry(i))

   321

#define FOR_ALL_INDUSTRIES(i) FOR_ALL_INDUSTRIES_FROM(i, 0)

   322

   323

extern const Industry **_industry_sort;

   324

extern bool _industry_sort_dirty;

   325

   326

enum {

   327

	IT_COAL_MINE           =   0,

   328

	IT_POWER_STATION       =   1,

   329

	IT_SAWMILL             =   2,

   330

	IT_FOREST              =   3,

   331

	IT_OIL_REFINERY        =   4,

   332

	IT_OIL_RIG             =   5,

   333

	IT_FACTORY             =   6,

   334

	IT_PRINTING_WORKS      =   7,

   335

	IT_STEEL_MILL          =   8,

   336

	IT_FARM                =   9,

   337

	IT_COPPER_MINE         =  10,

   338

	IT_OIL_WELL            =  11,

   339

	IT_BANK_TEMP           =  12,

   340

	IT_FOOD_PROCESS        =  13,

   341

	IT_PAPER_MILL          =  14,

   342

	IT_GOLD_MINE           =  15,

   343

	IT_BANK_TROPIC_ARCTIC  =  16,

   344

	IT_DIAMOND_MINE        =  17,

   345

	IT_IRON_MINE           =  18,

   346

	IT_FRUIT_PLANTATION    =  19,

   347

	IT_RUBBER_PLANTATION   =  20,

   348

	IT_WATER_SUPPLY        =  21,

   349

	IT_WATER_TOWER         =  22,

   350

	IT_FACTORY_2           =  23,

   351

	IT_FARM_2              =  24,

   352

	IT_LUMBER_MILL         =  25,

   353

	IT_COTTON_CANDY        =  26,

   354

	IT_CANDY_FACTORY       =  27,

   355

	IT_BATTERY_FARM        =  28,

   356

	IT_COLA_WELLS          =  29,

   357

	IT_TOY_SHOP            =  30,

   358

	IT_TOY_FACTORY         =  31,

   359

	IT_PLASTIC_FOUNTAINS   =  32,

   360

	IT_FIZZY_DRINK_FACTORY =  33,

   361

	IT_BUBBLE_GENERATOR    =  34,

   362

	IT_TOFFEE_QUARRY       =  35,

   363

	IT_SUGAR_MINE          =  36,

   364

	IT_END,

   365

	IT_INVALID             = 255,

   366

};

   367

   368

#endif /* INDUSTRY_H */