(svn r15109) -Add [NoAI]: add AITile::LevelTiles (Yexo)

1 files changed, 18 insertions, 0 deletions

diff --git a/src/ai/api/ai_tile.hpp b/src/ai/api/ai_tile.hpp
index 151771cae..9a4df1677 100644
--- a/src/ai/api/ai_tile.hpp
+++ b/src/ai/api/ai_tile.hpp
@@ -313,6 +313,24 @@ public:
 	static bool LowerTile(TileIndex tile, int32 slope);
 
 	/**
+	 * Level all tiles in the rectangle between start_tile and end_tile so they
+	 *  are at the same height. All tiles will be raised or lowered until
+	 *  they are at height AITile::GetHeight(start_tile).
+	 * @param start_tile One corner of the rectangle to level.
+	 * @param end_tile The opposite corner of the rectangle.
+	 * @pre start_tile < AIMap::GetMapSize().
+	 * @pre end_tile < AIMap::GetMapSize().
+	 * @exception AIError::ERR_AREA_NOT_CLEAR
+	 * @exception AIError::ERR_TOO_CLOSE_TO_EDGE
+	 * @return True if and only if the area was completely leveled.
+	 * @note Even if leveling some part fails, some other part may have been
+	 *  succesfully leveled already.
+	 * @note This function may return true in AITestMode, although it fails in
+	 *  AIExecMode.
+	 */
+	static bool LevelTiles(TileIndex start_tile, TileIndex end_tile);
+
+	/**
 	 * Destroy everything on the given tile.
 	 * @param tile The tile to demolish.
 	 * @pre AIMap::IsValidTile(tile).