1

#ifndef VEHICLE_H

     2

#define VEHICLE_H

     3

     4

#include "pool.h"

     5

#include "order.h"

     6

     7

enum {

     8

	VEH_Train = 0x10,

     9

	VEH_Road = 0x11,

    10

	VEH_Ship = 0x12,

    11

	VEH_Aircraft = 0x13,

    12

	VEH_Special = 0x14,

    13

	VEH_Disaster = 0x15,

    14

} ;

    15

    16

enum VehStatus {

    17

	VS_HIDDEN = 1,

    18

	VS_STOPPED = 2,

    19

	VS_UNCLICKABLE = 4,

    20

	VS_DEFPAL = 0x8,

    21

	VS_TRAIN_SLOWING = 0x10,

    22

	VS_DISASTER = 0x20,

    23

	VS_AIRCRAFT_BROKEN = 0x40,

    24

	VS_CRASHED = 0x80,

    25

};

    26

    27

// 1 and 3 do not appear to be used

    28

typedef enum TrainSubtypes {

    29

	TS_Front_Engine = 0, // Leading engine of a train

    30

	TS_Not_First = 2,    // Wagon or additional engine

    31

	TS_Free_Car = 4,     // First in a wagon chain (in depot)

    32

} TrainSubtype;

    33

    34

/* Effect vehicle types */

    35

typedef enum EffectVehicle {

    36

	EV_CHIMNEY_SMOKE   = 0,

    37

	EV_STEAM_SMOKE     = 1,

    38

	EV_DIESEL_SMOKE    = 2,

    39

	EV_ELECTRIC_SPARK  = 3,

    40

	EV_SMOKE           = 4,

    41

	EV_EXPLOSION_LARGE = 5,

    42

	EV_BREAKDOWN_SMOKE = 6,

    43

	EV_EXPLOSION_SMALL = 7,

    44

	EV_BULLDOZER       = 8,

    45

	EV_BUBBLE          = 9

    46

} EffectVehicle;

    47

    48

typedef struct VehicleRail {

    49

	uint16 last_speed;		// NOSAVE: only used in UI

    50

	uint16 crash_anim_pos;

    51

	uint16 days_since_order_progr;

    52

    53

	// cached values, recalculated on load and each time a vehicle is added to/removed from the consist.

    54

	uint16 cached_max_speed;  // max speed of the consist. (minimum of the max speed of all vehicles in the consist)

    55

	uint32 cached_power;      // total power of the consist.

    56

	// cached values, recalculated when the cargo on a train changes (in addition to the conditions above)

    57

	uint16 cached_weight;     // total weight of the consist.

    58

	uint16 cached_veh_weight; // weight of the vehicle.

    59

    60

	// NOSAVE: for wagon override - id of the first engine in train

    61

	// 0xffff == not in train

    62

	EngineID first_engine;

    63

    64

	byte track;

    65

	byte force_proceed;

    66

	byte railtype;

    67

    68

	byte flags;

    69

} VehicleRail;

    70

    71

enum {

    72

	VRF_REVERSING = 0,

    73

    74

	// used to calculate if train is going up or down

    75

	VRF_GOINGUP   = 1,

    76

	VRF_GOINGDOWN = 2,

    77

    78

	// used to store if a wagon is powered or not

    79

	VRF_POWEREDWAGON = 3,

    80

};

    81

    82

typedef struct VehicleAir {

    83

	uint16 crashed_counter;

    84

	byte pos;

    85

  byte previous_pos;

    86

	uint16 targetairport;

    87

	byte state;

    88

} VehicleAir;

    89

    90

typedef struct VehicleRoad {

    91

	byte state;

    92

	byte frame;

    93

	uint16 unk2;

    94

	byte overtaking;

    95

	byte overtaking_ctr;

    96

	uint16 crashed_ctr;

    97

	byte reverse_ctr;

    98

	struct RoadStop *slot;

    99

	byte slotindex;

   100

	byte slot_age;

   101

} VehicleRoad;

   102

   103

typedef struct VehicleSpecial {

   104

	uint16 unk0;

   105

	byte unk2;

   106

} VehicleSpecial;

   107

   108

typedef struct VehicleDisaster {

   109

	uint16 image_override;

   110

	uint16 unk2;

   111

} VehicleDisaster;

   112

   113

typedef struct VehicleShip {

   114

	byte state;

   115

} VehicleShip;

   116

   117

// not used ATM

   118

struct WorldSprite {

   119

	struct WorldSprite *next;			// next sprite in hash chain

   120

	uint16 image;			// sprite number for this vehicle

   121

   122

	// screen coordinates

   123

	int16 left, top, right, bottom;

   124

   125

	// world coordinates

   126

	int16 x;

   127

	int16 y;

   128

	byte z;

   129

   130

	int8 x_offs;			// x offset for vehicle sprite

   131

	int8 y_offs;			// y offset for vehicle sprite

   132

   133

	byte width;				// width of vehicle sprite

   134

	byte height;			// height of vehicle sprite

   135

	byte depth;				// depth of vehicle sprite

   136

   137

	byte flags;				// draw flags

   138

};

   139

   140

struct Vehicle {

   141

	byte type;	// type, ie roadven,train,ship,aircraft,special

   142

	byte subtype;     // subtype (Filled with values from EffectVehicles or TrainSubTypes)(Filled with values from EffectVehicles or TrainSubTypes)

   143

   144

	VehicleID index;	// NOSAVE: Index in vehicle array

   145

   146

	Vehicle *next;		// next

   147

	Vehicle *first;   // NOSAVE: pointer to the first vehicle in the chain

   148

   149

	StringID string_id; // Displayed string

   150

   151

	UnitID unitnumber;	// unit number, for display purposes only

   152

	PlayerID owner;				// which player owns the vehicle?

   153

   154

	TileIndex tile;		// Current tile index

   155

	TileIndex dest_tile; // Heading for this tile

   156

   157

	int32 x_pos;			// coordinates

   158

	int32 y_pos;

   159

	byte z_pos;

   160

	byte direction;		// facing

   161

   162

	byte spritenum; // currently displayed sprite index

   163

	                // 0xfd == custom sprite, 0xfe == custom second head sprite

   164

	                // 0xff == reserved for another custom sprite

   165

	uint16 cur_image; // sprite number for this vehicle

   166

	byte sprite_width;// width of vehicle sprite

   167

	byte sprite_height;// height of vehicle sprite

   168

	byte z_height;		// z-height of vehicle sprite

   169

	int8 x_offs;			// x offset for vehicle sprite

   170

	int8 y_offs;			// y offset for vehicle sprite

   171

	EngineID engine_type;

   172

   173

	// for randomized variational spritegroups

   174

	// bitmask used to resolve them; parts of it get reseeded when triggers

   175

	// of corresponding spritegroups get matched

   176

	byte random_bits;

   177

	byte waiting_triggers; // triggers to be yet matched

   178

   179

	uint16 max_speed;	// maximum speed

   180

	uint16 cur_speed;	// current speed

   181

	byte subspeed;		// fractional speed

   182

	byte acceleration; // used by train & aircraft

   183

	byte progress;

   184

   185

	byte vehstatus;		// Status

   186

	uint16 last_station_visited;

   187

   188

	byte cargo_type;	// type of cargo this vehicle is carrying

   189

	byte cargo_days; // how many days have the pieces been in transit

   190

	uint16 cargo_source;// source of cargo

   191

	uint16 cargo_cap;	// total capacity

   192

	uint16 cargo_count;// how many pieces are used

   193

   194

	byte day_counter; // increased by one for each day

   195

	byte tick_counter;// increased by one for each tick

   196

   197

	/* Begin Order-stuff */

   198

	Order current_order;     //! The current order (+ status, like: loading)

   199

	OrderID cur_order_index; //! The index to the current order

   200

   201

	Order *orders;           //! Pointer to the first order for this vehicle

   202

	OrderID num_orders;      //! How many orders there are in the list

   203

   204

	Vehicle *next_shared;    //! If not NULL, this points to the next vehicle that shared the order

   205

	Vehicle *prev_shared;    //! If not NULL, this points to the prev vehicle that shared the order

   206

	/* End Order-stuff */

   207

   208

	// Boundaries for the current position in the world and a next hash link.

   209

	// NOSAVE: All of those can be updated with VehiclePositionChanged()

   210

	int32 left_coord;

   211

	int32 top_coord;

   212

	int32 right_coord;

   213

	int32 bottom_coord;

   214

	uint16 next_hash;

   215

   216

	// Related to age and service time

   217

	uint16 age;				// Age in days

   218

	uint16 max_age;		// Maximum age

   219

	uint16 date_of_last_service;

   220

	uint16 service_interval;

   221

	uint16 reliability;

   222

	uint16 reliability_spd_dec;

   223

	byte breakdown_ctr;

   224

	byte breakdown_delay;

   225

	byte breakdowns_since_last_service;

   226

	byte breakdown_chance;

   227

	byte build_year;

   228

   229

	uint16 load_unload_time_rem;

   230

   231

	int32 profit_this_year;

   232

	int32 profit_last_year;

   233

	uint32 value;

   234

   235

	union {

   236

		VehicleRail rail;

   237

		VehicleAir air;

   238

		VehicleRoad road;

   239

		VehicleSpecial special;

   240

		VehicleDisaster disaster;

   241

		VehicleShip ship;

   242

	} u;

   243

};

   244

   245

#define is_custom_sprite(x) (x >= 0xFD)

   246

#define IS_CUSTOM_FIRSTHEAD_SPRITE(x) (x == 0xFD)

   247

#define IS_CUSTOM_SECONDHEAD_SPRITE(x) (x == 0xFE)

   248

   249

typedef void VehicleTickProc(Vehicle *v);

   250

typedef void *VehicleFromPosProc(Vehicle *v, void *data);

   251

   252

void VehicleServiceInDepot(Vehicle *v);

   253

Vehicle *AllocateVehicle(void);

   254

Vehicle *ForceAllocateVehicle(void);

   255

Vehicle *ForceAllocateSpecialVehicle(void);

   256

void UpdateVehiclePosHash(Vehicle *v, int x, int y);

   257

void VehiclePositionChanged(Vehicle *v);

   258

void AfterLoadVehicles(void);

   259

Vehicle *GetLastVehicleInChain(Vehicle *v);

   260

Vehicle *GetPrevVehicleInChain(const Vehicle *v);

   261

Vehicle *GetFirstVehicleInChain(const Vehicle *v);

   262

int CountVehiclesInChain(Vehicle *v);

   263

void DeleteVehicle(Vehicle *v);

   264

void DeleteVehicleChain(Vehicle *v);

   265

void *VehicleFromPos(TileIndex tile, void *data, VehicleFromPosProc *proc);

   266

void CallVehicleTicks(void);

   267

Vehicle *FindVehicleOnTileZ(TileIndex tile, byte z);

   268

   269

void InitializeTrains(void);

   270

   271

bool CanFillVehicle(Vehicle *v);

   272

bool CanRefitTo(const Vehicle *v, CargoID cid_to);

   273

   274

void ViewportAddVehicles(DrawPixelInfo *dpi);

   275

   276

void TrainEnterDepot(Vehicle *v, uint tile);

   277

   278

void AddRearEngineToMultiheadedTrain(Vehicle *v, Vehicle *u, bool building) ;

   279

   280

/* train_cmd.h */

   281

int GetTrainImage(const Vehicle *v, byte direction);

   282

int GetAircraftImage(const Vehicle *v, byte direction);

   283

int GetRoadVehImage(const Vehicle *v, byte direction);

   284

int GetShipImage(const Vehicle *v, byte direction);

   285

   286

Vehicle *CreateEffectVehicle(int x, int y, int z, EffectVehicle type);

   287

Vehicle *CreateEffectVehicleAbove(int x, int y, int z, EffectVehicle type);

   288

Vehicle *CreateEffectVehicleRel(const Vehicle *v, int x, int y, int z, EffectVehicle type);

   289

   290

uint32 VehicleEnterTile(Vehicle *v, uint tile, int x, int y);

   291

   292

void VehicleInTheWayErrMsg(Vehicle *v);

   293

Vehicle *FindVehicleBetween(TileIndex from, TileIndex to, byte z);

   294

TileIndex GetVehicleOutOfTunnelTile(const Vehicle *v);

   295

   296

bool UpdateSignalsOnSegment(uint tile, byte direction);

   297

void SetSignalsOnBothDir(uint tile, byte track);

   298

   299

Vehicle *CheckClickOnVehicle(ViewPort *vp, int x, int y);

   300

//uint GetVehicleWeight(Vehicle *v);

   301

   302

void DecreaseVehicleValue(Vehicle *v);

   303

void CheckVehicleBreakdown(Vehicle *v);

   304

void AgeVehicle(Vehicle *v);

   305

void MaybeReplaceVehicle(Vehicle *v);

   306

   307

void BeginVehicleMove(Vehicle *v);

   308

void EndVehicleMove(Vehicle *v);

   309

   310

bool IsAircraftHangarTile(TileIndex tile);

   311

void ShowAircraftViewWindow(Vehicle *v);

   312

   313

UnitID GetFreeUnitNumber(byte type);

   314

   315

int LoadUnloadVehicle(Vehicle *v);

   316

   317

void TrainConsistChanged(Vehicle *v);

   318

void UpdateTrainAcceleration(Vehicle *v);

   319

int32 GetTrainRunningCost(const Vehicle *v);

   320

   321

int CheckTrainStoppedInDepot(const Vehicle *v);

   322

   323

bool VehicleNeedsService(const Vehicle *v);

   324

   325

typedef struct GetNewVehiclePosResult {

   326

	int x,y;

   327

	uint old_tile;

   328

	uint new_tile;

   329

} GetNewVehiclePosResult;

   330

   331

/**

   332

 * Returns the Trackdir on which the vehicle is currently located.

   333

 * Works for trains and ships.

   334

 * Currently works only sortof for road vehicles, since they have a fuzzy

   335

 * concept of being "on" a trackdir. Dunno really what it returns for a road

   336

 * vehicle that is halfway a tile, never really understood that part. For road

   337

 * vehicles that are at the beginning or end of the tile, should just return

   338

 * the diagonal trackdir on which they are driving. I _think_.

   339

 * For other vehicles types, or vehicles with no clear trackdir (such as those

   340

 * in depots), returns 0xFF.

   341

 */

   342

byte GetVehicleTrackdir(const Vehicle* v);

   343

   344

/* returns true if staying in the same tile */

   345

bool GetNewVehiclePos(Vehicle *v, GetNewVehiclePosResult *gp);

   346

byte GetDirectionTowards(Vehicle *v, int x, int y);

   347

   348

#define BEGIN_ENUM_WAGONS(v) do {

   349

#define END_ENUM_WAGONS(v) } while ( (v=v->next) != NULL);

   350

   351

/* vehicle.c */

   352

VARDEF SortStruct *_vehicle_sort;

   353

   354

extern MemoryPool _vehicle_pool;

   355

   356

/**

   357

 * Get the pointer to the vehicle with index 'index'

   358

 */

   359

static inline Vehicle *GetVehicle(VehicleID index)

   360

{

   361

	return (Vehicle*)GetItemFromPool(&_vehicle_pool, index);

   362

}

   363

   364

/**

   365

 * Get the current size of the VehiclePool

   366

 */

   367

static inline uint16 GetVehiclePoolSize(void)

   368

{

   369

	return _vehicle_pool.total_items;

   370

}

   371

   372

#define FOR_ALL_VEHICLES_FROM(v, start) for (v = GetVehicle(start); v != NULL; v = (v->index + 1 < GetVehiclePoolSize()) ? GetVehicle(v->index + 1) : NULL)

   373

#define FOR_ALL_VEHICLES(v) FOR_ALL_VEHICLES_FROM(v, 0)

   374

   375

/**

   376

 * Check if a Vehicle really exists.

   377

 */

   378

static inline bool IsValidVehicle(const Vehicle *v)

   379

{

   380

	return v->type != 0;

   381

}

   382

   383

/**

   384

 * Check if an index is a vehicle-index (so between 0 and max-vehicles)

   385

 *

   386

 * @return Returns true if the vehicle-id is in range

   387

 */

   388

static inline bool IsVehicleIndex(uint index)

   389

{

   390

	if (index < GetVehiclePoolSize()) return true;

   391

   392

	return false;

   393

}

   394

   395

/* Returns order 'index' of a vehicle or NULL when it doesn't exists */

   396

static inline Order *GetVehicleOrder(const Vehicle *v, int index)

   397

{

   398

	Order *order = v->orders;

   399

   400

	if (index < 0) return NULL;

   401

   402

	while (order != NULL && index-- > 0)

   403

		order = order->next;

   404

   405

	return order;

   406

}

   407

   408

/* Returns the last order of a vehicle, or NULL if it doesn't exists */

   409

static inline Order *GetLastVehicleOrder(const Vehicle *v)

   410

{

   411

	Order *order = v->orders;

   412

   413

	if (order == NULL) return NULL;

   414

   415

	while (order->next != NULL)

   416

		order = order->next;

   417

   418

	return order;

   419

}

   420

   421

/* Get the first vehicle of a shared-list, so we only have to walk forwards */

   422

static inline Vehicle *GetFirstVehicleFromSharedList(Vehicle *v)

   423

{

   424

	Vehicle *u = v;

   425

	while (u->prev_shared != NULL)

   426

		u = u->prev_shared;

   427

   428

	return u;

   429

}

   430

   431

/* Validate functions for rail building */

   432

static inline bool ValParamRailtype(uint32 rail) { return rail <= GetPlayer(_current_player)->max_railtype;}

   433

   434

// NOSAVE: Can be regenerated by inspecting the vehicles.

   435

VARDEF VehicleID _vehicle_position_hash[0x1000];

   436

   437

// NOSAVE: Return values from various commands.

   438

VARDEF VehicleID _new_train_id;

   439

VARDEF VehicleID _new_wagon_id;

   440

VARDEF VehicleID _new_aircraft_id;

   441

VARDEF VehicleID _new_ship_id;

   442

VARDEF VehicleID _new_roadveh_id;

   443

VARDEF uint16 _aircraft_refit_capacity;

   444

VARDEF byte _cmd_build_rail_veh_score;

   445

VARDEF byte _cmd_build_rail_veh_var1;

   446

   447

// for each player, for each vehicle type, keep a list of the vehicles.

   448

//VARDEF Vehicle *_vehicle_arr[8][4];

   449

   450

#define INVALID_VEHICLE 0xFFFF

   451

   452

/* A lot of code calls for the invalidation of the status bar, which is widget 5.

   453

 * Best is to have a virtual value for it when it needs to change again */

   454

#define STATUS_BAR 5

   455

   456

#endif /* VEHICLE_H */