1

/* $Id$ */

     2

     3

#ifndef ENGINE_H

     4

#define ENGINE_H

     5

     6

/** @file engine.h

     7

  */

     8

     9

#include "sprite.h"

    10

    11

typedef struct RailVehicleInfo {

    12

	byte image_index;

    13

	byte flags; /* 1=multihead engine, 2=wagon */

    14

	byte base_cost;

    15

	uint16 max_speed;

    16

	uint16 power;

    17

	byte weight;

    18

	byte running_cost_base;

    19

	byte engclass; // 0: steam, 1: diesel, 2: electric

    20

	byte capacity;

    21

	byte cargo_type;

    22

	byte callbackmask; // see CallbackMask enum

    23

	uint16 pow_wag_power;

    24

	byte pow_wag_weight;

    25

	byte visual_effect; // NOTE: this is not 100% implemented yet, at the moment it is only used as a 'fallback' value

    26

	                    //       for when the 'powered wagon' callback fails. But it should really also determine what

    27

	                    //       kind of visual effect to generate for a vehicle (default, steam, diesel, electric).

    28

	                    //       Same goes for the callback result, which atm is only used to check if a wagon is powered.

    29

	byte shorten_factor;	// length on main map for this type is 8 - shorten_factor

    30

} RailVehicleInfo;

    31

    32

typedef struct ShipVehicleInfo {

    33

	byte image_index;

    34

	byte base_cost;

    35

	uint16 max_speed;

    36

	byte cargo_type;

    37

	uint16 capacity;

    38

	byte running_cost;

    39

	byte sfx;

    40

	byte refittable;

    41

} ShipVehicleInfo;

    42

    43

typedef struct AircraftVehicleInfo {

    44

	byte image_index;

    45

	byte base_cost;

    46

	byte running_cost;

    47

	byte subtype;

    48

	byte sfx;

    49

	byte acceleration;

    50

	byte max_speed;

    51

	byte mail_capacity;

    52

	uint16 passenger_capacity;

    53

} AircraftVehicleInfo;

    54

    55

typedef struct RoadVehicleInfo {

    56

	byte image_index;

    57

	byte base_cost;

    58

	byte running_cost;

    59

	byte sfx;

    60

	byte max_speed;

    61

	byte capacity;

    62

	byte cargo_type;

    63

} RoadVehicleInfo;

    64

    65

/** Information about a vehicle

    66

  * @see table/engines.h

    67

  */

    68

typedef struct EngineInfo {

    69

	uint16 base_intro;

    70

	byte unk2;              ///< Carriages have the highest bit set in this one

    71

	byte lifelength;

    72

	byte base_life;

    73

	byte railtype_climates; ///< contains the railtype in the lower four bits, and a mask to the climates where the vehicle is available in the upper four

    74

} EngineInfo;

    75

    76

typedef struct Engine {

    77

	uint16 intro_date;

    78

	uint16 age;

    79

	uint16 reliability;

    80

	uint16 reliability_spd_dec;

    81

	uint16 reliability_start, reliability_max, reliability_final;

    82

	uint16 duration_phase_1, duration_phase_2, duration_phase_3;

    83

	byte lifelength;

    84

	byte flags;

    85

	byte preview_player;

    86

	byte preview_wait;

    87

	byte railtype;

    88

	byte player_avail;

    89

	byte type;				// type, ie VEH_Road, VEH_Train, etc. Same as in vehicle.h

    90

} Engine;

    91

    92

    93

enum {

    94

	RVI_MULTIHEAD = 1,

    95

	RVI_WAGON = 2,

    96

};

    97

    98

enum {

    99

	NUM_VEHICLE_TYPES = 6

   100

};

   101

   102

void AddTypeToEngines(void);

   103

void StartupEngines(void);

   104

   105

enum GlobalCargo {

   106

	GC_PASSENGERS   =   0,

   107

	GC_COAL         =   1,

   108

	GC_MAIL         =   2,

   109

	GC_OIL          =   3,

   110

	GC_LIVESTOCK    =   4,

   111

	GC_GOODS        =   5,

   112

	GC_GRAIN        =   6, // GC_WHEAT / GC_MAIZE

   113

	GC_WOOD         =   7,

   114

	GC_IRON_ORE     =   8,

   115

	GC_STEEL        =   9,

   116

	GC_VALUABLES    =  10, // GC_GOLD / GC_DIAMONDS

   117

	GC_PAPER        =  11,

   118

	GC_FOOD         =  12,

   119

	GC_FRUIT        =  13,

   120

	GC_COPPER_ORE   =  14,

   121

	GC_WATER        =  15,

   122

	GC_RUBBER       =  16,

   123

	GC_SUGAR        =  17,

   124

	GC_TOYS         =  18,

   125

	GC_BATTERIES    =  19,

   126

	GC_CANDY        =  20,

   127

	GC_TOFFEE       =  21,

   128

	GC_COLA         =  22,

   129

	GC_COTTON_CANDY =  23,

   130

	GC_BUBBLES      =  24,

   131

	GC_PLASTIC      =  25,

   132

	GC_FIZZY_DRINKS =  26,

   133

	GC_PAPER_TEMP   =  27,

   134

	GC_UNDEFINED    =  28, // undefined; unused slot in arctic climate

   135

	GC_DEFAULT      =  29,

   136

	GC_PURCHASE     =  30,

   137

	GC_INVALID      = 255,

   138

	NUM_GLOBAL_CID  =  31

   139

};

   140

   141

// This enum lists the implemented callbacks

   142

// Use as argument for the GetCallBackResult function (see comments there)

   143

enum CallbackID {

   144

	// Powered wagons, if the result is lower as 0x40 then the wagon is powered

   145

	// TODO: interpret the rest of the result, aka "visual effects"

   146

	CBID_WAGON_POWER = 0x10,

   147

   148

	// Vehicle length, returns the amount of 1/8's the vehicle is shorter

   149

	// only for train vehicles

   150

	CBID_VEH_LENGTH = 0x11,

   151

   152

	// Refit capacity, the passed vehicle needs to have its ->cargo_type set to

   153

	// the cargo we are refitting to, returns the new cargo capacity

   154

	CBID_REFIT_CAP = 0x15,

   155

};

   156

   157

// bit positions for rvi->callbackmask, indicates which callbacks are used by an engine

   158

// (some callbacks are always used, and dont appear here)

   159

enum CallbackMask {

   160

	CBM_WAGON_POWER = 0,

   161

	CBM_VEH_LENGTH = 1,

   162

	CBM_REFIT_CAP = 3,

   163

};

   164

   165

enum {

   166

	CALLBACK_FAILED = 0xFFFF

   167

};

   168

   169

VARDEF const uint32 _default_refitmasks[NUM_VEHICLE_TYPES];

   170

VARDEF const CargoID _global_cargo_id[NUM_LANDSCAPE][NUM_CARGO];

   171

VARDEF const uint32 _landscape_global_cargo_mask[NUM_LANDSCAPE];

   172

VARDEF const CargoID _local_cargo_id_ctype[NUM_GLOBAL_CID];

   173

   174

VARDEF uint32 _engine_refit_masks[256];

   175

VARDEF byte _engine_original_sprites[256];

   176

void SetWagonOverrideSprites(byte engine, struct SpriteGroup *group, byte *train_id, int trains);

   177

void SetCustomEngineSprites(byte engine, byte cargo, struct SpriteGroup *group);

   178

// loaded is in percents, overriding_engine 0xffff is none

   179

int GetCustomEngineSprite(byte engine, const Vehicle *v, byte direction);

   180

uint16 GetCallBackResult(uint16 callback_info, byte engine, const Vehicle *v);

   181

bool UsesWagonOverride(const Vehicle *v);

   182

#define GetCustomVehicleSprite(v, direction) GetCustomEngineSprite(v->engine_type, v, direction)

   183

#define GetCustomVehicleIcon(et, direction) GetCustomEngineSprite(et, NULL, direction)

   184

   185

typedef enum VehicleTrigger {

   186

	VEHICLE_TRIGGER_NEW_CARGO = 1,

   187

	// Externally triggered only for the first vehicle in chain

   188

	VEHICLE_TRIGGER_DEPOT = 2,

   189

	// Externally triggered only for the first vehicle in chain, only if whole chain is empty

   190

	VEHICLE_TRIGGER_EMPTY = 4,

   191

	// Not triggered externally (called for the whole chain if we got NEW_CARGO)

   192

	VEHICLE_TRIGGER_ANY_NEW_CARGO = 8,

   193

} VehicleTrigger;

   194

void TriggerVehicle(Vehicle *veh, VehicleTrigger trigger);

   195

   196

void SetCustomEngineName(int engine, const char *name);

   197

StringID GetCustomEngineName(int engine);

   198

   199

   200

void DrawTrainEngine(int x, int y, int engine, uint32 image_ormod);

   201

void DrawRoadVehEngine(int x, int y, int engine, uint32 image_ormod);

   202

void DrawShipEngine(int x, int y, int engine, uint32 image_ormod);

   203

void DrawAircraftEngine(int x, int y, int engine, uint32 image_ormod);

   204

   205

void AcceptEnginePreview(Engine *e, PlayerID player);

   206

   207

void LoadCustomEngineNames(void);

   208

void DeleteCustomEngineNames(void);

   209

   210

bool IsEngineBuildable(uint engine, byte type);

   211

void UnInitNewgrEngines(void);

   212

   213

enum {

   214

	NUM_NORMAL_RAIL_ENGINES = 54,

   215

	NUM_MONORAIL_ENGINES = 30,

   216

	NUM_MAGLEV_ENGINES = 32,

   217

	NUM_TRAIN_ENGINES = NUM_NORMAL_RAIL_ENGINES + NUM_MONORAIL_ENGINES + NUM_MAGLEV_ENGINES,

   218

	NUM_ROAD_ENGINES = 88,

   219

	NUM_SHIP_ENGINES = 11,

   220

	NUM_AIRCRAFT_ENGINES = 41,

   221

	TOTAL_NUM_ENGINES = NUM_TRAIN_ENGINES + NUM_ROAD_ENGINES + NUM_SHIP_ENGINES + NUM_AIRCRAFT_ENGINES,

   222

	AIRCRAFT_ENGINES_INDEX = NUM_TRAIN_ENGINES + NUM_ROAD_ENGINES + NUM_SHIP_ENGINES,

   223

	SHIP_ENGINES_INDEX = NUM_TRAIN_ENGINES + NUM_ROAD_ENGINES,

   224

	ROAD_ENGINES_INDEX = NUM_TRAIN_ENGINES,

   225

};

   226

VARDEF Engine _engines[TOTAL_NUM_ENGINES];

   227

#define FOR_ALL_ENGINES(e) for (e = _engines; e != endof(_engines); e++)

   228

   229

static inline Engine* GetEngine(uint i)

   230

{

   231

  assert(i < lengthof(_engines));

   232

  return &_engines[i];

   233

}

   234

   235

VARDEF StringID _engine_name_strings[TOTAL_NUM_ENGINES];

   236

   237

static inline bool IsEngineIndex(uint index)

   238

{

   239

	return index < TOTAL_NUM_ENGINES;

   240

}

   241

   242

/* Access Vehicle Data */

   243

//#include "table/engines.h"

   249

   257

{

   258

	assert(e < lengthof(_rail_vehicle_info));

   259

	return &_rail_vehicle_info[e];

   260

}

   261

   263

{

   264

	assert(e - SHIP_ENGINES_INDEX < lengthof(_ship_vehicle_info));

   265

	return &_ship_vehicle_info[e - SHIP_ENGINES_INDEX];

   266

}

   267

   269

{

   270

	assert(e - AIRCRAFT_ENGINES_INDEX < lengthof(_aircraft_vehicle_info));

   271

	return &_aircraft_vehicle_info[e - AIRCRAFT_ENGINES_INDEX];

   272

}

   273

   275

{

   276

	assert(e - ROAD_ENGINES_INDEX < lengthof(_road_vehicle_info));

   277

	return &_road_vehicle_info[e - ROAD_ENGINES_INDEX];

   278

}

   279

   280

#endif /* ENGINE_H */