1

/* $Id$ */

     2

     3

/** @file train_cmd.cpp */

     4

     5

#include "stdafx.h"

     6

#include "openttd.h"

     7

#include "bridge_map.h"

     8

#include "debug.h"

     9

#include "functions.h"

    10

#include "landscape.h"

    11

#include "gui.h"

    12

#include "station_map.h"

    13

#include "table/strings.h"

    14

#include "map.h"

    15

#include "tile.h"

    16

#include "tunnel_map.h"

    17

#include "vehicle.h"

    18

#include "timetable.h"

    19

#include "articulated_vehicles.h"

    20

#include "command.h"

    21

#include "pathfind.h"

    22

#include "npf.h"

    23

#include "station.h"

    24

#include "table/train_cmd.h"

    25

#include "news.h"

    26

#include "engine.h"

    27

#include "player.h"

    28

#include "sound.h"

    29

#include "depot.h"

    30

#include "waypoint.h"

    31

#include "vehicle_gui.h"

    32

#include "train.h"

    33

#include "bridge.h"

    34

#include "newgrf_callbacks.h"

    35

#include "newgrf_engine.h"

    36

#include "newgrf_sound.h"

    37

#include "newgrf_text.h"

    38

#include "direction.h"

    39

#include "yapf/yapf.h"

    40

#include "date.h"

    41

#include "cargotype.h"

    42

#include "group.h"

    43

    44

static bool TrainCheckIfLineEnds(Vehicle *v);

    45

static void TrainController(Vehicle *v, bool update_image);

    46

    47

static const byte _vehicle_initial_x_fract[4] = {10, 8, 4,  8};

    48

static const byte _vehicle_initial_y_fract[4] = { 8, 4, 8, 10};

    49

static const TrackBits _state_dir_table[4] = { TRACK_BIT_RIGHT, TRACK_BIT_LOWER, TRACK_BIT_LEFT, TRACK_BIT_UPPER };

    50

    51

    52

/** Return the cargo weight multiplier to use for a rail vehicle

    53

 * @param cargo Cargo type to get multiplier for

    54

 * @return Cargo weight multiplier

    55

 */

    56

byte FreightWagonMult(CargoID cargo)

    57

{

    58

	if (!GetCargo(cargo)->is_freight) return 1;

    59

	return _patches.freight_trains;

    60

}

    61

    62

    63

/**

    64

 * Recalculates the cached total power of a train. Should be called when the consist is changed

    65

 * @param v First vehicle of the consist.

    66

 */

    67

void TrainPowerChanged(Vehicle* v)

    68

{

    69

	uint32 total_power = 0;

    70

	uint32 max_te = 0;

    71

    72

	for (const Vehicle *u = v; u != NULL; u = u->next) {

    73

		/* Power is not added for articulated parts */

    74

		if (IsArticulatedPart(u)) continue;

    75

    76

		RailType railtype = GetRailType(u->tile);

    77

		bool engine_has_power = HasPowerOnRail(u->u.rail.railtype, railtype);

    78

		bool wagon_has_power  = HasPowerOnRail(v->u.rail.railtype, railtype);

    79

    80

		const RailVehicleInfo *rvi_u = RailVehInfo(u->engine_type);

    81

    82

		if (engine_has_power) {

    83

			uint16 power = GetVehicleProperty(u, 0x0B, rvi_u->power);

    84

			if (power != 0) {

    85

				total_power += power;

    86

				/* Tractive effort in (tonnes * 1000 * 10 =) N */

    87

				max_te += (u->u.rail.cached_veh_weight * 10000 * GetVehicleProperty(u, 0x1F, rvi_u->tractive_effort)) / 256;

    88

			}

    89

		}

    90

    91

		if (HASBIT(u->u.rail.flags, VRF_POWEREDWAGON) && (wagon_has_power)) {

    92

			total_power += RailVehInfo(u->u.rail.first_engine)->pow_wag_power;

    93

		}

    94

	}

    95

    96

	if (v->u.rail.cached_power != total_power || v->u.rail.cached_max_te != max_te) {

    97

		v->u.rail.cached_power = total_power;

    98

		v->u.rail.cached_max_te = max_te;

    99

		InvalidateWindow(WC_VEHICLE_DETAILS, v->index);

   100

		InvalidateWindowWidget(WC_VEHICLE_VIEW, v->index, STATUS_BAR);

   101

	}

   102

}

   103

   104

   105

/**

   106

 * Recalculates the cached weight of a train and its vehicles. Should be called each time the cargo on

   107

 * the consist changes.

   108

 * @param v First vehicle of the consist.

   109

 */

   110

static void TrainCargoChanged(Vehicle* v)

   111

{

   112

	uint32 weight = 0;

   113

   114

	for (Vehicle *u = v; u != NULL; u = u->next) {

   115

		uint32 vweight = GetCargo(u->cargo_type)->weight * u->cargo_count * FreightWagonMult(u->cargo_type) / 16;

   116

   117

		/* Vehicle weight is not added for articulated parts. */

   118

		if (!IsArticulatedPart(u)) {

   119

			/* vehicle weight is the sum of the weight of the vehicle and the weight of its cargo */

   120

			vweight += GetVehicleProperty(u, 0x16, RailVehInfo(u->engine_type)->weight);

   121

   122

			/* powered wagons have extra weight added */

   123

			if (HASBIT(u->u.rail.flags, VRF_POWEREDWAGON))

   124

				vweight += RailVehInfo(u->u.rail.first_engine)->pow_wag_weight;

   125

		}

   126

   127

		/* consist weight is the sum of the weight of all vehicles in the consist */

   128

		weight += vweight;

   129

   130

		/* store vehicle weight in cache */

   131

		u->u.rail.cached_veh_weight = vweight;

   132

	}

   133

   134

	/* store consist weight in cache */

   135

	v->u.rail.cached_weight = weight;

   136

   137

	/* Now update train power (tractive effort is dependent on weight) */

   138

	TrainPowerChanged(v);

   139

}

   140

   141

   142

/**

   143

 * Recalculates the cached stuff of a train. Should be called each time a vehicle is added

   144

 * to/removed from the chain, and when the game is loaded.

   145

 * Note: this needs to be called too for 'wagon chains' (in the depot, without an engine)

   146

 * @param v First vehicle of the chain.

   147

 */

   148

void TrainConsistChanged(Vehicle* v)

   149

{

   150

	uint16 max_speed = 0xFFFF;

   151

   152

	assert(v->type == VEH_TRAIN);

   153

	assert(IsFrontEngine(v) || IsFreeWagon(v));

   154

   155

	const RailVehicleInfo *rvi_v = RailVehInfo(v->engine_type);

   156

	EngineID first_engine = IsFrontEngine(v) ? v->engine_type : INVALID_ENGINE;

   157

	v->u.rail.cached_total_length = 0;

   158

	v->u.rail.compatible_railtypes = 0;

   159

   160

	for (Vehicle *u = v; u != NULL; u = u->next) {

   161

		const RailVehicleInfo *rvi_u = RailVehInfo(u->engine_type);

   162

   163

		/* Update the v->first cache. This is faster than having to brute force it later. */

   164

		if (u->first == NULL) u->first = v;

   165

   166

		/* update the 'first engine' */

   167

		u->u.rail.first_engine = v == u ? INVALID_ENGINE : first_engine;

   168

		u->u.rail.railtype = rvi_u->railtype;

   169

   170

		if (IsTrainEngine(u)) first_engine = u->engine_type;

   171

   172

		/* Cache wagon override sprite group. NULL is returned if there is none */

   173

		u->u.rail.cached_override = GetWagonOverrideSpriteSet(u->engine_type, u->cargo_type, u->u.rail.first_engine);

   174

   175

		if (rvi_u->visual_effect != 0) {

   176

			u->u.rail.cached_vis_effect = rvi_u->visual_effect;

   177

		} else {

   178

			if (IsTrainWagon(u) || IsArticulatedPart(u)) {

   179

				/* Wagons and articulated parts have no effect by default */

   180

				u->u.rail.cached_vis_effect = 0x40;

   181

			} else if (rvi_u->engclass == 0) {

   182

				/* Steam is offset by -4 units */

   183

				u->u.rail.cached_vis_effect = 4;

   184

			} else {

   185

				/* Diesel fumes and sparks come from the centre */

   186

				u->u.rail.cached_vis_effect = 8;

   187

			}

   188

		}

   189

   190

		if (!IsArticulatedPart(u)) {

   191

			/* Check powered wagon / visual effect callback */

   192

			if (HASBIT(EngInfo(u->engine_type)->callbackmask, CBM_WAGON_POWER)) {

   193

				uint16 callback = GetVehicleCallback(CBID_TRAIN_WAGON_POWER, 0, 0, u->engine_type, u);

   194

   195

				if (callback != CALLBACK_FAILED) u->u.rail.cached_vis_effect = callback;

   196

			}

   197

   198

			if (rvi_v->pow_wag_power != 0 && rvi_u->railveh_type == RAILVEH_WAGON &&

   199

				UsesWagonOverride(u) && !HASBIT(u->u.rail.cached_vis_effect, 7)) {

   200

				/* wagon is powered */

   201

				SETBIT(u->u.rail.flags, VRF_POWEREDWAGON); // cache 'powered' status

   202

			} else {

   203

				CLRBIT(u->u.rail.flags, VRF_POWEREDWAGON);

   204

			}

   205

   206

			/* Do not count powered wagons for the compatible railtypes, as wagons always

   207

			   have railtype normal */

   208

			if (rvi_u->power > 0) {

   209

				v->u.rail.compatible_railtypes |= GetRailTypeInfo(u->u.rail.railtype)->powered_railtypes;

   210

			}

   211

   212

			/* Some electric engines can be allowed to run on normal rail. It happens to all

   213

			 * existing electric engines when elrails are disabled and then re-enabled */

   214

			if (HASBIT(u->u.rail.flags, VRF_EL_ENGINE_ALLOWED_NORMAL_RAIL)) {

   215

				u->u.rail.railtype = RAILTYPE_RAIL;

   216

				u->u.rail.compatible_railtypes |= (1 << RAILTYPE_RAIL);

   217

			}

   218

   219

			/* max speed is the minimum of the speed limits of all vehicles in the consist */

   220

			if ((rvi_u->railveh_type != RAILVEH_WAGON || _patches.wagon_speed_limits) && !UsesWagonOverride(u)) {

   221

				uint16 speed = GetVehicleProperty(u, 0x09, rvi_u->max_speed);

   222

				if (speed != 0) max_speed = min(speed, max_speed);

   223

			}

   224

		}

   225

   226

		if (u->cargo_type == rvi_u->cargo_type && u->cargo_subtype == 0) {

   227

			/* Set cargo capacity if we've not been refitted */

   228

			u->cargo_cap = GetVehicleProperty(u, 0x14, rvi_u->capacity);

   229

		}

   230

   231

		/* check the vehicle length (callback) */

   232

		uint16 veh_len = CALLBACK_FAILED;

   233

		if (HASBIT(EngInfo(u->engine_type)->callbackmask, CBM_VEHICLE_LENGTH)) {

   234

			veh_len = GetVehicleCallback(CBID_TRAIN_VEHICLE_LENGTH, 0, 0, u->engine_type, u);

   235

		}

   236

		if (veh_len == CALLBACK_FAILED) veh_len = rvi_u->shorten_factor;

   237

		veh_len = clamp(veh_len, 0, u->next == NULL ? 7 : 5); // the clamp on vehicles not the last in chain is stricter, as too short wagons can break the 'follow next vehicle' code

   238

		u->u.rail.cached_veh_length = 8 - veh_len;

   239

		v->u.rail.cached_total_length += u->u.rail.cached_veh_length;

   240

	}

   241

   242

	/* store consist weight/max speed in cache */

   243

	v->u.rail.cached_max_speed = max_speed;

   244

   245

	/* recalculate cached weights and power too (we do this *after* the rest, so it is known which wagons are powered and need extra weight added) */

   246

	TrainCargoChanged(v);

   247

}

   248

   249

/* These two arrays are used for realistic acceleration. XXX: How should they

   250

 * be interpreted? */

   251

static const byte _curve_neighbours45[8][2] = {

   252

	{7, 1},

   253

	{0, 2},

   254

	{1, 3},

   255

	{2, 4},

   256

	{3, 5},

   257

	{4, 6},

   258

	{5, 7},

   259

	{6, 0},

   260

};

   261

   262

static const byte _curve_neighbours90[8][2] = {

   263

	{6, 2},

   264

	{7, 3},

   265

	{0, 4},

   266

	{1, 5},

   267

	{2, 6},

   268

	{3, 7},

   269

	{4, 0},

   270

	{5, 1},

   271

};

   272

   273

enum AccelType {

   274

	AM_ACCEL,

   275

	AM_BRAKE

   276

};

   277

   278

static bool TrainShouldStop(const Vehicle* v, TileIndex tile)

   279

{

   280

	const Order* o = &v->current_order;

   281

	StationID sid = GetStationIndex(tile);

   282

   283

	assert(v->type == VEH_TRAIN);

   284

	/* When does a train drive through a station

   285

	 * first we deal with the "new nonstop handling" */

   286

	if (_patches.new_nonstop && o->flags & OF_NON_STOP && sid == o->dest) {

   287

		return false;

   288

	}

   289

   290

	if (v->last_station_visited == sid) return false;

   291

   292

	if (sid != o->dest && (o->flags & OF_NON_STOP || _patches.new_nonstop)) {

   293

		return false;

   294

	}

   295

   296

	return true;

   297

}

   298

   299

/** new acceleration*/

   300

static int GetTrainAcceleration(Vehicle *v, bool mode)

   301

{

   302

	int max_speed = 2000;

   303

	int speed = v->cur_speed * 10 / 16; //[mph]

   304

	int curvecount[2] = {0, 0};

   305

   306

	/*first find the curve speed limit */

   307

	int numcurve = 0;

   308

	int sum = 0;

   309

	int pos = 0;

   310

	int lastpos = -1;

   311

	for (const Vehicle *u = v; u->next != NULL; u = u->next, pos++) {

   312

		Direction dir = u->direction;

   313

		Direction ndir = u->next->direction;

   314

		int i;

   315

   316

		for (i = 0; i < 2; i++) {

   317

			if ( _curve_neighbours45[dir][i] == ndir) {

   318

				curvecount[i]++;

   319

				if (lastpos != -1) {

   320

					numcurve++;

   321

					sum += pos - lastpos;

   322

					if (pos - lastpos == 1) {

   323

						max_speed = 88;

   324

					}

   325

				}

   326

				lastpos = pos;

   327

			}

   328

		}

   329

   330

		/*if we have a 90 degree turn, fix the speed limit to 60 */

   331

		if (_curve_neighbours90[dir][0] == ndir ||

   332

				_curve_neighbours90[dir][1] == ndir) {

   333

			max_speed = 61;

   334

		}

   335

	}

   336

   337

	if (numcurve > 0) sum /= numcurve;

   338

   339

	if ((curvecount[0] != 0 || curvecount[1] != 0) && max_speed > 88) {

   340

		int total = curvecount[0] + curvecount[1];

   341

   342

		if (curvecount[0] == 1 && curvecount[1] == 1) {

   343

			max_speed = 0xFFFF;

   344

		} else if (total > 1) {

   345

			max_speed = 232 - (13 - clamp(sum, 1, 12)) * (13 - clamp(sum, 1, 12));

   346

		}

   347

	}

   348

   349

	max_speed += (max_speed / 2) * v->u.rail.railtype;

   350

   351

	if (IsTileType(v->tile, MP_STATION) && IsFrontEngine(v)) {

   352

		if (TrainShouldStop(v, v->tile)) {

   353

			int station_length = GetStationByTile(v->tile)->GetPlatformLength(v->tile, DirToDiagDir(v->direction));

   354

			int delta_v;

   355

   356

			max_speed = 120;

   357

   358

			delta_v = v->cur_speed / (station_length + 1);

   359

			if (v->max_speed > (v->cur_speed - delta_v))

   360

				max_speed = v->cur_speed - (delta_v / 10);

   361

   362

			max_speed = max(max_speed, 25 * station_length);

   363

		}

   364

	}

   365

   366

	int mass = v->u.rail.cached_weight;

   367

	int power = v->u.rail.cached_power * 746;

   368

	max_speed = min(max_speed, v->u.rail.cached_max_speed);

   369

   370

	int num = 0; //number of vehicles, change this into the number of axles later

   371

	int incl = 0;

   372

	int drag_coeff = 20; //[1e-4]

   373

	for (const Vehicle *u = v; u != NULL; u = u->next) {

   374

		num++;

   375

		drag_coeff += 3;

   376

   377

		if (u->u.rail.track == TRACK_BIT_DEPOT) max_speed = min(max_speed, 61);

   378

   379

		if (HASBIT(u->u.rail.flags, VRF_GOINGUP)) {

   380

			incl += u->u.rail.cached_veh_weight * 60; //3% slope, quite a bit actually

   381

		} else if (HASBIT(u->u.rail.flags, VRF_GOINGDOWN)) {

   382

			incl -= u->u.rail.cached_veh_weight * 60;

   383

		}

   384

	}

   385

   386

	v->max_speed = max_speed;

   387

   388

	const int area = 120;

   389

	const int friction = 35; //[1e-3]

   390

	int resistance;

   391

	if (v->u.rail.railtype != RAILTYPE_MAGLEV) {

   392

		resistance = 13 * mass / 10;

   393

		resistance += 60 * num;

   394

		resistance += friction * mass * speed / 1000;

   395

		resistance += (area * drag_coeff * speed * speed) / 10000;

   396

	} else {

   397

		resistance = (area * (drag_coeff / 2) * speed * speed) / 10000;

   398

	}

   399

	resistance += incl;

   400

	resistance *= 4; //[N]

   401

   402

	/* Due to the mph to m/s conversion below, at speeds below 3 mph the force is

   403

	 * actually double the train's power */

   404

	const int max_te = v->u.rail.cached_max_te; // [N]

   405

	int force;

   406

	if (speed > 2) {

   407

		switch (v->u.rail.railtype) {

   408

			case RAILTYPE_RAIL:

   409

			case RAILTYPE_ELECTRIC:

   410

			case RAILTYPE_MONO:

   411

				force = power / speed; //[N]

   412

				force *= 22;

   413

				force /= 10;

   414

				if (mode == AM_ACCEL && force > max_te) force = max_te;

   415

				break;

   416

   417

			default: NOT_REACHED();

   418

			case RAILTYPE_MAGLEV:

   419

				force = power / 25;

   420

				break;

   421

		}

   422

	} else {

   423

		/* "kickoff" acceleration */

   424

		force = (mode == AM_ACCEL && v->u.rail.railtype != RAILTYPE_MAGLEV) ? min(max_te, power) : power;

   425

		force = max(force, (mass * 8) + resistance);

   426

	}

   427

   428

	if (force <= 0) force = 10000;

   429

   430

	if (v->u.rail.railtype != RAILTYPE_MAGLEV) force = min(force, mass * 10 * 200);

   431

   432

	if (mode == AM_ACCEL) {

   433

		return (force - resistance) / (mass * 4);

   434

	} else {

   435

		return min((-force - resistance) / (mass * 4), -10000 / (mass * 4));

   436

	}

   437

}

   438

   439

static void UpdateTrainAcceleration(Vehicle* v)

   440

{

   441

	assert(IsFrontEngine(v));

   442

   443

	v->max_speed = v->u.rail.cached_max_speed;

   444

   445

	uint power = v->u.rail.cached_power;

   446

	uint weight = v->u.rail.cached_weight;

   447

	assert(weight != 0);

   448

	v->acceleration = clamp(power / weight * 4, 1, 255);

   449

}

   450

   451

int GetTrainImage(const Vehicle* v, Direction direction)

   452

{

   453

	int img = v->spritenum;

   454

	int base;

   455

   456

	if (HASBIT(v->u.rail.flags, VRF_REVERSE_DIRECTION)) direction = ReverseDir(direction);

   457

   458

	if (is_custom_sprite(img)) {

   459

		base = GetCustomVehicleSprite(v, (Direction)(direction + 4 * IS_CUSTOM_SECONDHEAD_SPRITE(img)));

   460

		if (base != 0) return base;

   461

		img = orig_rail_vehicle_info[v->engine_type].image_index;

   462

	}

   463

   464

	base = _engine_sprite_base[img] + ((direction + _engine_sprite_add[img]) & _engine_sprite_and[img]);

   465

   466

	if (v->cargo_count >= v->cargo_cap / 2) base += _wagon_full_adder[img];

   467

	return base;

   468

}

   469

   470

void DrawTrainEngine(int x, int y, EngineID engine, SpriteID pal)

   471

{

   472

	const RailVehicleInfo *rvi = RailVehInfo(engine);

   473

   474

	int img = rvi->image_index;

   475

	SpriteID image = 0;

   476

   477

	if (is_custom_sprite(img)) {

   478

		image = GetCustomVehicleIcon(engine, DIR_W);

   479

		if (image == 0) {

   480

			img = orig_rail_vehicle_info[engine].image_index;

   481

		} else {

   482

			y += _traininfo_vehicle_pitch;