MxCh: Difference between revisions
No edit summary |
No edit summary |
||
(4 intermediate revisions by one other user not shown) | |||
Line 4: | Line 4: | ||
== Specification == | == Specification == | ||
=== WAV Data === | |||
{{Incomplete}} | {{Incomplete}} | ||
This data is only known to be accurate for chunks that store WAV data. | |||
The MxCh header is 22 bytes long and specifies the length of the chunk with other data. MxCh chunks must start on an even offset or they will not be skipped by LEGO Island. | The MxCh header is 22 bytes long and specifies the length of the chunk with other data. MxCh chunks must start on an even offset or they will not be skipped by LEGO Island. | ||
Line 17: | Line 21: | ||
| Chunk Size || 4 || 4-byte integer specifying the size of this chunk minus the first 8 bytes | | Chunk Size || 4 || 4-byte integer specifying the size of this chunk minus the first 8 bytes | ||
|- | |- | ||
| | | Flags || 8 || 2-bytes that appear to have set flags about the chunk | ||
|- | |- | ||
| ID || 10 || 4-byte integer that identifies which MxOb this belongs to. | | ID || 10 || 4-byte integer that identifies which MxOb this belongs to. | ||
|- | |- | ||
| | | Milliseconds || 14 || 4-byte integer that appears to be the chunk's offset in milliseconds increasing continuously (1000, 2000, 3000, etc.) | ||
|- | |- | ||
| Chunk Data Size || 18 || 4-byte integer for the size of the data following the header. | | Chunk Data Size || 18 || 4-byte integer for the size of the data following the header. | ||
Line 29: | Line 33: | ||
=== Flags === | === Flags === | ||
The full purpose of the 2-byte "Flags" value above is not entirely known, however the following appear to be accurate: | |||
{| class="wikitable" | |||
|- | |||
! Flag !! Description | |||
|- | |||
| 2 || Chunk is an ending chunk. Chunk size must also be "14" (length of just the header - implies an empty chunk) | |||
|- | |||
| 16 || Chunk is split (see below). | |||
|} | |||
=== Split Chunk === | |||
In addition to the data being split into chunks, the chunks themselves are sometimes split into two. If a chunk is split, both chunks will have the '''Flags''' section set to 16, and they'll also both have the same '''Milliseconds''' value. The "Chunk Size" will be accurate to each chunk's size (data length + 14), but the "Chunk Data Size" of the first chunk appears to be the total size of both chunks' data. The second chunk's "Chunk Data Size" is accurate to its own chunk data size. | |||
The necessity of the split chunks appears to be due to the way Lego Island streams SI files; it appears to only be able to stream a certain amount of bytes (the buffer size) dictated by the SI file's [[MxHd]] (in the case of [[JUKEBOX.SI]], 20000h/131072 bytes; in the case of SNDANIM.SI, 58000h/360558 bytes; otherwise, 10000h/65536 bytes) at a time and the SI file must conform to this limitation. A chunk can have no data that extends over a multiple of the set buffer size. Doing so causes Lego Island to crash as it tries to read beyond the buffer it's allocated for streaming. Therefore, if a chunk is going to extend beyond a buffer size multiple, it must be split at that point and then another chunk must be written directly afterwards with the remainder of the data. This is a big obstacle to inserting audio that is larger than the existing audio, since literally all subsequent chunks of all subsequent songs must be shifted to fit around the buffer size multipliers or Lego Island will crash. This essentially necessitates a reconstruction of most, if not all, of the file. | |||
There seems to be no hard limit for the size of a chunk, other than having to accommodate these boundaries set by the [[MxHd]]. LEGO Island allows a chunk to be split more than once (possibly infinitely), meaning as long as the chunk is split every set buffer size it may be possible for each song to be read as one large chunk rather than one chunk per second. However, LEGO Island appears to expect each chunk to be one second long and seems to time certain events based on the length of a chunk rather than a length of time. |
Latest revision as of 13:49, 20 April 2024
MxCh is the identifier for a Lego Island data chunk. They are seen extensively in SI Files to allow interleaving of several different data types.
MxCh chunks contain partial data of various different data types intended to be joined together continuously to form a complete file (an MxDa section). The chunks can also contain solely header data. A chunk will almost never contain a complete file on its own.
Specification
WAV Data
NOTE: This information is incomplete and requires more research and information.
This data is only known to be accurate for chunks that store WAV data.
The MxCh header is 22 bytes long and specifies the length of the chunk with other data. MxCh chunks must start on an even offset or they will not be skipped by LEGO Island.
Bytes | Offset | Description |
---|---|---|
"MxCh" | 0 | 4-byte chunk identifier |
Chunk Size | 4 | 4-byte integer specifying the size of this chunk minus the first 8 bytes |
Flags | 8 | 2-bytes that appear to have set flags about the chunk |
ID | 10 | 4-byte integer that identifies which MxOb this belongs to. |
Milliseconds | 14 | 4-byte integer that appears to be the chunk's offset in milliseconds increasing continuously (1000, 2000, 3000, etc.) |
Chunk Data Size | 18 | 4-byte integer for the size of the data following the header. |
Data | 22 | Arbitrary data no more than "Chunk Size - 14" in bytes (14 for the 22-byte header minus the first 8 bytes) |
Flags
The full purpose of the 2-byte "Flags" value above is not entirely known, however the following appear to be accurate:
Flag | Description |
---|---|
2 | Chunk is an ending chunk. Chunk size must also be "14" (length of just the header - implies an empty chunk) |
16 | Chunk is split (see below). |
Split Chunk
In addition to the data being split into chunks, the chunks themselves are sometimes split into two. If a chunk is split, both chunks will have the Flags section set to 16, and they'll also both have the same Milliseconds value. The "Chunk Size" will be accurate to each chunk's size (data length + 14), but the "Chunk Data Size" of the first chunk appears to be the total size of both chunks' data. The second chunk's "Chunk Data Size" is accurate to its own chunk data size.
The necessity of the split chunks appears to be due to the way Lego Island streams SI files; it appears to only be able to stream a certain amount of bytes (the buffer size) dictated by the SI file's MxHd (in the case of JUKEBOX.SI, 20000h/131072 bytes; in the case of SNDANIM.SI, 58000h/360558 bytes; otherwise, 10000h/65536 bytes) at a time and the SI file must conform to this limitation. A chunk can have no data that extends over a multiple of the set buffer size. Doing so causes Lego Island to crash as it tries to read beyond the buffer it's allocated for streaming. Therefore, if a chunk is going to extend beyond a buffer size multiple, it must be split at that point and then another chunk must be written directly afterwards with the remainder of the data. This is a big obstacle to inserting audio that is larger than the existing audio, since literally all subsequent chunks of all subsequent songs must be shifted to fit around the buffer size multipliers or Lego Island will crash. This essentially necessitates a reconstruction of most, if not all, of the file.
There seems to be no hard limit for the size of a chunk, other than having to accommodate these boundaries set by the MxHd. LEGO Island allows a chunk to be split more than once (possibly infinitely), meaning as long as the chunk is split every set buffer size it may be possible for each song to be read as one large chunk rather than one chunk per second. However, LEGO Island appears to expect each chunk to be one second long and seems to time certain events based on the length of a chunk rather than a length of time.