src/tunnel_map.h
author rubidium
Thu, 31 May 2007 15:15:00 +0000
changeset 6764 d09d8d618a07
parent 6661 1716fce5ad29
child 7002 1bf6a62b0fcb
permissions -rw-r--r--
(svn r9999) -Feature: make it possible to disallow busses and lorries to go a specific way on straight pieces of road.
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     1
/* $Id$ */
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     2
6422
6679df1c05ba (svn r9558) -Documentation: doxygen and comment changes: 'T' now. Almost done
belugas
parents: 5475
diff changeset
     3
/** @file tunnel_map.h */
6679df1c05ba (svn r9558) -Documentation: doxygen and comment changes: 'T' now. Almost done
belugas
parents: 5475
diff changeset
     4
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     5
#ifndef TUNNEL_MAP_H
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     6
#define TUNNEL_MAP_H
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     7
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     8
#include "direction.h"
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     9
#include "macros.h"
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    10
#include "map.h"
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    11
#include "rail.h"
6661
1716fce5ad29 (svn r9892) -Codechange: lots of ground work for allowing multiple types of "road" with multiple owners on a single tile.
rubidium
parents: 6540
diff changeset
    12
#include "road.h"
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    13
6540
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    14
/**
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    15
 * Is this a tunnel (entrance)?
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    16
 * @param t the tile that might be a tunnel
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    17
 * @pre IsTileType(t, MP_TUNNELBRIDGE)
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    18
 * @return true if and only if this tile is a tunnel (entrance)
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    19
 */
3184
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    20
static inline bool IsTunnel(TileIndex t)
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    21
{
3369
cab209754317 (svn r4166) Sprinkle several map accessors with assert()s
tron
parents: 3184
diff changeset
    22
	assert(IsTileType(t, MP_TUNNELBRIDGE));
3184
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    23
	return !HASBIT(_m[t].m5, 7);
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    24
}
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    25
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    26
6540
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    27
/**
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    28
 * Is this a tunnel (entrance)?
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    29
 * @param t the tile that might be a tunnel
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    30
 * @return true if and only if this tile is a tunnel (entrance)
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    31
 */
3184
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    32
static inline bool IsTunnelTile(TileIndex t)
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    33
{
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    34
	return IsTileType(t, MP_TUNNELBRIDGE) && IsTunnel(t);
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    35
}
118a520164e4 (svn r3830) Move IsTunnelTile() from tile.h to tunnel_map.h and add IsTunnel(), which just checks for a tunnel, but not the tile type as IsTunnelTile() does
tron
parents: 3156
diff changeset
    36
6540
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    37
/**
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    38
 * Gets the direction facing out of the tunnel
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    39
 * @param t the tile to get the tunnel facing direction of
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    40
 * @pre IsTunnelTile(t)
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    41
 * @return the direction the tunnel is facing
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    42
 */
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    43
static inline DiagDirection GetTunnelDirection(TileIndex t)
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    44
{
3369
cab209754317 (svn r4166) Sprinkle several map accessors with assert()s
tron
parents: 3184
diff changeset
    45
	assert(IsTunnelTile(t));
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    46
	return (DiagDirection)GB(_m[t].m5, 0, 2);
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    47
}
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    48
6540
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    49
/**
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    50
 * Gets the transport type of the tunnel (road or rail)
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    51
 * @param t the tunnel entrance tile to get the type of
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    52
 * @pre IsTunnelTile(t)
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    53
 * @return the transport type in the tunnel
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    54
 */
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    55
static inline TransportType GetTunnelTransportType(TileIndex t)
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    56
{
3369
cab209754317 (svn r4166) Sprinkle several map accessors with assert()s
tron
parents: 3184
diff changeset
    57
	assert(IsTunnelTile(t));
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    58
	return (TransportType)GB(_m[t].m5, 2, 2);
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    59
}
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    60
6540
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    61
/**
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    62
 * Is this tunnel entrance in a snowy or desert area?
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    63
 * @param t the tunnel entrance tile
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    64
 * @pre IsTunnelTile(t)
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    65
 * @return true if and only if the tunnel entrance is in a snowy/desert area
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    66
 */
5410
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    67
static inline bool HasTunnelSnowOrDesert(TileIndex t)
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    68
{
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    69
	assert(IsTunnelTile(t));
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    70
	return HASBIT(_m[t].m4, 7);
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    71
}
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    72
6540
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    73
/**
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    74
 * Places this tunnel entrance in a snowy or desert area,
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    75
 * or takes it out of there.
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    76
 * @param t the tunnel entrance tile
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    77
 * @param snow_or_desert is the entrance in snow or desert (true), when
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    78
 *                       not in snow and not in desert false
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    79
 * @pre IsTunnelTile(t)
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    80
 */
5410
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    81
static inline void SetTunnelSnowOrDesert(TileIndex t, bool snow_or_desert)
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    82
{
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    83
	assert(IsTunnelTile(t));
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    84
	SB(_m[t].m4, 7, 1, snow_or_desert);
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    85
}
2dae82c6ea63 (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    86
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    87
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    88
TileIndex GetOtherTunnelEnd(TileIndex);
3156
f4caf4197189 (svn r3779) Move CheckTunnelInWay() to a more appropriate place, invert its result and give it a less ambiguous name (IsTunnelInWay)
tron
parents: 3154
diff changeset
    89
bool IsTunnelInWay(TileIndex, uint z);
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    90
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    91
6540
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    92
/**
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    93
 * Makes a road tunnel entrance
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    94
 * @param t the entrance of the tunnel
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    95
 * @param o the owner of the entrance
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    96
 * @param d the direction facing out of the tunnel
6661
1716fce5ad29 (svn r9892) -Codechange: lots of ground work for allowing multiple types of "road" with multiple owners on a single tile.
rubidium
parents: 6540
diff changeset
    97
 * @param r the road type used in the tunnel
6540
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
    98
 */
6661
1716fce5ad29 (svn r9892) -Codechange: lots of ground work for allowing multiple types of "road" with multiple owners on a single tile.
rubidium
parents: 6540
diff changeset
    99
static inline void MakeRoadTunnel(TileIndex t, Owner o, DiagDirection d, RoadTypes r)
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   100
{
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   101
	SetTileType(t, MP_TUNNELBRIDGE);
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   102
	SetTileOwner(t, o);
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   103
	_m[t].m2 = 0;
6661
1716fce5ad29 (svn r9892) -Codechange: lots of ground work for allowing multiple types of "road" with multiple owners on a single tile.
rubidium
parents: 6540
diff changeset
   104
	_m[t].m3 = r;
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   105
	_m[t].m4 = 0;
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   106
	_m[t].m5 = TRANSPORT_ROAD << 2 | d;
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   107
}
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   108
6540
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
   109
/**
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
   110
 * Makes a rail tunnel entrance
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
   111
 * @param t the entrance of the tunnel
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
   112
 * @param o the owner of the entrance
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
   113
 * @param d the direction facing out of the tunnel
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
   114
 * @param r the rail type used in the tunnel
d30795308feb (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6422
diff changeset
   115
 */
3154
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   116
static inline void MakeRailTunnel(TileIndex t, Owner o, DiagDirection d, RailType r)
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   117
{
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   118
	SetTileType(t, MP_TUNNELBRIDGE);
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   119
	SetTileOwner(t, o);
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   120
	_m[t].m2 = 0;
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   121
	_m[t].m3 = r;
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   122
	_m[t].m4 = 0;
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   123
	_m[t].m5 = TRANSPORT_RAIL << 2 | d;
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   124
}
6ab0cb6b7ab3 (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   125
4666
172a0cdf28a6 (svn r6560) - Codechange: Minor fix; add missing #include guards and comments, and correct svn properties on bmp.[ch]
peter1138
parents: 3369
diff changeset
   126
#endif /* TUNNEL_MAP_H */