From c0f21bfb775f668f1567c77df10bd3b8166a9ac6 Mon Sep 17 00:00:00 2001
From: scrawl <scrawl@baseoftrash.de>
Date: Fri, 11 Sep 2015 21:09:54 +0200
Subject: [PATCH] Add some comments to ESM::Land

(cherry picked from commit 5252dbcf1f4dc311419ca9f7d5f32a765771d1e0)

Conflicts:
	components/esm/loadland.hpp
---
 components/esm/loadland.hpp | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/components/esm/loadland.hpp b/components/esm/loadland.hpp
index ef7e677f5d..8ec4f74ea0 100644
--- a/components/esm/loadland.hpp
+++ b/components/esm/loadland.hpp
@@ -76,17 +76,29 @@ struct Land
 
     struct LandData
     {
+        // Initial reference height for the first vertex, only needed for filling mHeights
         float mHeightOffset;
+        // Height in world space for each vertex
         float mHeights[LAND_NUM_VERTS];
+
+        // 24-bit normals, these aren't always correct though. Edge and corner normals may be garbage.
         VNML mNormals[LAND_NUM_VERTS * 3];
+
+        // 2D array of texture indices. An index can be used to look up an ESM::LandTexture,
+        // but to do so you must subtract 1 from the index first!
+        // An index of 0 indicates the default texture.
         uint16_t mTextures[LAND_NUM_TEXTURES];
 
-        char mColours[3 * LAND_NUM_VERTS];
+        // 24-bit RGB color for each vertex
+        unsigned char mColours[3 * LAND_NUM_VERTS];
+
+        // DataTypes available in this LandData, accessing data that is not available is an undefined operation
         int mDataTypes;
 
         // low-LOD heightmap (used for rendering the global map)
         signed char mWnam[81];
 
+        // ???
         short mUnk1;
         uint8_t mUnk2;