Fix 56510b5d7b: CargoArray does need to be initialised... (#13168)
[openttd-github.git] / src / terraform_cmd.cpp
blobcb37bf57bc24619ee768a57f074a9dff60975280
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 */
8 /** @file terraform_cmd.cpp Commands related to terraforming. */
10 #include "stdafx.h"
11 #include "command_func.h"
12 #include "tunnel_map.h"
13 #include "bridge_map.h"
14 #include "viewport_func.h"
15 #include "genworld.h"
16 #include "object_base.h"
17 #include "company_base.h"
18 #include "company_func.h"
19 #include "core/backup_type.hpp"
20 #include "terraform_cmd.h"
21 #include "landscape_cmd.h"
23 #include "table/strings.h"
25 #include "safeguards.h"
27 /** Set of tiles. */
28 typedef std::set<TileIndex> TileIndexSet;
29 /** Mapping of tiles to their height. */
30 typedef std::map<TileIndex, int> TileIndexToHeightMap;
32 /** State of the terraforming. */
33 struct TerraformerState {
34 TileIndexSet dirty_tiles; ///< The tiles that need to be redrawn.
35 TileIndexToHeightMap tile_to_new_height; ///< The tiles for which the height has changed.
38 /**
39 * Gets the TileHeight (height of north corner) of a tile as of current terraforming progress.
41 * @param ts TerraformerState.
42 * @param tile Tile.
43 * @return TileHeight.
45 static int TerraformGetHeightOfTile(const TerraformerState *ts, TileIndex tile)
47 TileIndexToHeightMap::const_iterator it = ts->tile_to_new_height.find(tile);
48 return it != ts->tile_to_new_height.end() ? it->second : TileHeight(tile);
51 /**
52 * Stores the TileHeight (height of north corner) of a tile in a TerraformerState.
54 * @param ts TerraformerState.
55 * @param tile Tile.
56 * @param height New TileHeight.
58 static void TerraformSetHeightOfTile(TerraformerState *ts, TileIndex tile, int height)
60 ts->tile_to_new_height[tile] = height;
63 /**
64 * Adds a tile to the "tile_table" in a TerraformerState.
66 * @param ts TerraformerState.
67 * @param tile Tile.
68 * @ingroup dirty
70 static void TerraformAddDirtyTile(TerraformerState *ts, TileIndex tile)
72 ts->dirty_tiles.insert(tile);
75 /**
76 * Adds all tiles that incident with the north corner of a specific tile to the "tile_table" in a TerraformerState.
78 * @param ts TerraformerState.
79 * @param tile Tile.
80 * @ingroup dirty
82 static void TerraformAddDirtyTileAround(TerraformerState *ts, TileIndex tile)
84 /* Make sure all tiles passed to TerraformAddDirtyTile are within [0, Map::Size()] */
85 if (TileY(tile) >= 1) TerraformAddDirtyTile(ts, tile + TileDiffXY( 0, -1));
86 if (TileY(tile) >= 1 && TileX(tile) >= 1) TerraformAddDirtyTile(ts, tile + TileDiffXY(-1, -1));
87 if (TileX(tile) >= 1) TerraformAddDirtyTile(ts, tile + TileDiffXY(-1, 0));
88 TerraformAddDirtyTile(ts, tile);
91 /**
92 * Terraform the north corner of a tile to a specific height.
94 * @param ts TerraformerState.
95 * @param tile Tile.
96 * @param height Aimed height.
97 * @return Error code or cost.
99 static std::tuple<CommandCost, TileIndex> TerraformTileHeight(TerraformerState *ts, TileIndex tile, int height)
101 assert(tile < Map::Size());
103 /* Check range of destination height */
104 if (height < 0) return { CommandCost(STR_ERROR_ALREADY_AT_SEA_LEVEL), INVALID_TILE };
105 if (height > _settings_game.construction.map_height_limit) return { CommandCost(STR_ERROR_TOO_HIGH), INVALID_TILE };
108 * Check if the terraforming has any effect.
109 * This can only be true, if multiple corners of the start-tile are terraformed (i.e. the terraforming is done by towns/industries etc.).
110 * In this case the terraforming should fail. (Don't know why.)
112 if (height == TerraformGetHeightOfTile(ts, tile)) return { CMD_ERROR, INVALID_TILE };
114 /* Check "too close to edge of map". Only possible when freeform-edges is off. */
115 uint x = TileX(tile);
116 uint y = TileY(tile);
117 if (!_settings_game.construction.freeform_edges && ((x <= 1) || (y <= 1) || (x >= Map::MaxX() - 1) || (y >= Map::MaxY() - 1))) {
119 * Determine a sensible error tile
121 if (x == 1) x = 0;
122 if (y == 1) y = 0;
123 return { CommandCost(STR_ERROR_TOO_CLOSE_TO_EDGE_OF_MAP), TileXY(x, y) };
126 /* Mark incident tiles that are involved in the terraforming. */
127 TerraformAddDirtyTileAround(ts, tile);
129 /* Store the height modification */
130 TerraformSetHeightOfTile(ts, tile, height);
132 CommandCost total_cost(EXPENSES_CONSTRUCTION);
134 /* Increment cost */
135 total_cost.AddCost(_price[PR_TERRAFORM]);
137 /* Recurse to neighboured corners if height difference is larger than 1 */
138 for (DiagDirection dir = DIAGDIR_BEGIN; dir < DIAGDIR_END; dir++) {
139 TileIndex neighbour_tile = AddTileIndexDiffCWrap(tile, TileIndexDiffCByDiagDir(dir));
141 /* Not using IsValidTile as we want to also change MP_VOID tiles, which IsValidTile excludes. */
142 if (neighbour_tile == INVALID_TILE) continue;
144 /* Get TileHeight of neighboured tile as of current terraform progress */
145 int r = TerraformGetHeightOfTile(ts, neighbour_tile);
146 int height_diff = height - r;
148 /* Is the height difference to the neighboured corner greater than 1? */
149 if (abs(height_diff) > 1) {
150 /* Terraform the neighboured corner. The resulting height difference should be 1. */
151 height_diff += (height_diff < 0 ? 1 : -1);
152 auto [cost, err_tile] = TerraformTileHeight(ts, neighbour_tile, r + height_diff);
153 if (cost.Failed()) return { cost, err_tile };
154 total_cost.AddCost(cost);
158 return { total_cost, INVALID_TILE };
162 * Terraform land
163 * @param flags for this command type
164 * @param tile tile to terraform
165 * @param slope corners to terraform (SLOPE_xxx)
166 * @param dir_up direction; eg up (true) or down (false)
167 * @return the cost of this operation or an error
169 std::tuple<CommandCost, Money, TileIndex> CmdTerraformLand(DoCommandFlag flags, TileIndex tile, Slope slope, bool dir_up)
171 CommandCost total_cost(EXPENSES_CONSTRUCTION);
172 int direction = (dir_up ? 1 : -1);
173 TerraformerState ts;
175 /* Compute the costs and the terraforming result in a model of the landscape */
176 if ((slope & SLOPE_W) != 0 && tile + TileDiffXY(1, 0) < Map::Size()) {
177 TileIndex t = tile + TileDiffXY(1, 0);
178 auto [cost, err_tile] = TerraformTileHeight(&ts, t, TileHeight(t) + direction);
179 if (cost.Failed()) return { cost, 0, err_tile };
180 total_cost.AddCost(cost);
183 if ((slope & SLOPE_S) != 0 && tile + TileDiffXY(1, 1) < Map::Size()) {
184 TileIndex t = tile + TileDiffXY(1, 1);
185 auto [cost, err_tile] = TerraformTileHeight(&ts, t, TileHeight(t) + direction);
186 if (cost.Failed()) return { cost, 0, err_tile };
187 total_cost.AddCost(cost);
190 if ((slope & SLOPE_E) != 0 && tile + TileDiffXY(0, 1) < Map::Size()) {
191 TileIndex t = tile + TileDiffXY(0, 1);
192 auto [cost, err_tile] = TerraformTileHeight(&ts, t, TileHeight(t) + direction);
193 if (cost.Failed()) return { cost, 0, err_tile };
194 total_cost.AddCost(cost);
197 if ((slope & SLOPE_N) != 0) {
198 TileIndex t = tile + TileDiffXY(0, 0);
199 auto [cost, err_tile] = TerraformTileHeight(&ts, t, TileHeight(t) + direction);
200 if (cost.Failed()) return { cost, 0, err_tile };
201 total_cost.AddCost(cost);
204 /* Check if the terraforming is valid wrt. tunnels, bridges and objects on the surface
205 * Pass == 0: Collect tileareas which are caused to be auto-cleared.
206 * Pass == 1: Collect the actual cost. */
207 for (int pass = 0; pass < 2; pass++) {
208 for (const auto &t : ts.dirty_tiles) {
209 assert(t < Map::Size());
210 /* MP_VOID tiles can be terraformed but as tunnels and bridges
211 * cannot go under / over these tiles they don't need checking. */
212 if (IsTileType(t, MP_VOID)) continue;
214 /* Find new heights of tile corners */
215 int z_N = TerraformGetHeightOfTile(&ts, t + TileDiffXY(0, 0));
216 int z_W = TerraformGetHeightOfTile(&ts, t + TileDiffXY(1, 0));
217 int z_S = TerraformGetHeightOfTile(&ts, t + TileDiffXY(1, 1));
218 int z_E = TerraformGetHeightOfTile(&ts, t + TileDiffXY(0, 1));
220 /* Find min and max height of tile */
221 int z_min = std::min({z_N, z_W, z_S, z_E});
222 int z_max = std::max({z_N, z_W, z_S, z_E});
224 /* Compute tile slope */
225 Slope tileh = (z_max > z_min + 1 ? SLOPE_STEEP : SLOPE_FLAT);
226 if (z_W > z_min) tileh |= SLOPE_W;
227 if (z_S > z_min) tileh |= SLOPE_S;
228 if (z_E > z_min) tileh |= SLOPE_E;
229 if (z_N > z_min) tileh |= SLOPE_N;
231 if (pass == 0) {
232 /* Check if bridge would take damage */
233 if (IsBridgeAbove(t)) {
234 int bridge_height = GetBridgeHeight(GetSouthernBridgeEnd(t));
236 /* Check if bridge would take damage. */
237 if (direction == 1 && bridge_height <= z_max) {
238 return { CommandCost(STR_ERROR_MUST_DEMOLISH_BRIDGE_FIRST), 0, t }; // highlight the tile under the bridge
241 /* Is the bridge above not too high afterwards? */
242 if (direction == -1 && bridge_height > (z_min + _settings_game.construction.max_bridge_height)) {
243 return { CommandCost(STR_ERROR_BRIDGE_TOO_HIGH_AFTER_LOWER_LAND), 0, t };
246 /* Check if tunnel would take damage */
247 if (direction == -1 && IsTunnelInWay(t, z_min)) {
248 return { CommandCost(STR_ERROR_EXCAVATION_WOULD_DAMAGE), 0, t }; // highlight the tile above the tunnel
252 /* Is the tile already cleared? */
253 const ClearedObjectArea *coa = FindClearedObject(t);
254 bool indirectly_cleared = coa != nullptr && coa->first_tile != t;
256 /* Check tiletype-specific things, and add extra-cost */
257 Backup<bool> old_generating_world(_generating_world);
258 if (_game_mode == GM_EDITOR) old_generating_world.Change(true); // used to create green terraformed land
259 DoCommandFlag tile_flags = flags | DC_AUTO | DC_FORCE_CLEAR_TILE;
260 if (pass == 0) {
261 tile_flags &= ~DC_EXEC;
262 tile_flags |= DC_NO_MODIFY_TOWN_RATING;
264 CommandCost cost;
265 if (indirectly_cleared) {
266 cost = Command<CMD_LANDSCAPE_CLEAR>::Do(tile_flags, t);
267 } else {
268 cost = _tile_type_procs[GetTileType(t)]->terraform_tile_proc(t, tile_flags, z_min, tileh);
270 old_generating_world.Restore();
271 if (cost.Failed()) {
272 return { cost, 0, t };
274 if (pass == 1) total_cost.AddCost(cost);
278 Company *c = Company::GetIfValid(_current_company);
279 if (c != nullptr && GB(c->terraform_limit, 16, 16) < ts.tile_to_new_height.size()) {
280 return { CommandCost(STR_ERROR_TERRAFORM_LIMIT_REACHED), 0, INVALID_TILE };
283 if (flags & DC_EXEC) {
284 /* Mark affected areas dirty. */
285 for (const auto &t : ts.dirty_tiles) {
286 MarkTileDirtyByTile(t);
287 TileIndexToHeightMap::const_iterator new_height = ts.tile_to_new_height.find(t);
288 if (new_height == ts.tile_to_new_height.end()) continue;
289 MarkTileDirtyByTile(t, 0, new_height->second);
292 /* change the height */
293 for (const auto &it : ts.tile_to_new_height) {
294 TileIndex t = it.first;
295 int height = it.second;
297 SetTileHeight(t, (uint)height);
300 if (c != nullptr) c->terraform_limit -= (uint32_t)ts.tile_to_new_height.size() << 16;
302 return { total_cost, 0, total_cost.Succeeded() ? tile : INVALID_TILE };
307 * Levels a selected (rectangle) area of land
308 * @param flags for this command type
309 * @param tile end tile of area-drag
310 * @param start_tile start tile of area drag
311 * @param diagonal Whether to use the Orthogonal (false) or Diagonal (true) iterator.
312 * @param LevelMode Mode of leveling \c LevelMode.
313 * @return the cost of this operation or an error
315 std::tuple<CommandCost, Money, TileIndex> CmdLevelLand(DoCommandFlag flags, TileIndex tile, TileIndex start_tile, bool diagonal, LevelMode lm)
317 if (start_tile >= Map::Size()) return { CMD_ERROR, 0, INVALID_TILE };
319 /* remember level height */
320 uint oldh = TileHeight(start_tile);
322 /* compute new height */
323 uint h = oldh;
324 switch (lm) {
325 case LM_LEVEL: break;
326 case LM_RAISE: h++; break;
327 case LM_LOWER: h--; break;
328 default: return { CMD_ERROR, 0, INVALID_TILE };
331 /* Check range of destination height */
332 if (h > _settings_game.construction.map_height_limit) return { CommandCost(oldh == 0 ? STR_ERROR_ALREADY_AT_SEA_LEVEL : STR_ERROR_TOO_HIGH), 0, INVALID_TILE };
334 Money money = GetAvailableMoneyForCommand();
335 CommandCost cost(EXPENSES_CONSTRUCTION);
336 CommandCost last_error(lm == LM_LEVEL ? STR_ERROR_ALREADY_LEVELLED : INVALID_STRING_ID);
337 bool had_success = false;
339 const Company *c = Company::GetIfValid(_current_company);
340 int limit = (c == nullptr ? INT32_MAX : GB(c->terraform_limit, 16, 16));
341 if (limit == 0) return { CommandCost(STR_ERROR_TERRAFORM_LIMIT_REACHED), 0, INVALID_TILE };
343 TileIndex error_tile = INVALID_TILE;
344 std::unique_ptr<TileIterator> iter = TileIterator::Create(tile, start_tile, diagonal);
345 for (; *iter != INVALID_TILE; ++(*iter)) {
346 TileIndex t = *iter;
347 uint curh = TileHeight(t);
348 while (curh != h) {
349 CommandCost ret;
350 std::tie(ret, std::ignore, error_tile) = Command<CMD_TERRAFORM_LAND>::Do(flags & ~DC_EXEC, t, SLOPE_N, curh <= h);
351 if (ret.Failed()) {
352 last_error = ret;
354 /* Did we reach the limit? */
355 if (ret.GetErrorMessage() == STR_ERROR_TERRAFORM_LIMIT_REACHED) limit = 0;
356 break;
359 if (flags & DC_EXEC) {
360 money -= ret.GetCost();
361 if (money < 0) {
362 return { cost, ret.GetCost(), error_tile };
364 Command<CMD_TERRAFORM_LAND>::Do(flags, t, SLOPE_N, curh <= h);
365 } else {
366 /* When we're at the terraform limit we better bail (unneeded) testing as well.
367 * This will probably cause the terraforming cost to be underestimated, but only
368 * when it's near the terraforming limit. Even then, the estimation is
369 * completely off due to it basically counting terraforming double, so it being
370 * cut off earlier might even give a better estimate in some cases. */
371 if (--limit <= 0) {
372 had_success = true;
373 break;
377 cost.AddCost(ret);
378 curh += (curh > h) ? -1 : 1;
379 had_success = true;
382 if (limit <= 0) break;
385 CommandCost cc_ret = had_success ? cost : last_error;
386 return { cc_ret, 0, cc_ret.Succeeded() ? tile : error_tile };