Myst RLST resources - Revision history

TitoDalCanton: /* Type 11 */

2008-10-12T22:14:12Z

‎Type 11

TitoDalCanton: /* Type 10 */

2008-10-12T22:06:21Z

‎Type 10

TitoDalCanton: /* Type 13 */

2008-10-12T21:59:37Z

‎Type 13

TitoDalCanton: several corrections

2008-10-12T21:52:44Z

several corrections

TitoDalCanton: /* Type 10 */

2008-10-12T21:31:55Z

‎Type 10

TitoDalCanton: type 6 parameters

2008-10-12T21:19:42Z

type 6 parameters

TitoDalCanton: /* Type 10 */

2008-10-11T17:10:03Z

‎Type 10

TitoDalCanton: types 10 and 11

2008-10-11T16:46:20Z

types 10 and 11

TitoDalCanton: /* Type 12 */

2008-10-11T16:18:51Z

‎Type 12

TitoDalCanton: /* Type 13 */

2008-10-11T12:10:18Z

‎Type 13

@@ Line 162: / Line 162: @@
 A few cases:
-* Myst island, card 4006
+* Myst island, card 4006: clock tower wheels, ''kind'' = 3
-* Myst island, card 4059
+* Myst island, card 4059: fireplace pattern book, ''kind'' = 3
-* Myst island, card 4098
+* Myst island, card 4098: huge tree control wheel, ''kind'' = 3
-* Selenitic Age, card 1245
+* Selenitic Age, card 1245: arrows for rotating the cameras, ''kind'' = 1
-* Stoneship Age, card 2013
+* Stoneship Age, card 2013: Achenar's toy lever, ''kind'' = 1
-* Stoneship Age, card 2161
+* Stoneship Age, card 2161: generator handle, ''kind'' = 3
-* Stoneship Age, card 2218
+* Stoneship Age, card 2218: telescope navigation, ''kind'' = 1
 ===Type 12===

@@ Line 118: / Line 118: @@
 A few cases:
-* Myst island, card 4500
+* Myst island, card 4500: planetarium sliders, ''kind'' = 2
-* Myst island, card 4530
+* Myst island, card 4530: spaceship sliders, ''kind'' = 2
-* Selenitic Age, card 1147
+* Selenitic Age, card 1147: sliders for accessing the mazerunner, ''kind'' = 2
 ===Type 11===

@@ Line 191: / Line 191: @@
 ===Type 13===
-Type 13 record has just two unknown shorts ''u0'' and ''u1'' after the main block. In addition, ''destination'' seems to be a variable rather than a card ID. Type 13 hotspots are used for example in the match box puzzle and in the icons for raising the ship, in Myst island. They possibly trigger a variable change when rolling over the hotspot.
+Type 13 record has just two unknown shorts ''u0'' and ''u1'' after the main block. In addition, ''destination'' seems to be a variable rather than a card ID.
 ==Case studies==

@@ Line 1: / Line 1: @@
 {{Myst}}
-These contain Myst's hotspot descriptions.
+These contain Myst's hotspot descriptions. Hotspots come in several "types" and depending on their type their action can be simple or very complex.
-The data is a list of records, each record describing one of the hotspots:
+RLST data is a list of records, each record describing one of the hotspots:
 {| class="structure"
 |short||record_count
@@ Line 28: / Line 28: @@
 |variable||additional data
 |}
-*''type'' seems to specify the hotspot action in a wide sense. Every value between 0 and 14 except for 9 has been observed. See below for the meaning.
+*''type'' specifies the hotspot action in a wide sense. Every value between 0 and 14 except for 9 has been observed. See below for the meaning of each type.
 *''flags'' seems to be a bit field. Observed values are 0, 1, 2, 3, 4, 5, 8 and 10 (4 variable bits). The value seems related to when the hotspot actions should be executed. For example, regular clickable hotspots usually have bit 1 set while hotspots that run background movies (e.g. the Channelwood windmill) have ''flags'' = 0. Bit 0 seems to indicate whether hotspot subimages are to be drawn (at least for type 8 hotspots). Hotspots with bit 2 set usually don't have any other bits set (except bit 0, encountered only twice). Bit 3 is suspected to flag Zip Mode hotspots.
-*The following 4 fields define the hotspot rectangle. Note that "weird" rectangles are found, like (-32000, -32000, 32000, 32000).
+*(''left'', ''top'', ''right'', ''bottom'') is the hotspot rectangle in pixels. Note that weird rectangles are found, like (-32000, -32000, 32000, 32000).
 *''destination'' contains a destination card ID for hotspots that change card, or zero.
-*Additional data follows when ''type'' > 4 (complex hotspots), clearly representing lists of actions to perform. We have yet to figure out how to calculate the length of those complex records.
+*Additional data follows for some types, describing actions to perform. See below.
 ==Hotspot types==
@@ Line 39: / Line 39: @@
 ===Type 5===
-Type 5 hotspots have a script attached to them. See the [[Myst_scripts|page about scripts]] for the structure of scripts.
+Type 5 hotspots have a simple script attached to them, which is executed when the hotspot is activated. See the [[Myst_scripts|page about scripts]] for the structure of scripts.
 ===Type 6===
-Type 6 hotspots play a video when activated. The record starts with a full type 5 record. Then comes a zero-terminated string (C string) which defines the path to the video file without extension. After the string is read, input stream position should be padded to the next 2-byte boundary. Finally come 7 shorts:
+Type 6 hotspots have a script like type 5 ones, but they also play a video when activated. The record starts with a full type 5 record. Then comes a zero-terminated string (C string) which defines the path to the video file within the Myst CD-ROM, without extension. Backslashes are used to separate directories, as usual in Windows. After the string, the input stream position should be padded to the next 2-byte boundary. Finally come 7 shorts:
 {| class="structure"
 |short||left
@@ Line 61: / Line 61: @@
 ===Type 7===
-Type 7 record serves as some kind of switch statement, executing one of several action lists (or cases) indexed by the value of a variable:
+Type 7 record serves as some kind of switch statement: it runs a script from a list indexed by the value of a variable:
   (var_index) {num_cases} [record_type <record_data>]
-Each case itself begins with a record type, followed by additional record contents (without common prefix). Only type 5 and 6 records used in a switch statement have been observed.
+Each case itself begins with a record type (always 5 or 6) and contains the data you would find in a hotspot record of that type, excluding the standard block common to all types.
 ===Type 8===
-Type 8 record is like type 7, but additionally it specifies a list of subimages to draw over main WDIB. The particular subimage is chosen depending on the value of variable. This record includes the type 7 record at start.
+Type 8 record is like type 7, but additionally it specifies a list of pictures to draw over main WDIB. The particular picture is chosen depending on the value of variable. This record includes the type 7 record at start.
   <type_7_record> (var_index) {num_subs} [wdib_id <rectangle>]
@@ Line 123: / Line 123: @@
 ===Type 11===
-Type 11 hotspots implement controls that you click and hold or drag, like some of the levers. The record structure includes:
+Type 11 hotspots implement controls that you click and hold or drag, like some of the levers. The record structure is similar to type 10 records, but lacks the last list:
-* a type 8 block
+{| class="structure"
-* 10 unknown shorts
+|variable||type 8 block
-* 3 lists of unsigned shorts (num_values followed by that many values) which look like sound IDs. The first list seems to play at animation start, the second seems to loop in the middle and the third seems to play when the user releases the control.
+|-
 A few cases:

@@ Line 75: / Line 75: @@
 ===Type 10===
-Type 10 hotspots implement slider-like controls. The record structure includes
+Type 10 hotspots implement slider-like controls. The record structure is:
-* a type 8 block
+{| class="structure"
-* 10 unknown shorts
+|variable||type 8 block
-* 4 lists of unsigned shorts (num_values followed by that many values) which look like sound IDs.
+|-
 A few cases:

@@ Line 49: / Line 49: @@
 |-
 |short||loop
 |-
 |short||u1
@@ Line 55: / Line 57: @@
 |-
 |short||u3
 |}
-''left'' and ''top'' specify the movie position. ''loop'' is 0 for movies that are to be played once, 1 for movies that must loop. The unknown fields are often 0 or 1 but other values can be found.
+''left'' and ''top'' specify the movie position. Sometimes they misteriously exceed the correct position by 10000, so one has to take them modulo 10000 to get "safe" values. ''loop'' is 0 for movies that are to be played once, 1 for movies that must loop. The unknown fields are usually 0 or 1 but ''u3'' is found with 125 in one case. ''u0'' seems fixed to 1.
 ===Type 7===

← Older revision		Revision as of 17:10, 11 October 2008
Line 81:		Line 81:

	A few cases:		A few cases:
		+	* Myst island, card 4500
		+	* Myst island, card 4530
	* Selenitic Age, card 1147		* Selenitic Age, card 1147

← Older revision		Revision as of 16:18, 11 October 2008
Line 79:		Line 79:

	===Type 12===		===Type 12===
		+	Type 12 hotspots implement animated controls which use a sequence of separate pictures for the animation. The record structure includes
		+	* a type 8 block
		+	* 10 unknown shorts
		+	* 3 lists of unsigned shorts (num_values followed by that many values) which look like sound IDs.
		+	* number of animation frames
		+	* ID of the picture with the first frame
		+	* two unsigned shorts
		+	* left,top coordinates of the animation
		+
		+	A few cases:
		+	* Channelwood Age, card 3161
		+	* Channelwood Age, card 3246
		+	* Channelwood Age, card 3271
		+	* Mechanical Age, card 6044
		+	* Mechanical Age, card 6156
		+	* Mechanical Age, card 6180

	===Type 13===		===Type 13===