SY24: Created page

2025-02-13T11:22:14Z

Created page

New page

[[Category:File formats]]
== File Format ==
'''B'''inary '''Me'''lody files store commands for the audio engine to play chords/melodies. The format is constructed of instructions (OpCodes) similar to [[BMS (File Format)|BMS]] files. ''Super Mario Galaxy'' & ''Super Mario Galaxy 2'' each only have one '''BME''' file, stored in <code>AudioRes/Info/JaiMe.arc/bme/defaultme.bme</code>.

== Header ==
The header is constructed like this:
{| class="wikitable"
|-
! Offset
! Type
! Description
|-
| 0x0
| UInt32 (0x4)
| Amount N of entries (0x28 in SMG, 0x29 in SMG2)
|-
| 0x4 + N * 0x4
| UInt32 (0x4)
| Offset to BME data
|}

== Data ==
{{WIP}}
Each instruction (OpCode) stands for its own function in the engine:
{| class="wikitable"
|-
! OpCode
! Function (SMG/SMG2)
! Usage
! Example
! Description
|-
| 00
|
| {OpCode[1]} {Bank[1]} OpCode: one byte, 00. Bank: one byte with range 0x00 through 0xFF. This byte represents a WSYS ID.
| 00 0A 00: OpCode 0A: WSYS ID 10
| Defines the WSYS/IBNK whose sounds are to be used in a Track.
|-
| 01
|
| {OpCode[1]} {Program[1]} OpCode: one byte, 01. Program: one byte with range 0x00 through 0xFF. This byte represents a LIST entry in the IBNK belonging to the defined WSYS ID.
| 01 04 01: OpCode 04: IBNK LIST entry 4
| Defines the Keyboard which holds more specific sounds from an IBNK.
|-
| 02
|
| {OpCode[1]} {Bank[1]} {Program[1]} OpCode: one byte, 02. Bank: one byte with range 0x00 through 0xFF. This byte represents a WSYS ID. Program: one byte ranging from 0x00 through 0xFF. This byte represents a LIST entry in the IBNK belonging to the defined WSYS ID.
| 02 00 0D 02: OpCode 00: WSYS ID 0 0D: IBNK LIST entry 13
| Defines the Instrument to be used in a Track.
|-
| 10
|
| {OpCode[1]} {TrackNumber[1]} {Pointer[3]} OpCode: one byte, 0x10. TrackNumber: one byte with unknown range. Pointer: three bytes with range 0x000000 through 0xFFFFFF. Defines an offset in the file.
| 10 00 00 01 F5 10: OpCode 00: Track 0 00 01 F5: Offset
| Creates a Track which plays a Melody individually.
|-
| 20
|
| {OpCode[1]} {Unknown} OpCode: one byte, 0x20. Unknown
|
| Starts a Track.
|-
| 24
|
| {OpCode[1]} OpCode: one byte, 0x24.
|
| Stops execution of a Track.
|-
| 40
|
| {OpCode[1]} {Pointer[3]} OpCode: one byte, 0x40. Pointer: three bytes with range 0x000000 through 0xFFFFFF. Defines an offset in the file.
| 40 00 0B CF 40: OpCode 00 0B CF: Offset
| Redirects execution to the defined offset. Execution can return with 71.
|-
| 70
|
|
|
|
|-
| 71
|
| {OpCode[1]} OpCode: one byte, 0x71.
|
| Returns redirected execution (like from 40) to the initial call.
|}

BME (File Format) - Revision history

SY24: Created page