# HG changeset patch
# User alberth <alberth@openttd.org>
# Date 2010-02-06 09:30:30
# Node ID 24b07b6f49f429e3728334ab45073aa04f20ab92
# Parent  473d6686f288dc6168f49f323ff8336b81fcbd72

(svn r19027) -Doc: Document RemapCoords functions.

diff --git a/src/landscape.h b/src/landscape.h
--- a/src/landscape.h
+++ b/src/landscape.h
@@ -41,6 +41,14 @@ void GetSlopeZOnEdge(Slope tileh, DiagDi
 int GetSlopeZInCorner(Slope tileh, Corner corner);
 Slope GetFoundationSlope(TileIndex tile, uint *z);
 
+/**
+ * Map 3D world or tile coordinate to equivalent 2D coordinate as used in the viewports and smallmap.
+ * @param x X world or tile coordinate (runs in SW direction in the 2D view).
+ * @param y Y world or tile coordinate (runs in SE direction in the 2D view).
+ * @param z Z world or tile coordinate (runs in N direction in the 2D view).
+ * @return Equivalent coordinate in the 2D view.
+ * @see RemapCoords2
+ */
 static inline Point RemapCoords(int x, int y, int z)
 {
 	Point pt;
@@ -49,6 +57,14 @@ static inline Point RemapCoords(int x, i
 	return pt;
 }
 
+/**
+ * Map 3D world or tile coordinate to equivalent 2D coordinate as used in the viewports and smallmap.
+ * Same as #RemapCoords, except the Z coordinate is read from the map.
+ * @param x X world or tile coordinate (runs in SW direction in the 2D view).
+ * @param y Y world or tile coordinate (runs in SE direction in the 2D view).
+ * @return Equivalent coordinate in the 2D view.
+ * @see RemapCoords
+ */
 static inline Point RemapCoords2(int x, int y)
 {
 	return RemapCoords(x, y, GetSlopeZ(x, y));