From dcbf77cc928deb5d7bb56efc8bec3ba5e0925b59 Mon Sep 17 00:00:00 2001
From: Max Horn <max@quendi.de>
Date: Thu, 29 Dec 2011 01:02:42 +0100
Subject: [PATCH] DREAMWEB: Document some locations

---
 engines/dreamweb/stubs.cpp | 49 ++++++++++++++++++++++++++++++++++++--
 1 file changed, 47 insertions(+), 2 deletions(-)

diff --git a/engines/dreamweb/stubs.cpp b/engines/dreamweb/stubs.cpp
index d93add6b428..5f8ea53ada3 100644
--- a/engines/dreamweb/stubs.cpp
+++ b/engines/dreamweb/stubs.cpp
@@ -30,76 +30,91 @@ namespace DreamWeb {
 uint8 g_keyBuffer[16];
 
 const Room g_roomData[] = {
+	// location 0
 	{ "DREAMWEB.R00", // Ryan's apartment
 	  5,255,33,10,
 	  255,255,255,0,
 	  1,6,2,255,3,255,255,255,255,255,0 },
 
+	// location 1
 	{ "DREAMWEB.R01",
 	  1,255,44,10,
 	  255,255,255,0,
 	  7,2,255,255,255,255,6,255,255,255,1 },
 
+	// location 2: Louis' (?)
 	{ "DREAMWEB.R02",
 	  2,255,33,0,
 	  255,255,255,0,
 	  1,0,255,255,1,255,3,255,255,255,2 },
 
+	// location 3
 	{ "DREAMWEB.R03",
 	  5,255,33,10,
 	  255,255,255,0,
 	  2,2,0,2,4,255,0,255,255,255,3 },
 
+	// location 4
 	{ "DREAMWEB.R04",
 	  23,255,11,30,
 	  255,255,255,0,
 	  1,4,0,5,255,255,3,255,255,255,4 },
 
+	// location 5: In hotel, lift noise audible (?)
 	{ "DREAMWEB.R05",
 	  5,255,22,30, // if demo: 22,255,22,30,
 	  255,255,255,0,
 	  1,2,0,4,255,255,3,255,255,255,5 },
 
+	// location 6: sarters (?)
 	{ "DREAMWEB.R06",
 	  5,255,11,30,
 	  255,255,255,0,
 	  1,0,0,1,2,255,0,255,255,255,6 },
 
+	// location 7
 	{ "DREAMWEB.R07",
 	  255,255,0,20,
 	  255,255,255,0,
 	  2,2,255,255,255,255,0,255,255,255,7 },
 
+	// location 8: TV studio (?)
 	{ "DREAMWEB.R08",
 	  8,255,0,10,
 	  255,255,255,0,
 	  1,2,255,255,255,255,0,11,40,0,8 },
 
+	// location 9
 	{ "DREAMWEB.R09",
 	  9,255,22,10,
 	  255,255,255,0,
 	  4,6,255,255,255,255,0,255,255,255,9 },
 
+	// location 10
 	{ "DREAMWEB.R10",
 	  10,255,33,30,
 	  255,255,255,0,
 	  2,0,255,255,2,2,4,22,30,255,10 }, // 22,30,0 switches
 	                                    // off path 0 in skip
+	// location 11
 	{ "DREAMWEB.R11",
 	  11,255,11,20,
 	  255,255,255,0,
 	  0,4,255,255,255,255,255,255,255,255,11 },
 
+	// location 12
 	{ "DREAMWEB.R12",
 	  12,255,22,20,
 	  255,255,255,0,
 	  1,4,255,255,255,255,255,255,255,255,12 },
 
+	// location 13: boathouse (?)
 	{ "DREAMWEB.R13",
 	  12,255,22,20,
 	  255,255,255,0,
 	  1,4,255,255,255,255,255,255,255,255,13 },
 
+	// location 14
 	{ "DREAMWEB.R14",
 	  14,255,44,20,
 	  255,255,255,0,
@@ -110,166 +125,196 @@ const Room g_roomData[] = {
 	{ "", 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 },
 	{ "", 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 },
 
+	// location 19
 	{ "DREAMWEB.R19",
 	  19,255,0,0,
 	  255,255,255,0,
 	  0,4,255,255,255,255,255,255,255,255,19 },
 
+	// location 20: Sart room (?)
 	{ "DREAMWEB.R20",
 	  22,255,0,20,
 	  255,255,255,0,
 	  1,4,2,15,255,255,255,255,255,255,20 },
 
+	// location 21: lift noise audible (?)
 	{ "DREAMWEB.R21",
 	  5,255,11,10, // if demo: 22,255,11,10,
 	  255,255,255,0,
 	  1,4,2,15,1,255,255,255,255,255,21 },
 
+	// location 22: pool room (?)
 	{ "DREAMWEB.R22",
 	  22,255,22,10,
 	  255,255,255,0,
 	  0,4,255,255,1,255,255,255,255,255,22 },
 
+	// location 23
 	{ "DREAMWEB.R23",
 	  23,255,22,30,
 	  255,255,255,0,
 	  1,4,2,15,3,255,255,255,255,255,23 },
 
+	// location 24: only room in which initialInv() is active, i.e. we get initial inventory here
 	{ "DREAMWEB.R24",
 	  5,255,44,0,
 	  255,255,255,0,
 	  1,6,2,15,255,255,255,255,255,255,24 },
 
+	// location 25: helicopter (?)
 	{ "DREAMWEB.R25",
 	  22,255,11,40,
 	  255,255,255,0,
 	  1,0,255,255,255,255,255,255,255,255,25 },
 
+	// location 26: reached via trap door (?)
 	{ "DREAMWEB.R26",
 	  9,255,22,20,
 	  255,255,255,0,
 	  4,2,255,255,255,255,255,255,255,255,26 },
 
+	// location 27: rock room (?)
 	{ "DREAMWEB.R27",
 	  22,255,11,20,
 	  255,255,255,0,
 	  0,6,255,255,255,255,255,255,255,255,27 },
 
+	// location 28: related to TV studiou (?), see resetLocation()
 	{ "DREAMWEB.R28",
 	  5,255,11,30,
 	  255,255,255,0,
 	  0,0,255,255,2,255,255,255,255,255,28 },
 
+	// location 29: aide (?)
 	{ "DREAMWEB.R29",
 	  22,255,11,10,
 	  255,255,255,0,
 	  0,2,255,255,255,255,255,255,255,255,29 },
 
 
-
+	// location 30
 	{ "DREAMWEB.R05", // Duplicate of hotel lobby, but emerging from the lift.
 	  5,255,22,10,    // if demo: 22,255,22,10
 	  255,255,255,0,
 	  1,4,1,15,255,255,255,255,255,255,5 },
 
+	// location 31
 	{ "DREAMWEB.R04",  // Duplicate of pool hall lobby,
 	  23,255,22,20,    // but emerging from the lift.
 	  255,255,255,0,
 	  1,4,2,15,255,255,255,255,255,255,4 },
 
+	// location 32
 	{ "DREAMWEB.R10",  // entering alley via skip
 	  10,255,22,30,
 	  255,255,255,0,
 	  3,6,255,255,255,255,255,255,255,255,10 },
 
+	// location 33
 	{ "DREAMWEB.R12",  // on the beach, getting up.
 	  12,255,22,20,
 	  255,255,255,0,
 	  0,2,255,255,255,255,255,255,255,255,12 },
 
+	// location 34
 	{ "DREAMWEB.R03",  // Duplicate of Eden's lobby
 	  5,255,44,0,      // but emerging from the lift
 	  255,255,255,0,
 	  1,6,2,255,4,255,255,255,255,255,3 },
 
+	// location 35: Location when starting the game, after dream (?)
 	{ "DREAMWEB.R24",  // Duplicate of Eden's flat
 	  5,255,22,0,      // but starting on the bed
 	  255,255,255,0,
 	  3,6,0,255,255,255,255,33,0,3,24 }, //  33,0,3 turns off path for lift
 
+	// location 36
 	{ "DREAMWEB.R22",  // Duplicate
 	  22,255,22,20,    // of hotel but in pool room
 	  255,255,255,0,
 	  1,4,255,255,255,255,255,255,255,255,22 },
 
+	// location 37
 	{ "DREAMWEB.R22",  // Duplicate
 	  22,255,22,20,    // of hotel but in pool room
 	  255,255,255,0,   // coming out of bedroom
 	  0,2,255,255,255,255,255,255,255,255,22 },
 
+	// location 38
 	{ "DREAMWEB.R11",  // Duplicate
 	  11,255,22,30,    // of carpark but getting
 	  255,255,255,0,   // up off the floor
 	  0,0,255,255,255,255,255,255,255,255,11 },
 
+	// location 39
 	{ "DREAMWEB.R28",
 	  5,255,11,20,
 	  255,255,255,0,
 	  0,6,255,255,2,255,255,255,255,255,28 },
 
+	// location 40
 	{ "DREAMWEB.R21",
 	  5,255,11,10, // if demo: 22,255,11,10
 	  255,255,255,0,
 	  1,4,2,15,1,255,255,255,255,255,21 },
 
+	// location 41
 	{ "DREAMWEB.R26",
 	  9,255,0,40,
 	  255,255,255,0,
 	  0,0,255,255,255,255,255,255,255,255,26 },
 
+	// location 42
 	{ "DREAMWEB.R19",
 	  19,255,0,0,
 	  255,255,255,0,
 	  2,2,255,255,255,255,255,255,255,255,19 },
 
+	// location 43
 	{ "DREAMWEB.R08",  // leaving tvstudio into street
 	  8,255,11,40,
 	  255,255,255,0,
 	  0,4,255,255,255,255,255,255,255,255,8 },
 
+	// location 44
 	{ "DREAMWEB.R01",
 	  1,255,44,10,
 	  255,255,255,0,
 	  3,6,255,255,255,255,255,255,255,255,1 },
 
 
+	// location 45
 	{ "DREAMWEB.R45",  // Dream room
 	  35,255,22,30,
 	  255,255,255,0,
 	  0,6,255,255,255,255,255,255,255,255,45 },
 
+	// location 46
 	{ "DREAMWEB.R46",  // Dream room
 	  35,255,22,40,
 	  255,255,255,0,
 	  0,4,255,255,255,255,255,255,255,255,46 },
 
+	// location 47
 	{ "DREAMWEB.R47",  // Dream room
 	  35,255,0,0,
 	  255,255,255,0,
 	  0,0,255,255,255,255,255,255,255,255,47 },
 
+	// location 48
 	{ "DREAMWEB.R45",  // Dream room
 	  35,255,22,30,
 	  255,255,255,0,
 	  4,0,255,255,255,255,255,255,255,255,45 },
 
+	// location 49
 	{ "DREAMWEB.R46",  // Dream room
 	  35,255,22,50,
 	  255,255,255,0,
 	  0,4,255,255,255,255,255,255,255,255,46 },
 
 
-
+	// location 50
 	{ "DREAMWEB.R50",  //  Intro sequence one
 	  35,255,22,30,
 	  255,255,255,0,