Difference between revisions of "MUS (AdLib)"
Binarymaster (talk | contribs) m (→Converters) |
Binarymaster (talk | contribs) |
||
Line 40: | Line 40: | ||
<div style="float:right;">([[:Category: Games That Use MUS (AdLib)|Category]])</div> | <div style="float:right;">([[:Category: Games That Use MUS (AdLib)|Category]])</div> | ||
− | { | + | {| class="wikitable" | |
− | | | + | ! Released |
− | + | ! Title | |
− | + | ! Sample | |
− | + | |- | |
− | |||
| 1989-??-?? | | 1989-??-?? | ||
| [[Kung Fu Louie Vs. The Martial Art Posse (DOS)]] | | [[Kung Fu Louie Vs. The Martial Art Posse (DOS)]] | ||
Line 101: | Line 100: | ||
===File Header=== | ===File Header=== | ||
− | { | + | {| class="wikitable" | |
− | | | + | ! Data type |
− | + | ! Name | |
− | + | ! Description | |
− | + | ! Default value | |
− | + | |- | |
− | |||
| <tt>UINT8</tt> || <tt>majorVersion</tt> || Major version || 1 | | <tt>UINT8</tt> || <tt>majorVersion</tt> || Major version || 1 | ||
|- | |- | ||
Line 155: | Line 153: | ||
* Running status mode is supported and used by default. | * Running status mode is supported and used by default. | ||
− | { | + | {| class="wikitable" | |
− | | | + | ! MIDI message |
− | + | ! Description | |
− | + | ! MIDI compatible | |
− | + | |- | |
| 8# xx xx | | 8# xx xx | ||
− | | Note Off | + | | Note Off |
+ | | Yes | ||
|- | |- | ||
| 9# xx xx | | 9# xx xx | ||
− | | Note On | + | | Note On |
+ | | Yes | ||
|- | |- | ||
| A# xx | | A# xx | ||
| Volume Change | | Volume Change | ||
+ | | No | ||
|- | |- | ||
| B# xx xx | | B# xx xx | ||
| Control Change (unused) | | Control Change (unused) | ||
+ | | Yes | ||
|- | |- | ||
| C# xx | | C# xx | ||
− | | Program Change ( | + | | Program Change (uses external [[SND (AdLib)]] bank) |
+ | | Yes | ||
|- | |- | ||
| D# xx | | D# xx | ||
| Channel Aftertouch (unused) | | Channel Aftertouch (unused) | ||
+ | | Yes | ||
|- | |- | ||
| E# xx xx | | E# xx xx | ||
− | | Pitch Bend | + | | Pitch Bend |
+ | | Yes | ||
|- | |- | ||
| F0 7F 00 xx xx F7 | | F0 7F 00 xx xx F7 | ||
| SysEx Speed Control (ends with F7) | | SysEx Speed Control (ends with F7) | ||
+ | | No | ||
|- | |- | ||
| FC | | FC | ||
| Stop | | Stop | ||
+ | | | ||
|} | |} | ||
Line 192: | Line 199: | ||
This special event is similar to MIDI Tempo event, but it specifies the playing tempo multiplier. It consists of an integer and a fractional part, in 1/128. | This special event is similar to MIDI Tempo event, but it specifies the playing tempo multiplier. It consists of an integer and a fractional part, in 1/128. | ||
− | { | + | {| class="wikitable" | |
− | | | + | ! Byte |
− | + | ! Description | |
− | + | |- | |
− | |||
| 0xF0 | | 0xF0 | ||
| Beginning of SysEx | | Beginning of SysEx | ||
Line 221: | Line 227: | ||
* The music can be composed either in melodic or percussive mode. | * The music can be composed either in melodic or percussive mode. | ||
− | { | + | {| class="wikitable" | |
− | | | + | ! Hex channel |
− | + | ! MIDI channel | |
− | + | ! Use in melodic mode | |
− | + | ! Use in percussive mode | |
− | + | |- | |
| 0x00 | | 0x00 | ||
| 1 | | 1 | ||
Line 312: | Line 318: | ||
Player should load this timbre if it isn't found in the sound bank: | Player should load this timbre if it isn't found in the sound bank: | ||
− | { | + | {| class="wikitable" | |
− | | | + | ! OPL base register |
− | + | ! Value | |
− | + | ! Description | |
− | + | |- | |
− | |||
|0x20||0x01||Modulator characteristic (Mult, KSR, EG, VIB and AM flags) | |0x20||0x01||Modulator characteristic (Mult, KSR, EG, VIB and AM flags) | ||
|- | |- |
Revision as of 13:23, 2 February 2016
Ad Lib Music | |||||
Developer: | Ad Lib, Inc. | ||||
Header: | Custom | ||||
Content: | Notational | ||||
Instruments: | External | ||||
Target Output
| |||||
Released: | 1988-06-29 | ||||
First Game: | Kung Fu Louie Vs. The Martial Art Posse (DOS) | ||||
Extensions |
|
This format houses AdLib notes along with a SND file that houses the instrument definitions. In that respect, it's very similar to AdLib's ROL format. Also the notation is very similar to MIDI, but it has some differences. MUS files appear to be compiled ROL files and the SND file is like a compiled BNK file.
Some of the artists who composed music for games that used the MUS format, wrote their music in AdLib Visual Composer, which uses the ROL format.
Contents
Players
- AdLib Play - DOS
- Camoto - Linux, Windows
Converters
MUS to ?
- Camoto - Linux, Windows - CMF, CDFM, DRO, GOT, IMF, MID, RAW (Rdos), S3M, TBSA
- Vinyl to CMF - DOS - CMF
? to MUS
- AdLib Convert - DOS - ROL
- Camoto - Linux, Windows - CMF, CDFM, DRO, DSM, GOT, IMF, KLM, MID, MUS (AdLib), MUS (DMX), RAW (Rdos), S3M, TBSA
Games
Released | Title | Sample |
---|---|---|
1989-??-?? | Kung Fu Louie Vs. The Martial Art Posse (DOS) | |
1989-??-?? | Weird Dreams (DOS) | |
1990-??-?? | DragonStrike (DOS) | |
1990-??-?? | Faces ...tris III (DOS) | |
1990-??-?? | X-Rock (DOS) | |
1992-??-?? | Balda (DOS) | |
1992-??-?? | Color Lines (DOS) | |
1992-??-?? | Regatta (DOS) | |
1992-??-?? | Vetka (DOS) | |
1994-??-?? | Nine (DOS) | |
1995-??-?? | Vinyl Goddess From Mars (DOS) | |
Technical
- MUS files usually begins with one byte of 0x01, 35 bytes of 0x00, and one byte of 0xF0.
- MUS files always ends with 0xFC byte.
- MIDI data notation is very similar to SCI (delta-ticks has same format).
- It is technically possible to convert MUS file to MIDI with few modifications.
- The file header is documented in the source file CONVERT.H of AdLib Play.
File Header
Data type | Name | Description | Default value |
---|---|---|---|
UINT8 | majorVersion | Major version | 1 |
UINT8 | minorVersion | Minor version | 0 |
INT32LE | tuneId | Melody identification | 0 |
CHAR[30] | tuneName | Melody name | |
UINT8 | tickBeat | Ticks per beat (BPM) | 240 |
UINT8 | beatMeasure | Beats per measure | |
INT32LE | totalTick | Length of melody, in ticks | |
INT32LE | dataSize | Length of melody's data part | |
INT32LE | nrCommand | Total number of commands in melody | |
BYTE[8] | filler | Padding (Unused) | 0 |
UINT8 | soundMode | 0 = melodic, 1 = percussive | |
UINT8 | pitchBRange | Pitch bend sensitivity (1-12) | 1 |
UINT16LE | basicTempo | Basic tempo (PPQN) | |
BYTE[8] | filler2 | Padding (Unused) | 0 |
BYTE[dataSize] | data | Melody MIDI sequence data |
- Note: Total number of commands in melody includes Note On, Note Off, Program Change, After Touch, Pitch Bend, Timing Overflow, System Exclusive and Stop.
Timing
The data part of the .MUS file contains MIDI 1.0 commands with timing bytes of 1/tickBeat. tickBeat is the number of divisions per beat. The relation between tickBeat, tempo (beat per minute) & frequency of the timing counter is:
frequency = (tempo / 60) * tickBeat
Timing bytes vary from 0 to 0xFE and precede every command. A timing byte of 0xF8 means timing overflow with a value of 240. An overflow byte is always followed by another overflow byte or timing byte.
MIDI Notation
- The most of status bytes are compatible with MIDI standard.
- Running status mode is supported and used by default.
MIDI message | Description | MIDI compatible |
---|---|---|
8# xx xx | Note Off | Yes |
9# xx xx | Note On | Yes |
A# xx | Volume Change | No |
B# xx xx | Control Change (unused) | Yes |
C# xx | Program Change (uses external SND (AdLib) bank) | Yes |
D# xx | Channel Aftertouch (unused) | Yes |
E# xx xx | Pitch Bend | Yes |
F0 7F 00 xx xx F7 | SysEx Speed Control (ends with F7) | No |
FC | Stop |
SysEx Speed Control
This special event is similar to MIDI Tempo event, but it specifies the playing tempo multiplier. It consists of an integer and a fractional part, in 1/128.
Byte | Description |
---|---|
0xF0 | Beginning of SysEx |
0x7F | Universal Realtime Command |
0x00 | Reserved |
XX | Integer part 1 = 100%, 2 = 200%, etc. |
XX | Fractional part 1/128 0 = 0%, 128 = 100%, etc. |
0xF7 | End of SysEx |
Channel Utilization
- Maximum polyphony is 1 voice per channel, like in tracker formats.
- The music can be composed either in melodic or percussive mode.
Hex channel | MIDI channel | Use in melodic mode | Use in percussive mode |
---|---|---|---|
0x00 | 1 | Normal instrument | Normal instrument |
0x01 | 2 | Normal instrument | Normal instrument |
0x02 | 3 | Normal instrument | Normal instrument |
0x03 | 4 | Normal instrument | Normal instrument |
0x04 | 5 | Normal instrument | Normal instrument |
0x05 | 6 | Normal instrument | Normal instrument |
0x06 | 7 | Normal instrument | Bass drum |
0x07 | 8 | Normal instrument | Snare drum |
0x08 | 9 | Normal instrument | Tom tom |
0x09 | 10 | Unused | Top cymbal |
0x0A | 11 | Unused | Hi-hat cymbal |
0x0B | 12 | Unused | Unused |
0x0C | 13 | Unused | Unused |
0x0D | 14 | Unused | Unused |
0x0E | 15 | Unused | Unused |
0x0F | 16 | Unused | Unused |
Default Timbre
Player should load this timbre if it isn't found in the sound bank:
OPL base register | Value | Description |
---|---|---|
0x20 | 0x01 | Modulator characteristic (Mult, KSR, EG, VIB and AM flags) |
0x23 | 0x11 | Carrier characteristic (Mult, KSR, EG, VIB and AM flags) |
0x40 | 0x4F | Modulator key scaling/output level |
0x43 | 0x10 | Carrier key scaling/output level |
0x60 | 0xF1 | Modulator attack/decay level |
0x63 | 0xF2 | Carrier attack/decay level |
0x80 | 0x53 | Modulator sustain/release level |
0x83 | 0x74 | Carrier sustain/release level |
0xE0 | 0x00 | Modulator wave select |
0xE3 | 0x00 | Carrier wave select |
0xC0 | 0x06 | Feedback/connection |
Links
- shikadi.net/moddingwiki/AdLib_MIDI_Format - Modding Wiki.