1

/* $Id$ */

     2

     3

/** @file signal.cpp functions related to rail signals updating */

     4

     5

#include "stdafx.h"

     6

#include "openttd.h"

     7

#include "debug.h"

     8

#include "tile_cmd.h"

     9

#include "rail_map.h"

    10

#include "road_map.h"

    11

#include "station_map.h"

    12

#include "tunnelbridge_map.h"

    13

#include "vehicle_func.h"

    14

#include "train.h"

    15

#include "newgrf_station.h"

    16

#include "functions.h"

    17

#include "track_type.h"

    18

#include "track_func.h"

    19

#include "signal_func.h"

    20

#include "company_func.h"

    21

    22

    23

/** these are the maximums used for updating signal blocks */

    24

enum {

    25

	SIG_TBU_SIZE    =  64, ///< number of signals entering to block

    26

	SIG_TBD_SIZE    = 256, ///< number of intersections - open nodes in current block

    27

	SIG_GLOB_SIZE   = 128, ///< number of open blocks (block can be opened more times until detected)

    28

	SIG_GLOB_UPDATE =  64, ///< how many items need to be in _globset to force update

    29

};

    30

    31

/* need to typecast to compile with MorphOS */

    32

assert_compile((int)SIG_GLOB_UPDATE <= (int)SIG_GLOB_SIZE);

    33

    34

/** incidating trackbits with given enterdir */

    35

static const TrackBitsByte _enterdir_to_trackbits[DIAGDIR_END] = {

    36

	{TRACK_BIT_3WAY_NE},

    37

	{TRACK_BIT_3WAY_SE},

    38

	{TRACK_BIT_3WAY_SW},

    39

	{TRACK_BIT_3WAY_NW}

    40

};

    41

    42

/** incidating trackdirbits with given enterdir */

    43

static const TrackdirBitsShort _enterdir_to_trackdirbits[DIAGDIR_END] = {

    44

	{TRACKDIR_BIT_X_SW | TRACKDIR_BIT_UPPER_W | TRACKDIR_BIT_RIGHT_S},

    45

	{TRACKDIR_BIT_Y_NW | TRACKDIR_BIT_LOWER_W | TRACKDIR_BIT_RIGHT_N},

    46

	{TRACKDIR_BIT_X_NE | TRACKDIR_BIT_LOWER_E | TRACKDIR_BIT_LEFT_N},

    47

	{TRACKDIR_BIT_Y_SE | TRACKDIR_BIT_UPPER_E | TRACKDIR_BIT_LEFT_S}

    48

};

    49

    50

/**

    51

 * Set containing 'items' items of 'tile and Tdir'

    52

 * No tree structure is used because it would cause

    53

 * slowdowns in most usual cases

    54

 */

    55

template <typename Tdir, uint items>

    56

struct SmallSet {

    57

private:

    58

	uint n;           // actual number of units

    59

	bool overflowed;  // did we try to oveflow the set?

    60

	const char *name; // name, used for debugging purposes...

    61

    62

	/** Element of set */

    63

	struct SSdata {

    64

		TileIndex tile;

    65

		Tdir dir;

    66

	} data[items];

    67

    68

public:

    69

	/** Constructor - just set default values and 'name' */

    70

	SmallSet(const char *name) : n(0), overflowed(false), name(name) { }

    71

    72

	/** Reset variables to default values */

    73

	void Reset()

    74

	{

    75

		this->n = 0;

    76

		this->overflowed = false;

    77

	}

    78

    79

	/**

    80

	 * Returns value of 'oveflowed'

    81

	 * @return did we try to overflow the set?

    82

	 */

    83

	bool Overflowed()

    84

	{

    85

		return this->overflowed;

    86

	}

    87

    88

	/**

    89

	 * Checks for empty set

    90

	 * @return is the set empty?

    91

	 */

    92

	bool IsEmpty()

    93

	{

    94

		return this->n == 0;

    95

	}

    96

    97

	/**

    98

	 * Checks for full set

    99

	 * @return is the set full?

   100

	 */

   101

	bool IsFull()

   102

	{

   103

		return this->n == lengthof(data);

   104

	}

   105

   106

	/**

   107

	 * Reads the number of items

   108

	 * @return current number of items

   109

	 */

   110

	uint Items()

   111

	{

   112

		return this->n;

   113

	}

   114

   115

   116

	/**

   117

	 * Tries to remove first instance of given tile and dir

   118

	 * @param tile tile

   119

	 * @param dir and dir to remove

   120

	 * @return element was found and removed

   121

	 */

   122

	bool Remove(TileIndex tile, Tdir dir)

   123

	{

   124

		for (uint i = 0; i < this->n; i++) {

   125

			if (this->data[i].tile == tile && this->data[i].dir == dir) {

   126

				this->data[i] = this->data[--this->n];

   127

				return true;

   128

			}

   129

		}

   130

   131

		return false;

   132

	}

   133

   134

	/**

   135

	 * Tries to find given tile and dir in the set

   136

	 * @param tile tile

   137

	 * @param dir and dir to find

   138

	 * @return true iff the tile & dir elemnt was found

   139

	 */

   140

	bool IsIn(TileIndex tile, Tdir dir)

   141

	{

   142

		for (uint i = 0; i < this->n; i++) {

   143

			if (this->data[i].tile == tile && this->data[i].dir == dir) return true;

   144

		}

   145

   146

		return false;

   147

	}

   148

   149

	/**

   150

	 * Adds tile & dir into the set, checks for full set

   151

	 * Sets the 'overflowed' flag if the set was full

   152

	 * @param tile tile

   153

	 * @param dir and dir to add

   154

	 * @return true iff the item could be added (set wasn't full)

   155

	 */

   156

	bool Add(TileIndex tile, Tdir dir)

   157

	{

   158

		if (this->IsFull()) {

   159

			overflowed = true;

   160

			DEBUG(misc, 0, "SignalSegment too complex. Set %s is full (maximum %d)", name, items);

   161

			return false; // set is full

   162

		}

   163

   164

		this->data[this->n].tile = tile;

   165

		this->data[this->n].dir = dir;

   166

		this->n++;

   167

   168

		return true;

   169

	}

   170

   171

	/**

   172

	 * Reads the last added element into the set

   173

	 * @param tile pointer where tile is written to

   174

	 * @param dir pointer where dir is written to

   175

	 * @return false iff the set was empty

   176

	 */

   177

	bool Get(TileIndex *tile, Tdir *dir)

   178

	{

   179

		if (this->n == 0) return false;

   180

   181

		this->n--;

   182

		*tile = this->data[this->n].tile;

   183

		*dir = this->data[this->n].dir;

   184

   185

		return true;

   186

	}

   187

};

   188

   189

static SmallSet<Trackdir, SIG_TBU_SIZE> _tbuset("_tbuset");         ///< set of signals that will be updated

   190

static SmallSet<DiagDirection, SIG_TBD_SIZE> _tbdset("_tbdset");    ///< set of open nodes in current signal block

   191

static SmallSet<DiagDirection, SIG_GLOB_SIZE> _globset("_globset"); ///< set of places to be updated in following runs

   192

   193

   194

/** Check whether there is a train on rail, not in a depot */

   195

static Vehicle *TrainOnTileEnum(Vehicle *v, void *)

   196

{

   197

	if (v->type != VEH_TRAIN || v->u.rail.track == TRACK_BIT_DEPOT) return NULL;

   198

   199

	return v;

   200

}

   201

   202

   203

/**

   204

 * Perform some operations before adding data into Todo set

   205

 * The new and reverse direction is removed from _globset, because we are sure

   206

 * it doesn't need to be checked again

   207

 * Also, remove reverse direction from _tbdset

   208

 * This is the 'core' part so the graph seaching won't enter any tile twice

   209

 *

   210

 * @param t1 tile we are entering

   211

 * @param d1 direction (tile side) we are entering

   212

 * @param t2 tile we are leaving

   213

 * @param d2 direction (tile side) we are leaving

   214

 * @return false iff reverse direction was in Todo set

   215

 */

   216

static inline bool CheckAddToTodoSet(TileIndex t1, DiagDirection d1, TileIndex t2, DiagDirection d2)

   217

{

   218

	_globset.Remove(t1, d1); // it can be in Global but not in Todo

   219

	_globset.Remove(t2, d2); // remove in all cases

   220

   221

	assert(!_tbdset.IsIn(t1, d1)); // it really shouldn't be there already

   222

   223

	if (_tbdset.Remove(t2, d2)) return false;

   224

   225

	return true;

   226

}

   227

   228

   229

/**

   230

 * Perform some operations before adding data into Todo set

   231

 * The new and reverse direction is removed from Global set, because we are sure

   232

 * it doesn't need to be checked again

   233

 * Also, remove reverse direction from Todo set

   234

 * This is the 'core' part so the graph seaching won't enter any tile twice

   235

 *

   236

 * @param t1 tile we are entering

   237

 * @param d1 direction (tile side) we are entering

   238

 * @param t2 tile we are leaving

   239

 * @param d2 direction (tile side) we are leaving

   240

 * @return false iff the Todo buffer would be overrun

   241

 */

   242

static inline bool MaybeAddToTodoSet(TileIndex t1, DiagDirection d1, TileIndex t2, DiagDirection d2)

   243

{

   244

	if (!CheckAddToTodoSet(t1, d1, t2, d2)) return true;

   245

   246

	return _tbdset.Add(t1, d1);

   247

}

   248

   249

   250

/** Current signal block state flags */

   251

enum SigFlags {

   252

	SF_NONE   = 0,

   253

	SF_TRAIN  = 1 << 0, ///< train found in segment

   254

	SF_EXIT   = 1 << 1, ///< exitsignal found

   255

	SF_EXIT2  = 1 << 2, ///< two or more exits found

   256

	SF_GREEN  = 1 << 3, ///< green exitsignal found

   257

	SF_GREEN2 = 1 << 4, ///< two or more green exits found

   258

	SF_FULL   = 1 << 5, ///< some of buffers was full, do not continue

   259

	SF_PBS    = 1 << 6, ///< pbs signal found

   260

};

   261

   262

DECLARE_ENUM_AS_BIT_SET(SigFlags)

   263

   264

   265

/**

   266

 * Search signal block

   267

 *

   268

 * @param owner owner whose signals we are updating

   269

 * @return SigFlags

   270

 */

   271

static SigFlags ExploreSegment(Owner owner)

   272

{

   273

	SigFlags flags = SF_NONE;

   274

   275

	TileIndex tile;

   276

	DiagDirection enterdir;

   277

   278

	while (_tbdset.Get(&tile, &enterdir)) {

   279

		TileIndex oldtile = tile; // tile we are leaving

   280

		DiagDirection exitdir = enterdir == INVALID_DIAGDIR ? INVALID_DIAGDIR : ReverseDiagDir(enterdir); // expected new exit direction (for straight line)

   281

   282

		switch (GetTileType(tile)) {

   283

			case MP_RAILWAY: {

   284

				if (GetTileOwner(tile) != owner) continue; // do not propagate signals on others' tiles (remove for tracksharing)

   285

   286

				if (IsRailDepot(tile)) {

   287

					if (enterdir == INVALID_DIAGDIR) { // from 'inside' - train just entered or left the depot

   288

						if (!(flags & SF_TRAIN) && HasVehicleOnPos(tile, NULL, &TrainOnTileEnum)) flags |= SF_TRAIN;

   289

						exitdir = GetRailDepotDirection(tile);

   290

						tile += TileOffsByDiagDir(exitdir);

   291

						enterdir = ReverseDiagDir(exitdir);

   292

						break;

   293

					} else if (enterdir == GetRailDepotDirection(tile)) { // entered a depot

   294

						if (!(flags & SF_TRAIN) && HasVehicleOnPos(tile, NULL, &TrainOnTileEnum)) flags |= SF_TRAIN;

   295

						continue;

   296

					} else {

   297

						continue;

   298

					}

   299

				}

   300

   301

				if (GetRailTileType(tile) == RAIL_TILE_WAYPOINT) {

   302

					if (GetWaypointAxis(tile) != DiagDirToAxis(enterdir)) continue;

   303

					if (!(flags & SF_TRAIN) && HasVehicleOnPos(tile, NULL, &TrainOnTileEnum)) flags |= SF_TRAIN;

   304

					tile += TileOffsByDiagDir(exitdir);

   305

					/* enterdir and exitdir stay the same */

   306

					break;

   307

				}

   308

   309

				TrackBits tracks = GetTrackBits(tile); // trackbits of tile

   310

				TrackBits tracks_masked = (TrackBits)(tracks & _enterdir_to_trackbits[enterdir]); // only incidating trackbits

   311

   312

				if (tracks == TRACK_BIT_HORZ || tracks == TRACK_BIT_VERT) { // there is exactly one incidating track, no need to check

   313

					tracks = tracks_masked;

   314

					if (!(flags & SF_TRAIN) && HasVehicleOnPos(tile, &tracks, &EnsureNoTrainOnTrackProc)) flags |= SF_TRAIN;

   315

				} else {

   316

					if (tracks_masked == TRACK_BIT_NONE) continue; // no incidating track

   317

					if (!(flags & SF_TRAIN) && HasVehicleOnPos(tile, NULL, &TrainOnTileEnum)) flags |= SF_TRAIN;

   318

				}

   319

   320

				if (HasSignals(tile)) { // there is exactly one track - not zero, because there is exit from this tile

   321

					Track track = TrackBitsToTrack(tracks_masked); // mask TRACK_BIT_X and Y too

   322

					if (HasSignalOnTrack(tile, track)) { // now check whole track, not trackdir

   323

						SignalType sig = GetSignalType(tile, track);

   324

						Trackdir trackdir = (Trackdir)FindFirstBit((tracks * 0x101) & _enterdir_to_trackdirbits[enterdir]);

   325

						Trackdir reversedir = ReverseTrackdir(trackdir);

   326

						/* add (tile, reversetrackdir) to 'to-be-updated' set when there is

   327

						 * ANY conventional signal in REVERSE direction

   328

						 * (if it is a presignal EXIT and it changes, it will be added to 'to-be-done' set later) */

   329

						if (HasSignalOnTrackdir(tile, reversedir)) {

   330

							if (IsPbsSignal(sig)) {

   331

								flags |= SF_PBS;

   332

							} else if (!_tbuset.Add(tile, reversedir)) {

   333

								return flags | SF_FULL;

   334

							}

   335

						}

   336

						if (HasSignalOnTrackdir(tile, trackdir) && !IsOnewaySignal(tile, track)) flags |= SF_PBS;

   337

   338

						/* if it is a presignal EXIT in OUR direction and we haven't found 2 green exits yes, do special check */

   339

						if (!(flags & SF_GREEN2) && IsPresignalExit(tile, track) && HasSignalOnTrackdir(tile, trackdir)) { // found presignal exit

   340

							if (flags & SF_EXIT) flags |= SF_EXIT2; // found two (or more) exits

   341

							flags |= SF_EXIT; // found at least one exit - allow for compiler optimizations

   342

							if (GetSignalStateByTrackdir(tile, trackdir) == SIGNAL_STATE_GREEN) { // found green presignal exit

   343

								if (flags & SF_GREEN) flags |= SF_GREEN2;

   344

								flags |= SF_GREEN;

   345

							}

   346

						}

   347

   348

						continue;

   349

					}

   350

				}

   351

   352

				for (DiagDirection dir = DIAGDIR_BEGIN; dir < DIAGDIR_END; dir++) { // test all possible exit directions

   353

					if (dir != enterdir && tracks & _enterdir_to_trackbits[dir]) { // any track incidating?

   354

						TileIndex newtile = tile + TileOffsByDiagDir(dir);  // new tile to check

   355

						DiagDirection newdir = ReverseDiagDir(dir); // direction we are entering from

   356

						if (!MaybeAddToTodoSet(newtile, newdir, tile, dir)) return flags | SF_FULL;

   357

					}

   358

				}

   359

   360

				continue; // continue the while() loop

   361

				}

   362

   363

			case MP_STATION:

   364

				if (!IsRailwayStation(tile)) continue;

   365

				if (GetTileOwner(tile) != owner) continue;

   366

				if (DiagDirToAxis(enterdir) != GetRailStationAxis(tile)) continue; // different axis

   367

				if (IsStationTileBlocked(tile)) continue; // 'eye-candy' station tile

   368

   369

				if (!(flags & SF_TRAIN) && HasVehicleOnPos(tile, NULL, &TrainOnTileEnum)) flags |= SF_TRAIN;

   370

				tile += TileOffsByDiagDir(exitdir);

   371

				break;

   372

   373

			case MP_ROAD:

   374

				if (!IsLevelCrossing(tile)) continue;

   375

				if (GetTileOwner(tile) != owner) continue;

   376

				if (DiagDirToAxis(enterdir) == GetCrossingRoadAxis(tile)) continue; // different axis

   377

   378

				if (!(flags & SF_TRAIN) && HasVehicleOnPos(tile, NULL, &TrainOnTileEnum)) flags |= SF_TRAIN;

   379

				tile += TileOffsByDiagDir(exitdir);

   380

				break;

   381

   382

			case MP_TUNNELBRIDGE: {

   383

				if (GetTileOwner(tile) != owner) continue;

   384

				if (GetTunnelBridgeTransportType(tile) != TRANSPORT_RAIL) continue;

   385

				DiagDirection dir = GetTunnelBridgeDirection(tile);

   386

   387

				if (enterdir == INVALID_DIAGDIR) { // incoming from the wormhole

   388

					if (!(flags & SF_TRAIN) && HasVehicleOnPos(tile, NULL, &TrainOnTileEnum)) flags |= SF_TRAIN;

   389

					enterdir = dir;

   390

					exitdir = ReverseDiagDir(dir);

   391

					tile += TileOffsByDiagDir(exitdir); // just skip to next tile

   392

				} else { // NOT incoming from the wormhole!

   393

					if (ReverseDiagDir(enterdir) != dir) continue;

   394

					if (!(flags & SF_TRAIN) && HasVehicleOnPos(tile, NULL, &TrainOnTileEnum)) flags |= SF_TRAIN;

   395

					tile = GetOtherTunnelBridgeEnd(tile); // just skip to exit tile

   396

					enterdir = INVALID_DIAGDIR;

   397

					exitdir = INVALID_DIAGDIR;

   398

				}

   399

				}

   400

				break;

   401

   402

			default:

   403

				continue; // continue the while() loop

   404

		}

   405

   406

		if (!MaybeAddToTodoSet(tile, enterdir, oldtile, exitdir)) return flags | SF_FULL;

   407

	}

   408

   409

	return flags;

   410

}

   411

   412

   413

/**

   414

 * Update signals around segment in _tbuset

   415

 *

   416

 * @param flags info about segment

   417

 */

   418

static void UpdateSignalsAroundSegment(SigFlags flags)

   419

{

   420

	TileIndex tile;

   421

	Trackdir trackdir;

   422

   423

	while (_tbuset.Get(&tile, &trackdir)) {

   424

		assert(HasSignalOnTrackdir(tile, trackdir));

   425

   426

		SignalType sig = GetSignalType(tile, TrackdirToTrack(trackdir));

   427

		SignalState newstate = SIGNAL_STATE_GREEN;

   428

   429

		/* determine whether the new state is red */

   430

		if (flags & SF_TRAIN) {

   431

			/* train in the segment */

   432

			newstate = SIGNAL_STATE_RED;

   433

		} else {

   434

			/* is it a bidir combo? - then do not count its other signal direction as exit */

   435

			if (sig == SIGTYPE_COMBO && HasSignalOnTrackdir(tile, ReverseTrackdir(trackdir))) {

   436

				/* at least one more exit */

   437

				if (flags & SF_EXIT2 &&

   438

						/* no green exit */

   439

						(!(flags & SF_GREEN) ||

   440

						/* only one green exit, and it is this one - so all other exits are red */

   441

						(!(flags & SF_GREEN2) && GetSignalStateByTrackdir(tile, ReverseTrackdir(trackdir)) == SIGNAL_STATE_GREEN))) {

   442

					newstate = SIGNAL_STATE_RED;

   443

				}

   444

			} else { // entry, at least one exit, no green exit

   445

				if (IsPresignalEntry(tile, TrackdirToTrack(trackdir)) && flags & SF_EXIT && !(flags & SF_GREEN)) newstate = SIGNAL_STATE_RED;

   446

			}

   447

		}

   448

   449

		/* only when the state changes */

   450

		if (newstate != GetSignalStateByTrackdir(tile, trackdir)) {

   451

			if (IsPresignalExit(tile, TrackdirToTrack(trackdir))) {

   452

				/* for pre-signal exits, add block to the global set */

   453

				DiagDirection exitdir = TrackdirToExitdir(ReverseTrackdir(trackdir));

   454

				_globset.Add(tile, exitdir); // do not check for full global set, first update all signals

   455

			}

   456

			SetSignalStateByTrackdir(tile, trackdir, newstate);

   457

			MarkTileDirtyByTile(tile);

   458

		}

   459

	}

   460

   461

}

   462

   463

   464

/** Reset all sets after one set overflowed */

   465

static inline void ResetSets()

   466

{

   467

	_tbuset.Reset();

   468

	_tbdset.Reset();

   469

	_globset.Reset();

   470

}

   471

   472

   473

/**

   474

 * Updates blocks in _globset buffer

   475

 *

   476

 * @param owner company whose signals we are updating

   477

 * @return state of the first block from _globset

   478

 * @pre IsValidCompanyID(owner)

   479

 */

   480

static SigSegState UpdateSignalsInBuffer(Owner owner)

   481

{

   482

	assert(IsValidCompanyID(owner));

   483

   484

	bool first = true;  // first block?

   485

	SigSegState state = SIGSEG_FREE; // value to return

   486

   487

	TileIndex tile;

   488

	DiagDirection dir;

   489

   490

	while (_globset.Get(&tile, &dir)) {

   491

		assert(_tbuset.IsEmpty());

   492

		assert(_tbdset.IsEmpty());

   493

   494

		/* After updating signal, data stored are always MP_RAILWAY with signals.

   495

		 * Other situations happen when data are from outside functions -

   496

		 * modification of railbits (including both rail building and removal),

   497

		 * train entering/leaving block, train leaving depot...

   498

		 */

   499

		switch (GetTileType(tile)) {

   500

			case MP_TUNNELBRIDGE:

   501

				/* 'optimization assert' - do not try to update signals when it is not needed */

   502

				assert(GetTunnelBridgeTransportType(tile) == TRANSPORT_RAIL);

   503

				assert(dir == INVALID_DIAGDIR || dir == ReverseDiagDir(GetTunnelBridgeDirection(tile)));

   504

				_tbdset.Add(tile, INVALID_DIAGDIR);  // we can safely start from wormhole centre

   505

				_tbdset.Add(GetOtherTunnelBridgeEnd(tile), INVALID_DIAGDIR);

   506

				break;

   507

   508

			case MP_RAILWAY:

   509

				if (IsRailDepot(tile)) {

   510

					/* 'optimization assert' do not try to update signals in other cases */

   511

					assert(dir == INVALID_DIAGDIR || dir == GetRailDepotDirection(tile));

   512

					_tbdset.Add(tile, INVALID_DIAGDIR); // start from depot inside

   513

					break;

   514

				}

   515

				/* FALLTHROUGH */

   516

			case MP_STATION:

   517

			case MP_ROAD:

   518

				if ((TrackStatusToTrackBits(GetTileTrackStatus(tile, TRANSPORT_RAIL, 0)) & _enterdir_to_trackbits[dir]) != TRACK_BIT_NONE) {

   519

					/* only add to set when there is some 'interesting' track */

   520

					_tbdset.Add(tile, dir);

   521