RMT (format pliku)

RMT 1.x module format
--------------------------------


header struct
=============

offset	type	desc
------	----	----
00	DWORD	header string 'RMT4' or 'RMT8'
04	BYTE	track len ($00 means 256)
05	BYTE	song speed
06	BYTE	player freq
07	BYTE	format version number ($01 for player routine 1.x compatible format)
08	WORD	pointer to instrument pointers table
0a	WORD 	pointer to track pointers table (lo)
0c	WORD	pointer to track pointers table (hi)
0e	WORD	pointer to tracks list (SONG)


instrument struct
=================

offset	type	desc
------	----	----
00	BYTE	tlen (pointer to end of table of notes)
01	BYTE 	tgo (pointer to loop of table of notes)
02	BYTE	elen (pointer to end of envelope)
03	BYTE	ego (pointer to loop of envelope)
04	BYTE	tspd (bit 0-5), tmode (bit 6), ttype (bit 7)
05	BYTE	audctl
06	BYTE	vslide
07	BYTE	vmin(bit 4-7)
08	BYTE	delay ($00 for no vibrato & no fshift)
09	BYTE	vibrato (0-3)
0a	BYTE	fshift
0b	BYTE	unused
0c		table of notes
?		envelope

ttype
-----
0 - notes
1 - freqs

tmode
-----
0 - +
1 - +=


TABLE OF NOTES struct
=====================
	BYTE	note or frequence (according to the ttype)


ENVELOPE struct
===============
	BYTE	volume (bit 0-3 left channel) (bits 4-7 right channel
	      (in RMT4 it's the same as bits 0-3))
	BYTE	portamento (bit 0), distortion(bit 1-3),
	      command (bit 4-6), filter (bit 7)
	BYTE	XY

distortion
----------
0 - $0v
2 - $2v
4 - $4v
6 - $Cv 16-bit bass table tone
8 - $8v
A - $Av pure tone
C - $Cv bass 1 table tone
E - $Cv bass 2 table tone

command
-------
0 - play BASE_NOTE + $XY semitones
1 - play frequency $XY
2 - play BASE_NOTE + frequency $XY
3 - set BASE_NOTE += $XY semitones; play BASE_NOTE
4 - set FSHIFT += frequency $XY; play BASE_NOTE
5 - set PORTAMENTO speed $X and step $Y; play BASE_NOTE
6 - set FILTER_SHFRQ += frequency $XY; play BASE_NOTE
7 - set BASE_NOTE = $XY; play BASE_NOTE / if $XY == $80 then VOLUMEONLY mode


TRACK struct
============

BYTE
	bit 0-5	note
	bit 6-7	volume(LO) or pause(1-3 beats) or special

if note is $00-$3c:
BYTE
	bit 0-1	volume(HI)
	bit 2-7 instrument number

if note is $3d:
BYTE
	bit 0-1	volume(HI)	volume only

if note is $3e:
	bit 6-7 pause
	if pause is $01-$03:	pause 1-3 beats
	if pause is $00:	next byte pause 1-255 beats

if note is $3f:
	if bit 6-7 is zero: next byte speed $01-$ff
	if bit 6 is zero, 7 is set up: next byte is track jump pointer
	(go to $00-$ff from the begin of track data)
	if bit 6-7 is set up: END of track

INSTRUMENTS TABLE
=================
	WORD	ptr_instr0
	WORD	ptr_instr1
	WORD	ptr_instr3
	...

ptr_instr = 0 if instrument isn't used 

TRACKS TABLE (LO)
=================
	BYTE	lowbyte_of_ptr_track0
	BYTE	lowbyte_of_ptr_track1
	BYTE	lowbyte_of_ptr_track2
	...

TRACKS TABLE (HI)
=================
	BYTE	highbyte_of_ptr_track0
	BYTE	highbyte_of_ptr_track1
	BYTE	highbyte_of_ptr_track2
	...

ptr_track = 0 if track isn't used

TRACK LIST struct (SONG)
========================
	BYTE	tracknumL1,tracknumL2,tracknumL3,tracknumL4,[tracknumR1,..,tracknumR4]
	BYTE	tracknumL1,tracknumL2,tracknumL3,tracknumL4,[tracknumR1,..,tracknumR4]
	BYTE	tracknumL1,tracknumL2,tracknumL3,tracknumL4,[tracknumR1,..,tracknumR4]
	...

if tracknum is FF, then empty track is used

if tracknumL1 is FE, then gotoline(BYTE)=tracknumL2, goto_pointer(WORD)=(tracknumL3,4)
	Note: gotoline(BYTE) is not used in player (but tracker uses it)

Jeśli moduł nie jest "ogołocony" (opcja "Strip" w RMT), zaraz za głównym blokiem zawierającym moduł następuje drugi blok, w którym zapisane są:

• nazwa utworu (max. 64 znaki),
• nazwy instrumentów (max. 32 znaki każdy).

Każda nazwa kończy się zerem (ATASCII #0).