From 000516ebf99e7ae8a1ce4b654a64dd59d4f10a57 Mon Sep 17 00:00:00 2001
From: DakkJaniels <6080734+DakkJaniels@users.noreply.github.com>
Date: Mon, 24 Apr 2023 12:15:40 -0400
Subject: [PATCH] Update gendung.h (#6038)

---
 Source/levels/gendung.h | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/Source/levels/gendung.h b/Source/levels/gendung.h
index 6e4dcea02..19f0a4330 100644
--- a/Source/levels/gendung.h
+++ b/Source/levels/gendung.h
@@ -193,17 +193,19 @@ extern DVL_API_FOR_TEST uint16_t dPiece[MAXDUNX][MAXDUNY];
 extern MICROS DPieceMicros[MAXTILES];
 /** Specifies the transparency at each coordinate of the map. */
 extern DVL_API_FOR_TEST int8_t dTransVal[MAXDUNX][MAXDUNY];
+/** Current realtime lighting. Per tile. */
 extern uint8_t dLight[MAXDUNX][MAXDUNY];
+/** Precalculated static lights. dLight uses this as a base before applying lights. Per tile. */
 extern uint8_t dPreLight[MAXDUNX][MAXDUNY];
 /** Holds various information about dungeon tiles, @see DungeonFlag */
 extern DungeonFlag dFlags[MAXDUNX][MAXDUNY];
-
-/** Contains the player numbers (players array indices) of the map. */
+/** Contains the player numbers (players array indices) of the map. negative id indicates player moving. */
 extern int8_t dPlayer[MAXDUNX][MAXDUNY];
 /**
  * Contains the NPC numbers of the map. The NPC number represents a
  * towner number (towners array index) in Tristram and a monster number
  * (monsters array index) in the dungeon.
+ * Negative id indicates monsters moving.
  */
 extern int16_t dMonster[MAXDUNX][MAXDUNY];
 /**
@@ -213,7 +215,10 @@ extern int16_t dMonster[MAXDUNX][MAXDUNY];
  * dDead[x][y] >> 0x5 - direction
  */
 extern DVL_API_FOR_TEST int8_t dCorpse[MAXDUNX][MAXDUNY];
-/** Contains the object numbers (objects array indices) of the map. */
+/**
+ * Contains the object numbers (objects array indices) of the map.
+ * Large objects have negative id for their extended area.
+ */
 extern DVL_API_FOR_TEST int8_t dObject[MAXDUNX][MAXDUNY];
 /**
  * Contains the arch frame numbers of the map from the special tileset