src/tunnel_map.h
author skidd13
Mon, 19 Nov 2007 21:02:30 +0000
changeset 8424 4a488a90ccab
parent 7498 ce6588257e8d
child 8579 3efbb430092e
child 9723 eee46cb39750
permissions -rw-r--r--
(svn r11481) -Codechange: Rename the HASBIT function to fit with the naming style
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     1
/* $Id$ */
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     2
6918
5589c415e28f (svn r9558) -Documentation: doxygen and comment changes: 'T' now. Almost done
belugas
parents: 5726
diff changeset
     3
/** @file tunnel_map.h */
5589c415e28f (svn r9558) -Documentation: doxygen and comment changes: 'T' now. Almost done
belugas
parents: 5726
diff changeset
     4
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     5
#ifndef TUNNEL_MAP_H
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     6
#define TUNNEL_MAP_H
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     7
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     8
#include "direction.h"
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
     9
#include "macros.h"
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    10
#include "map.h"
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    11
#include "rail.h"
7157
270bc5b64e08 (svn r9892) -Codechange: lots of ground work for allowing multiple types of "road" with multiple owners on a single tile.
rubidium
parents: 7036
diff changeset
    12
#include "road.h"
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    13
7036
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    14
/**
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    15
 * Is this a tunnel (entrance)?
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    16
 * @param t the tile that might be a tunnel
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    17
 * @pre IsTileType(t, MP_TUNNELBRIDGE)
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    18
 * @return true if and only if this tile is a tunnel (entrance)
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    19
 */
3184
7405329343ce (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)
7405329343ce (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
00c2ca209a89 (svn r4166) Sprinkle several map accessors with assert()s
tron
parents: 3184
diff changeset
    22
	assert(IsTileType(t, MP_TUNNELBRIDGE));
8424
4a488a90ccab (svn r11481) -Codechange: Rename the HASBIT function to fit with the naming style
skidd13
parents: 7498
diff changeset
    23
	return !HasBit(_m[t].m5, 7);
3184
7405329343ce (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
}
7405329343ce (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
7405329343ce (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
7036
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    27
/**
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    28
 * Is this a tunnel (entrance)?
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    29
 * @param t the tile that might be a tunnel
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    30
 * @return true if and only if this tile is a tunnel (entrance)
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    31
 */
3184
7405329343ce (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)
7405329343ce (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
{
7405329343ce (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);
7405329343ce (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
}
7405329343ce (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
7036
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    37
/**
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    38
 * Gets the direction facing out of the tunnel
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    39
 * @param t the tile to get the tunnel facing direction of
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    40
 * @pre IsTunnelTile(t)
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    41
 * @return the direction the tunnel is facing
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    42
 */
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    43
static inline DiagDirection GetTunnelDirection(TileIndex t)
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    44
{
3369
00c2ca209a89 (svn r4166) Sprinkle several map accessors with assert()s
tron
parents: 3184
diff changeset
    45
	assert(IsTunnelTile(t));
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    46
	return (DiagDirection)GB(_m[t].m5, 0, 2);
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    47
}
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    48
7036
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    49
/**
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    50
 * Gets the transport type of the tunnel (road or rail)
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    51
 * @param t the tunnel entrance tile to get the type of
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    52
 * @pre IsTunnelTile(t)
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    53
 * @return the transport type in the tunnel
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    54
 */
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    55
static inline TransportType GetTunnelTransportType(TileIndex t)
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    56
{
3369
00c2ca209a89 (svn r4166) Sprinkle several map accessors with assert()s
tron
parents: 3184
diff changeset
    57
	assert(IsTunnelTile(t));
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    58
	return (TransportType)GB(_m[t].m5, 2, 2);
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    59
}
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    60
7036
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    61
/**
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    62
 * Is this tunnel entrance in a snowy or desert area?
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    63
 * @param t the tunnel entrance tile
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    64
 * @pre IsTunnelTile(t)
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    65
 * @return true if and only if the tunnel entrance is in a snowy/desert area
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    66
 */
5661
6c6145677e7c (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)
6c6145677e7c (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    68
{
6c6145677e7c (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    69
	assert(IsTunnelTile(t));
8424
4a488a90ccab (svn r11481) -Codechange: Rename the HASBIT function to fit with the naming style
skidd13
parents: 7498
diff changeset
    70
	return HasBit(_m[t].m4, 7);
5661
6c6145677e7c (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    71
}
6c6145677e7c (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    72
7036
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    73
/**
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    74
 * Places this tunnel entrance in a snowy or desert area,
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    75
 * or takes it out of there.
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    76
 * @param t the tunnel entrance tile
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    77
 * @param snow_or_desert is the entrance in snow or desert (true), when
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    78
 *                       not in snow and not in desert false
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    79
 * @pre IsTunnelTile(t)
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    80
 */
5661
6c6145677e7c (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)
6c6145677e7c (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    82
{
6c6145677e7c (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    83
	assert(IsTunnelTile(t));
6c6145677e7c (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);
6c6145677e7c (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    85
}
6c6145677e7c (svn r7607) -Codechange: remove direct map accesses for snow/desert on tunnels and bridges.
rubidium
parents: 4666
diff changeset
    86
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    87
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    88
TileIndex GetOtherTunnelEnd(TileIndex);
3156
028b6756b279 (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);
7498
ce6588257e8d (svn r10258) -Codechange: as we are now using int64 all over the place, it's better to use int64 variables in the string generating too instead of packing them into two int32s.
rubidium
parents: 7157
diff changeset
    90
bool IsTunnelInWayDir(TileIndex tile, uint z, DiagDirection dir);
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    91
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
    92
7036
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    93
/**
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    94
 * Makes a road tunnel entrance
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    95
 * @param t the entrance of the tunnel
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    96
 * @param o the owner of the entrance
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    97
 * @param d the direction facing out of the tunnel
7157
270bc5b64e08 (svn r9892) -Codechange: lots of ground work for allowing multiple types of "road" with multiple owners on a single tile.
rubidium
parents: 7036
diff changeset
    98
 * @param r the road type used in the tunnel
7036
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
    99
 */
7157
270bc5b64e08 (svn r9892) -Codechange: lots of ground work for allowing multiple types of "road" with multiple owners on a single tile.
rubidium
parents: 7036
diff changeset
   100
static inline void MakeRoadTunnel(TileIndex t, Owner o, DiagDirection d, RoadTypes r)
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   101
{
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   102
	SetTileType(t, MP_TUNNELBRIDGE);
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   103
	SetTileOwner(t, o);
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   104
	_m[t].m2 = 0;
7157
270bc5b64e08 (svn r9892) -Codechange: lots of ground work for allowing multiple types of "road" with multiple owners on a single tile.
rubidium
parents: 7036
diff changeset
   105
	_m[t].m3 = r;
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   106
	_m[t].m4 = 0;
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   107
	_m[t].m5 = TRANSPORT_ROAD << 2 | d;
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   108
}
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   109
7036
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
   110
/**
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
   111
 * Makes a rail tunnel entrance
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
   112
 * @param t the entrance of the tunnel
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
   113
 * @param o the owner of the entrance
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
   114
 * @param d the direction facing out of the tunnel
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
   115
 * @param r the rail type used in the tunnel
9f23930e7ded (svn r9729) -Documentation: add some documentation in various places
rubidium
parents: 6918
diff changeset
   116
 */
3154
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   117
static inline void MakeRailTunnel(TileIndex t, Owner o, DiagDirection d, RailType r)
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   118
{
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   119
	SetTileType(t, MP_TUNNELBRIDGE);
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   120
	SetTileOwner(t, o);
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   121
	_m[t].m2 = 0;
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   122
	_m[t].m3 = r;
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   123
	_m[t].m4 = 0;
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   124
	_m[t].m5 = TRANSPORT_RAIL << 2 | d;
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   125
}
a8fffb204d0e (svn r3777) Add some functions to handle tunnels
tron
parents:
diff changeset
   126
4666
850b5b6e4bac (svn r6560) - Codechange: Minor fix; add missing #include guards and comments, and correct svn properties on bmp.[ch]
peter1138
parents: 3369
diff changeset
   127
#endif /* TUNNEL_MAP_H */