src/road_map.h

   1 /* $Id: road_map.h 23595 2011-12-19 17:48:04Z rubidium $ */
   2
   3 /*
   4  * This file is part of OpenTTD.
   5  * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
   6  * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
   7  * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
   8  */
   9
  10 /** @file road_map.h Map accessors for roads. */
  11
  12 #ifndef ROAD_MAP_H
  13 #define ROAD_MAP_H
  14
  15 #include "track_func.h"
  16 #include "depot_type.h"
  17 #include "rail_type.h"
  18 #include "road_func.h"
  19 #include "tile_map.h"
  20
  21
  22 /** The different types of road tiles. */
  23 enum RoadTileType {
  24         ROAD_TILE_NORMAL,   ///< Normal road
  25         ROAD_TILE_CROSSING, ///< Level crossing
  26         ROAD_TILE_DEPOT,    ///< Depot (one entrance)
  27 };
  28
  29 /**
  30  * Get the type of the road tile.
  31  * @param t Tile to query.
  32  * @pre IsTileType(t, MP_ROAD)
  33  * @return The road tile type.
  34  */
  35 static inline RoadTileType GetRoadTileType(TileIndex t)
  36 {
  37         assert(IsTileType(t, MP_ROAD));
  38         return (RoadTileType)GB(_m[t].m5, 6, 2);
  39 }
  40
  41 /**
  42  * Return whether a tile is a normal road.
  43  * @param t Tile to query.
  44  * @pre IsTileType(t, MP_ROAD)
  45  * @return True if normal road.
  46  */
  47 static inline bool IsNormalRoad(TileIndex t)
  48 {
  49         return GetRoadTileType(t) == ROAD_TILE_NORMAL;
  50 }
  51
  52 /**
  53  * Return whether a tile is a normal road tile.
  54  * @param t Tile to query.
  55  * @return True if normal road tile.
  56  */
  57 static inline bool IsNormalRoadTile(TileIndex t)
  58 {
  59         return IsTileType(t, MP_ROAD) && IsNormalRoad(t);
  60 }
  61
  62 /**
  63  * Return whether a tile is a level crossing.
  64  * @param t Tile to query.
  65  * @pre IsTileType(t, MP_ROAD)
  66  * @return True if level crossing.
  67  */
  68 static inline bool IsLevelCrossing(TileIndex t)
  69 {
  70         return GetRoadTileType(t) == ROAD_TILE_CROSSING;
  71 }
  72
  73 /**
  74  * Return whether a tile is a level crossing tile.
  75  * @param t Tile to query.
  76  * @return True if level crossing tile.
  77  */
  78 static inline bool IsLevelCrossingTile(TileIndex t)
  79 {
  80         return IsTileType(t, MP_ROAD) && IsLevelCrossing(t);
  81 }
  82
  83 /**
  84  * Return whether a tile is a road depot.
  85  * @param t Tile to query.
  86  * @pre IsTileType(t, MP_ROAD)
  87  * @return True if road depot.
  88  */
  89 static inline bool IsRoadDepot(TileIndex t)
  90 {
  91         return GetRoadTileType(t) == ROAD_TILE_DEPOT;
  92 }
  93
  94 /**
  95  * Return whether a tile is a road depot tile.
  96  * @param t Tile to query.
  97  * @return True if road depot tile.
  98  */
  99 static inline bool IsRoadDepotTile(TileIndex t)
 100 {
 101         return IsTileType(t, MP_ROAD) && IsRoadDepot(t);
 102 }
 103
 104 /**
 105  * Get the present road bits for a specific road type.
 106  * @param t  The tile to query.
 107  * @param rt Road type.
 108  * @pre IsNormalRoad(t)
 109  * @return The present road bits for the road type.
 110  */
 111 static inline RoadBits GetRoadBits(TileIndex t, RoadType rt)
 112 {
 113         assert(IsNormalRoad(t));
 114         switch (rt) {
 115                 default: NOT_REACHED();
 116                 case ROADTYPE_ROAD: return (RoadBits)GB(_m[t].m5, 0, 4);
 117                 case ROADTYPE_TRAM: return (RoadBits)GB(_m[t].m3, 0, 4);
 118         }
 119 }
 120
 121 /**
 122  * Get all RoadBits set on a tile except from the given RoadType
 123  *
 124  * @param t The tile from which we want to get the RoadBits
 125  * @param rt The RoadType which we exclude from the querry
 126  * @return all set RoadBits of the tile which are not from the given RoadType
 127  */
 128 static inline RoadBits GetOtherRoadBits(TileIndex t, RoadType rt)
 129 {
 130         return GetRoadBits(t, rt == ROADTYPE_ROAD ? ROADTYPE_TRAM : ROADTYPE_ROAD);
 131 }
 132
 133 /**
 134  * Get all set RoadBits on the given tile
 135  *
 136  * @param tile The tile from which we want to get the RoadBits
 137  * @return all set RoadBits of the tile
 138  */
 139 static inline RoadBits GetAllRoadBits(TileIndex tile)
 140 {
 141         return GetRoadBits(tile, ROADTYPE_ROAD) | GetRoadBits(tile, ROADTYPE_TRAM);
 142 }
 143
 144 /**
 145  * Set the present road bits for a specific road type.
 146  * @param t  The tile to change.
 147  * @param r  The new road bits.
 148  * @param rt Road type.
 149  * @pre IsNormalRoad(t)
 150  */
 151 static inline void SetRoadBits(TileIndex t, RoadBits r, RoadType rt)
 152 {
 153         assert(IsNormalRoad(t)); // XXX incomplete
 154         switch (rt) {
 155                 default: NOT_REACHED();
 156                 case ROADTYPE_ROAD: SB(_m[t].m5, 0, 4, r); break;
 157                 case ROADTYPE_TRAM: SB(_m[t].m3, 0, 4, r); break;
 158         }
 159 }
 160
 161 /**
 162  * Get the present road types of a tile.
 163  * @param t The tile to query.
 164  * @return Present road types.
 165  */
 166 static inline RoadTypes GetRoadTypes(TileIndex t)
 167 {
 168         return (RoadTypes)GB(_me[t].m7, 6, 2);
 169 }
 170
 171 /**
 172  * Set the present road types of a tile.
 173  * @param t  The tile to change.
 174  * @param rt The new road types.
 175  */
 176 static inline void SetRoadTypes(TileIndex t, RoadTypes rt)
 177 {
 178         assert(IsTileType(t, MP_ROAD) || IsTileType(t, MP_STATION) || IsTileType(t, MP_TUNNELBRIDGE));
 179         SB(_me[t].m7, 6, 2, rt);
 180 }
 181
 182 /**
 183  * Check if a tile has a specific road type.
 184  * @param t  The tile to check.
 185  * @param rt Road type to check.
 186  * @return True if the tile has the specified road type.
 187  */
 188 static inline bool HasTileRoadType(TileIndex t, RoadType rt)
 189 {
 190         return HasBit(GetRoadTypes(t), rt);
 191 }
 192
 193 /**
 194  * Get the owner of a specific road type.
 195  * @param t  The tile to query.
 196  * @param rt The road type to get the owner of.
 197  * @return Owner of the given road type.
 198  */
 199 static inline Owner GetRoadOwner(TileIndex t, RoadType rt)
 200 {
 201         assert(IsTileType(t, MP_ROAD) || IsTileType(t, MP_STATION) || IsTileType(t, MP_TUNNELBRIDGE));
 202         switch (rt) {
 203                 default: NOT_REACHED();
 204                 case ROADTYPE_ROAD: return (Owner)GB(IsNormalRoadTile(t) ? _m[t].m1 : _me[t].m7, 0, 5);
 205                 case ROADTYPE_TRAM: {
 206                         /* Trams don't need OWNER_TOWN, and remapping OWNER_NONE
 207                          * to OWNER_TOWN makes it use one bit less */
 208                         Owner o = (Owner)GB(_m[t].m3, 4, 4);
 209                         return o == OWNER_TOWN ? OWNER_NONE : o;
 210                 }
 211         }
 212 }
 213
 214 /**
 215  * Set the owner of a specific road type.
 216  * @param t  The tile to change.
 217  * @param rt The road type to change the owner of.
 218  * @param o  New owner of the given road type.
 219  */
 220 static inline void SetRoadOwner(TileIndex t, RoadType rt, Owner o)
 221 {
 222         switch (rt) {
 223                 default: NOT_REACHED();
 224                 case ROADTYPE_ROAD: SB(IsNormalRoadTile(t) ? _m[t].m1 : _me[t].m7, 0, 5, o); break;
 225                 case ROADTYPE_TRAM: SB(_m[t].m3, 4, 4, o == OWNER_NONE ? OWNER_TOWN : o); break;
 226         }
 227 }
 228
 229 /**
 230  * Check if a specific road type is owned by an owner.
 231  * @param t  The tile to query.
 232  * @param rt The road type to compare the owner of.
 233  * @param o  Owner to compare with.
 234  * @pre HasTileRoadType(t, rt)
 235  * @return True if the road type is owned by the given owner.
 236  */
 237 static inline bool IsRoadOwner(TileIndex t, RoadType rt, Owner o)
 238 {
 239         assert(HasTileRoadType(t, rt));
 240         return (GetRoadOwner(t, rt) == o);
 241 }
 242
 243 /**
 244  * Checks if given tile has town owned road
 245  * @param t tile to check
 246  * @pre IsTileType(t, MP_ROAD)
 247  * @return true iff tile has road and the road is owned by a town
 248  */
 249 static inline bool HasTownOwnedRoad(TileIndex t)
 250 {
 251         return HasTileRoadType(t, ROADTYPE_ROAD) && IsRoadOwner(t, ROADTYPE_ROAD, OWNER_TOWN);
 252 }
 253
 254 /** Which directions are disallowed ? */
 255 enum DisallowedRoadDirections {
 256         DRD_NONE,       ///< None of the directions are disallowed
 257         DRD_SOUTHBOUND, ///< All southbound traffic is disallowed
 258         DRD_NORTHBOUND, ///< All northbound traffic is disallowed
 259         DRD_BOTH,       ///< All directions are disallowed
 260         DRD_END,        ///< Sentinel
 261 };
 262 DECLARE_ENUM_AS_BIT_SET(DisallowedRoadDirections)
 263 /** Helper information for extract tool. */
 264 template <> struct EnumPropsT<DisallowedRoadDirections> : MakeEnumPropsT<DisallowedRoadDirections, byte, DRD_NONE, DRD_END, DRD_END, 2> {};
 265
 266 /**
 267  * Gets the disallowed directions
 268  * @param t the tile to get the directions from
 269  * @return the disallowed directions
 270  */
 271 static inline DisallowedRoadDirections GetDisallowedRoadDirections(TileIndex t)
 272 {
 273         assert(IsNormalRoad(t));
 274         return (DisallowedRoadDirections)GB(_m[t].m5, 4, 2);
 275 }
 276
 277 /**
 278  * Sets the disallowed directions
 279  * @param t   the tile to set the directions for
 280  * @param drd the disallowed directions
 281  */
 282 static inline void SetDisallowedRoadDirections(TileIndex t, DisallowedRoadDirections drd)
 283 {
 284         assert(IsNormalRoad(t));
 285         assert(drd < DRD_END);
 286         SB(_m[t].m5, 4, 2, drd);
 287 }
 288
 289 /**
 290  * Get the road axis of a level crossing.
 291  * @param t The tile to query.
 292  * @pre IsLevelCrossing(t)
 293  * @return The axis of the road.
 294  */
 295 static inline Axis GetCrossingRoadAxis(TileIndex t)
 296 {
 297         assert(IsLevelCrossing(t));
 298         return (Axis)GB(_m[t].m5, 0, 1);
 299 }
 300
 301 /**
 302  * Get the rail axis of a level crossing.
 303  * @param t The tile to query.
 304  * @pre IsLevelCrossing(t)
 305  * @return The axis of the rail.
 306  */
 307 static inline Axis GetCrossingRailAxis(TileIndex t)
 308 {
 309         assert(IsLevelCrossing(t));
 310         return OtherAxis((Axis)GetCrossingRoadAxis(t));
 311 }
 312
 313 /**
 314  * Get the road bits of a level crossing.
 315  * @param tile The tile to query.
 316  * @return The present road bits.
 317  */
 318 static inline RoadBits GetCrossingRoadBits(TileIndex tile)
 319 {
 320         return GetCrossingRoadAxis(tile) == AXIS_X ? ROAD_X : ROAD_Y;
 321 }
 322
 323 /**
 324  * Get the rail track of a level crossing.
 325  * @param tile The tile to query.
 326  * @return The rail track.
 327  */
 328 static inline Track GetCrossingRailTrack(TileIndex tile)
 329 {
 330         return AxisToTrack(GetCrossingRailAxis(tile));
 331 }
 332
 333 /**
 334  * Get the rail track bits of a level crossing.
 335  * @param tile The tile to query.
 336  * @return The rail track bits.
 337  */
 338 static inline TrackBits GetCrossingRailBits(TileIndex tile)
 339 {
 340         return AxisToTrackBits(GetCrossingRailAxis(tile));
 341 }
 342
 343
 344 /**
 345  * Get the reservation state of the rail crossing
 346  * @param t the crossing tile
 347  * @return reservation state
 348  * @pre IsLevelCrossingTile(t)
 349  */
 350 static inline bool HasCrossingReservation(TileIndex t)
 351 {
 352         assert(IsLevelCrossingTile(t));
 353         return HasBit(_m[t].m5, 4);
 354 }
 355
 356 /**
 357  * Set the reservation state of the rail crossing
 358  * @note Works for both waypoints and rail depots
 359  * @param t the crossing tile
 360  * @param b the reservation state
 361  * @pre IsLevelCrossingTile(t)
 362  */
 363 static inline void SetCrossingReservation(TileIndex t, bool b)
 364 {
 365         assert(IsLevelCrossingTile(t));
 366         SB(_m[t].m5, 4, 1, b ? 1 : 0);
 367 }
 368
 369 /**
 370  * Get the reserved track bits for a rail crossing
 371  * @param t the tile
 372  * @pre IsLevelCrossingTile(t)
 373  * @return reserved track bits
 374  */
 375 static inline TrackBits GetCrossingReservationTrackBits(TileIndex t)
 376 {
 377         return HasCrossingReservation(t) ? GetCrossingRailBits(t) : TRACK_BIT_NONE;
 378 }
 379
 380 /**
 381  * Check if the level crossing is barred.
 382  * @param t The tile to query.
 383  * @pre IsLevelCrossing(t)
 384  * @return True if the level crossing is barred.
 385  */
 386 static inline bool IsCrossingBarred(TileIndex t)
 387 {
 388         assert(IsLevelCrossing(t));
 389         return HasBit(_m[t].m5, 5);
 390 }
 391
 392 /**
 393  * Set the bar state of a level crossing.
 394  * @param t The tile to modify.
 395  * @param barred True if the crossing should be barred, false otherwise.
 396  * @pre IsLevelCrossing(t)
 397  */
 398 static inline void SetCrossingBarred(TileIndex t, bool barred)
 399 {
 400         assert(IsLevelCrossing(t));
 401         SB(_m[t].m5, 5, 1, barred ? 1 : 0);
 402 }
 403
 404 /**
 405  * Unbar a level crossing.
 406  * @param t The tile to change.
 407  */
 408 static inline void UnbarCrossing(TileIndex t)
 409 {
 410         SetCrossingBarred(t, false);
 411 }
 412
 413 /**
 414  * Bar a level crossing.
 415  * @param t The tile to change.
 416  */
 417 static inline void BarCrossing(TileIndex t)
 418 {
 419         SetCrossingBarred(t, true);
 420 }
 421
 422 /** Check if a road tile has snow/desert. */
 423 #define IsOnDesert IsOnSnow
 424 /**
 425  * Check if a road tile has snow/desert.
 426  * @param t The tile to query.
 427  * @return True if the tile has snow/desert.
 428  */
 429 static inline bool IsOnSnow(TileIndex t)
 430 {
 431         return HasBit(_me[t].m7, 5);
 432 }
 433
 434 /** Toggle the snow/desert state of a road tile. */
 435 #define ToggleDesert ToggleSnow
 436 /**
 437  * Toggle the snow/desert state of a road tile.
 438  * @param t The tile to change.
 439  */
 440 static inline void ToggleSnow(TileIndex t)
 441 {
 442         ToggleBit(_me[t].m7, 5);
 443 }
 444
 445
 446 /** The possible road side decorations. */
 447 enum Roadside {
 448         ROADSIDE_BARREN           = 0, ///< Road on barren land
 449         ROADSIDE_GRASS            = 1, ///< Road on grass
 450         ROADSIDE_PAVED            = 2, ///< Road with paved sidewalks
 451         ROADSIDE_STREET_LIGHTS    = 3, ///< Road with street lights on paved sidewalks
 452         ROADSIDE_TREES            = 5, ///< Road with trees on paved sidewalks
 453         ROADSIDE_GRASS_ROAD_WORKS = 6, ///< Road on grass with road works
 454         ROADSIDE_PAVED_ROAD_WORKS = 7, ///< Road with sidewalks and road works
 455 };
 456
 457 /**
 458  * Get the decorations of a road.
 459  * @param tile The tile to query.
 460  * @return The road decoration of the tile.
 461  */
 462 static inline Roadside GetRoadside(TileIndex tile)
 463 {
 464         return (Roadside)GB(_me[tile].m6, 3, 3);
 465 }
 466
 467 /**
 468  * Set the decorations of a road.
 469  * @param tile The tile to change.
 470  * @param s    The new road decoration of the tile.
 471  */
 472 static inline void SetRoadside(TileIndex tile, Roadside s)
 473 {
 474         SB(_me[tile].m6, 3, 3, s);
 475 }
 476
 477 /**
 478  * Check if a tile has road works.
 479  * @param t The tile to check.
 480  * @return True if the tile has road works in progress.
 481  */
 482 static inline bool HasRoadWorks(TileIndex t)
 483 {
 484         return GetRoadside(t) >= ROADSIDE_GRASS_ROAD_WORKS;
 485 }
 486
 487 /**
 488  * Increase the progress counter of road works.
 489  * @param t The tile to modify.
 490  * @return True if the road works are in the last stage.
 491  */
 492 static inline bool IncreaseRoadWorksCounter(TileIndex t)
 493 {
 494         AB(_me[t].m7, 0, 4, 1);
 495
 496         return GB(_me[t].m7, 0, 4) == 15;
 497 }
 498
 499 /**
 500  * Start road works on a tile.
 501  * @param t The tile to start the work on.
 502  * @pre !HasRoadWorks(t)
 503  */
 504 static inline void StartRoadWorks(TileIndex t)
 505 {
 506         assert(!HasRoadWorks(t));
 507         /* Remove any trees or lamps in case or roadwork */
 508         switch (GetRoadside(t)) {
 509                 case ROADSIDE_BARREN:
 510                 case ROADSIDE_GRASS:  SetRoadside(t, ROADSIDE_GRASS_ROAD_WORKS); break;
 511                 default:              SetRoadside(t, ROADSIDE_PAVED_ROAD_WORKS); break;
 512         }
 513 }
 514
 515 /**
 516  * Terminate road works on a tile.
 517  * @param t Tile to stop the road works on.
 518  * @pre HasRoadWorks(t)
 519  */
 520 static inline void TerminateRoadWorks(TileIndex t)
 521 {
 522         assert(HasRoadWorks(t));
 523         SetRoadside(t, (Roadside)(GetRoadside(t) - ROADSIDE_GRASS_ROAD_WORKS + ROADSIDE_GRASS));
 524         /* Stop the counter */
 525         SB(_me[t].m7, 0, 4, 0);
 526 }
 527
 528
 529 /**
 530  * Get the direction of the exit of a road depot.
 531  * @param t The tile to query.
 532  * @return Diagonal direction of the depot exit.
 533  */
 534 static inline DiagDirection GetRoadDepotDirection(TileIndex t)
 535 {
 536         assert(IsRoadDepot(t));
 537         return (DiagDirection)GB(_m[t].m5, 0, 2);
 538 }
 539
 540
 541 RoadBits GetAnyRoadBits(TileIndex tile, RoadType rt, bool straight_tunnel_bridge_entrance = false);
 542
 543
 544 /**
 545  * Make a normal road tile.
 546  * @param t    Tile to make a normal road.
 547  * @param bits Road bits to set for all present road types.
 548  * @param rot  New present road types.
 549  * @param town Town ID if the road is a town-owned road.
 550  * @param road New owner of road.
 551  * @param tram New owner of tram tracks.
 552  */
 553 static inline void MakeRoadNormal(TileIndex t, RoadBits bits, RoadTypes rot, TownID town, Owner road, Owner tram)
 554 {
 555         SetTileType(t, MP_ROAD);
 556         SetTileOwner(t, road);
 557         _m[t].m2 = town;
 558         _m[t].m3 = (HasBit(rot, ROADTYPE_TRAM) ? bits : 0);
 559         _m[t].m4 = 0;
 560         _m[t].m5 = (HasBit(rot, ROADTYPE_ROAD) ? bits : 0) | ROAD_TILE_NORMAL << 6;
 561         SB(_me[t].m6, 2, 4, 0);
 562         _me[t].m7 = rot << 6;
 563         SetRoadOwner(t, ROADTYPE_TRAM, tram);
 564 }
 565
 566 /**
 567  * Make a level crossing.
 568  * @param t       Tile to make a level crossing.
 569  * @param road    New owner of road.
 570  * @param tram    New owner of tram tracks.
 571  * @param rail    New owner of the rail track.
 572  * @param roaddir Axis of the road.
 573  * @param rat     New rail type.
 574  * @param rot     New present road types.
 575  * @param town    Town ID if the road is a town-owned road.
 576  */
 577 static inline void MakeRoadCrossing(TileIndex t, Owner road, Owner tram, Owner rail, Axis roaddir, RailType rat, RoadTypes rot, uint town)
 578 {
 579         SetTileType(t, MP_ROAD);
 580         SetTileOwner(t, rail);
 581         _m[t].m2 = town;
 582
 583         SB(_m[t].m1, 7, 1, GB(rat, 4, 1));
 584         SB(_m[t].m3, 0, 4, GB(rat, 0, 4));
 585
 586         _m[t].m4 = 0;
 587         _m[t].m5 = ROAD_TILE_CROSSING << 6 | roaddir;
 588         SB(_me[t].m6, 2, 4, 0);
 589         _me[t].m7 = rot << 6 | road;
 590         SetRoadOwner(t, ROADTYPE_TRAM, tram);
 591 }
 592
 593 /**
 594  * Make a road depot.
 595  * @param t     Tile to make a level crossing.
 596  * @param owner New owner of the depot.
 597  * @param did   New depot ID.
 598  * @param dir   Direction of the depot exit.
 599  * @param rt    Road type of the depot.
 600  */
 601 static inline void MakeRoadDepot(TileIndex t, Owner owner, DepotID did, DiagDirection dir, RoadType rt)
 602 {
 603         SetTileType(t, MP_ROAD);
 604         SetTileOwner(t, owner);
 605         _m[t].m2 = did;
 606         _m[t].m3 = 0;
 607         _m[t].m4 = 0;
 608         _m[t].m5 = ROAD_TILE_DEPOT << 6 | dir;
 609         SB(_me[t].m6, 2, 4, 0);
 610         _me[t].m7 = RoadTypeToRoadTypes(rt) << 6 | owner;
 611         SetRoadOwner(t, ROADTYPE_TRAM, owner);
 612 }
 613
 614 #endif /* ROAD_MAP_H */