OpenTTD Source  20241108-master-g80f628063a
tile_map.h
Go to the documentation of this file.
1 /*
2  * This file is part of OpenTTD.
3  * 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.
4  * 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.
5  * 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/>.
6  */
7 
10 #ifndef TILE_MAP_H
11 #define TILE_MAP_H
12 
13 #include "slope_type.h"
14 #include "map_func.h"
15 #include "core/bitmath_func.hpp"
16 #include "settings_type.h"
17 
29 debug_inline static uint TileHeight(Tile tile)
30 {
31  assert(tile < Map::Size());
32  return tile.height();
33 }
34 
42 inline uint TileHeightOutsideMap(int x, int y)
43 {
44  return TileHeight(TileXY(Clamp(x, 0, Map::MaxX()), Clamp(y, 0, Map::MaxY())));
45 }
46 
57 inline void SetTileHeight(Tile tile, uint height)
58 {
59  assert(tile < Map::Size());
60  assert(height <= MAX_TILE_HEIGHT);
61  tile.height() = height;
62 }
63 
72 inline uint TilePixelHeight(Tile tile)
73 {
74  return TileHeight(tile) * TILE_HEIGHT;
75 }
76 
84 inline uint TilePixelHeightOutsideMap(int x, int y)
85 {
86  return TileHeightOutsideMap(x, y) * TILE_HEIGHT;
87 }
88 
96 debug_inline static TileType GetTileType(Tile tile)
97 {
98  assert(tile < Map::Size());
99  return (TileType)GB(tile.type(), 4, 4);
100 }
101 
109 inline bool IsInnerTile(Tile tile)
110 {
111  assert(tile < Map::Size());
112 
113  uint x = TileX(tile);
114  uint y = TileY(tile);
115 
116  return x < Map::MaxX() && y < Map::MaxY() && ((x > 0 && y > 0) || !_settings_game.construction.freeform_edges);
117 }
118 
131 inline void SetTileType(Tile tile, TileType type)
132 {
133  assert(tile < Map::Size());
134  /* VOID tiles (and no others) are exactly allowed at the lower left and right
135  * edges of the map. If _settings_game.construction.freeform_edges is true,
136  * the upper edges of the map are also VOID tiles. */
137  assert(IsInnerTile(tile) == (type != MP_VOID));
138  SB(tile.type(), 4, 4, type);
139 }
140 
150 debug_inline static bool IsTileType(Tile tile, TileType type)
151 {
152  return GetTileType(tile) == type;
153 }
154 
161 inline bool IsValidTile(Tile tile)
162 {
163  return tile < Map::Size() && !IsTileType(tile, MP_VOID);
164 }
165 
178 inline Owner GetTileOwner(Tile tile)
179 {
180  assert(IsValidTile(tile));
181  assert(!IsTileType(tile, MP_HOUSE));
182  assert(!IsTileType(tile, MP_INDUSTRY));
183 
184  return (Owner)GB(tile.m1(), 0, 5);
185 }
186 
198 inline void SetTileOwner(Tile tile, Owner owner)
199 {
200  assert(IsValidTile(tile));
201  assert(!IsTileType(tile, MP_HOUSE));
202  assert(!IsTileType(tile, MP_INDUSTRY));
203 
204  SB(tile.m1(), 0, 5, owner);
205 }
206 
214 inline bool IsTileOwner(Tile tile, Owner owner)
215 {
216  return GetTileOwner(tile) == owner;
217 }
218 
225 inline void SetTropicZone(Tile tile, TropicZone type)
226 {
227  assert(tile < Map::Size());
228  assert(!IsTileType(tile, MP_VOID) || type == TROPICZONE_NORMAL);
229  SB(tile.type(), 0, 2, type);
230 }
231 
239 {
240  assert(tile < Map::Size());
241  return (TropicZone)GB(tile.type(), 0, 2);
242 }
243 
250 inline uint8_t GetAnimationFrame(Tile t)
251 {
253  return t.m7();
254 }
255 
262 inline void SetAnimationFrame(Tile t, uint8_t frame)
263 {
265  t.m7() = frame;
266 }
267 
268 std::tuple<Slope, int> GetTileSlopeZ(TileIndex tile);
269 int GetTileZ(TileIndex tile);
270 int GetTileMaxZ(TileIndex tile);
271 
272 bool IsTileFlat(TileIndex tile, int *h = nullptr);
273 
280 {
281  return std::get<0>(GetTileSlopeZ(tile));
282 }
283 
289 inline std::tuple<Slope, int> GetTilePixelSlope(TileIndex tile)
290 {
291  auto [s, h] = GetTileSlopeZ(tile);
292  return {s, h * TILE_HEIGHT};
293 }
294 
295 std::tuple<Slope, int> GetTilePixelSlopeOutsideMap(int x, int y);
296 
302 inline int GetTilePixelZ(TileIndex tile)
303 {
304  return GetTileZ(tile) * TILE_HEIGHT;
305 }
306 
312 inline int GetTileMaxPixelZ(TileIndex tile)
313 {
314  return GetTileMaxZ(tile) * TILE_HEIGHT;
315 }
316 
324 inline uint TileHash(uint x, uint y)
325 {
326  uint hash = x >> 4;
327  hash ^= x >> 6;
328  hash ^= y >> 4;
329  hash -= y >> 6;
330  return hash;
331 }
332 
342 inline uint TileHash2Bit(uint x, uint y)
343 {
344  return GB(TileHash(x, y), 0, 2);
345 }
346 
347 #endif /* TILE_MAP_H */
Functions related to bit mathematics.
constexpr T SB(T &x, const uint8_t s, const uint8_t n, const U d)
Set n bits in x starting at bit s to d.
constexpr static debug_inline uint GB(const T x, const uint8_t s, const uint8_t n)
Fetch n bits from x, started at bit s.
Wrapper class to abstract away the way the tiles are stored.
Definition: map_func.h:25
debug_inline uint8_t & m7()
Primarily used for newgrf support.
Definition: map_func.h:185
debug_inline uint8_t & type()
The type (bits 4..7), bridges (2..3), rainforest/desert (0..1)
Definition: map_func.h:89
debug_inline uint8_t & m1()
Primarily used for ownership information.
Definition: map_func.h:113
debug_inline uint8_t & height()
The height of the northern corner.
Definition: map_func.h:101
Owner
Enum for all companies/owners.
Definition: company_type.h:18
Functions related to maps.
static debug_inline TileIndex TileXY(uint x, uint y)
Returns the TileIndex of a coordinate.
Definition: map_func.h:373
static debug_inline uint TileY(TileIndex tile)
Get the Y component of a tile.
Definition: map_func.h:425
static debug_inline uint TileX(TileIndex tile)
Get the X component of a tile.
Definition: map_func.h:415
constexpr T Clamp(const T a, const T min, const T max)
Clamp a value between an interval.
Definition: math_func.hpp:79
GameSettings _settings_game
Game settings of a running game or the scenario editor.
Definition: settings.cpp:57
Types related to global configuration settings.
Definitions of a slope.
Slope
Enumeration for the slope-type.
Definition: slope_type.h:48
bool freeform_edges
allow terraforming the tiles at the map edges
ConstructionSettings construction
construction of things in-game
static uint MaxY()
Gets the maximum Y coordinate within the map, including MP_VOID.
Definition: map_func.h:306
static debug_inline uint Size()
Get the size of the map.
Definition: map_func.h:288
static debug_inline uint MaxX()
Gets the maximum X coordinate within the map, including MP_VOID.
Definition: map_func.h:297
uint TileHash(uint x, uint y)
Calculate a hash value from a tile position.
Definition: tile_map.h:324
bool IsTileOwner(Tile tile, Owner owner)
Checks if a tile belongs to the given owner.
Definition: tile_map.h:214
void SetTileType(Tile tile, TileType type)
Set the type of a tile.
Definition: tile_map.h:131
int GetTilePixelZ(TileIndex tile)
Get bottom height of the tile.
Definition: tile_map.h:302
Owner GetTileOwner(Tile tile)
Returns the owner of a tile.
Definition: tile_map.h:178
void SetTileOwner(Tile tile, Owner owner)
Sets the owner of a tile.
Definition: tile_map.h:198
int GetTileMaxPixelZ(TileIndex tile)
Get top height of the tile.
Definition: tile_map.h:312
static debug_inline TileType GetTileType(Tile tile)
Get the tiletype of a given tile.
Definition: tile_map.h:96
uint8_t GetAnimationFrame(Tile t)
Get the current animation frame.
Definition: tile_map.h:250
bool IsValidTile(Tile tile)
Checks if a tile is valid.
Definition: tile_map.h:161
bool IsInnerTile(Tile tile)
Check if a tile is within the map (not a border)
Definition: tile_map.h:109
uint TilePixelHeight(Tile tile)
Returns the height of a tile in pixels.
Definition: tile_map.h:72
bool IsTileFlat(TileIndex tile, int *h=nullptr)
Check if a given tile is flat.
Definition: tile_map.cpp:95
uint TileHash2Bit(uint x, uint y)
Get the last two bits of the TileHash from a tile position.
Definition: tile_map.h:342
std::tuple< Slope, int > GetTilePixelSlopeOutsideMap(int x, int y)
Return the slope of a given tile, also for tiles outside the map (virtual "black" tiles).
Definition: tile_map.cpp:78
TropicZone GetTropicZone(Tile tile)
Get the tropic zone.
Definition: tile_map.h:238
uint TilePixelHeightOutsideMap(int x, int y)
Returns the height of a tile in pixels, also for tiles outside the map (virtual "black" tiles).
Definition: tile_map.h:84
std::tuple< Slope, int > GetTileSlopeZ(TileIndex tile)
Return the slope of a given tile inside the map.
Definition: tile_map.cpp:55
int GetTileMaxZ(TileIndex tile)
Get top height of the tile inside the map.
Definition: tile_map.cpp:136
void SetAnimationFrame(Tile t, uint8_t frame)
Set a new animation frame.
Definition: tile_map.h:262
void SetTileHeight(Tile tile, uint height)
Sets the height of a tile.
Definition: tile_map.h:57
std::tuple< Slope, int > GetTilePixelSlope(TileIndex tile)
Return the slope of a given tile.
Definition: tile_map.h:289
static debug_inline bool IsTileType(Tile tile, TileType type)
Checks if a tile is a given tiletype.
Definition: tile_map.h:150
Slope GetTileSlope(TileIndex tile)
Return the slope of a given tile inside the map.
Definition: tile_map.h:279
void SetTropicZone(Tile tile, TropicZone type)
Set the tropic zone.
Definition: tile_map.h:225
static debug_inline uint TileHeight(Tile tile)
Returns the height of a tile.
Definition: tile_map.h:29
uint TileHeightOutsideMap(int x, int y)
Returns the height of a tile, also for tiles outside the map (virtual "black" tiles).
Definition: tile_map.h:42
int GetTileZ(TileIndex tile)
Get bottom height of the tile.
Definition: tile_map.cpp:116
TropicZone
Additional infos of a tile on a tropic game.
Definition: tile_type.h:76
@ TROPICZONE_NORMAL
Normal tropiczone.
Definition: tile_type.h:77
static const uint TILE_HEIGHT
Height of a height level in world coordinate AND in pixels in #ZOOM_BASE.
Definition: tile_type.h:18
static const uint MAX_TILE_HEIGHT
Maximum allowed tile height.
Definition: tile_type.h:24
TileType
The different types of tiles.
Definition: tile_type.h:47
@ MP_STATION
A tile of a station.
Definition: tile_type.h:53
@ MP_HOUSE
A house by a town.
Definition: tile_type.h:51
@ MP_INDUSTRY
Part of an industry.
Definition: tile_type.h:56
@ MP_VOID
Invisible tiles at the SW and SE border.
Definition: tile_type.h:55
@ MP_OBJECT
Contains objects such as transmitters and owned land.
Definition: tile_type.h:58