Extension: .DMF Version: 8, (4 in the 2nd part) Created by: Delusion Tracker: X-Tracker Players: Cubic, ... Description by: Delusion Taken from: DDMF Description v0.25, FileFormats List v1.50 Note: Digital music format 1st part in german (sorry :) DELUSION DIGITAL MUSIC FORMAT - rev 0.25 (10/6/94) Beschreibung des DELUSION DIGITAL MUSIC FORMAT Fileversion 8. Die Dateikennung ist ".DMF". Alle frheren DDMF Versionen sind Betaformate und sollten nicht weiter benutzt werden, Xtracker 1.0 ldt alle Vorgnger Versionen korrekt und speichert sie als Version 8 ab. Das DDMF Format ist in folgenden Blcke unterteilt: [DDMF] Format Kennzeichnung [INFO] reserviert [CMSG] Text Mitteilungen [SEQU] Sequencer, Abspielreihenfolge der Pattern [PATT] Patterndaten [INST] reserviert [SMPI] Defintionen der Samples. [SMPD] Daten der Samples. Mu hinter dem SMPI Block gespeichert sein. [ENDE] Endmarkierung des DDMFs Ŀ DDMF Header ͵ Fileoffset Bezeichner Datentyp Ĵ 0h ID 4 Chars Ĵ Filekennung ist "DDMF" Ĵ 4h FILE VERSION 1 Byte Ĵ DDMF Fileversion, diese Beschreibung gilt nur fr Version 8. Ĵ 5h TRACKER NAME 8 Chars Ĵ Name des benutzten Trackers. Ĵ 0dh SONG NAME 30 Chars Ĵ Name des Musikstckes, nicht benutzte Zeichen sollten auf 0 stehen. Ĵ 2bh COMPOSER NAME 20 Chars Ĵ Name des Komponisten, nicht benutzte Zeichen sollten auf 0 stehen. Ĵ 3fh DATE 3 Bytes Ĵ Erstellungsdatum: je ein Byte Tag, Monat, Jahr+1900 Ŀ CMSG Block: Mitteilungen ͵ Blockoffs. Bezeichner Datentyp Ĵ 0h BLOCKID 1 Dword Ĵ Blockkennung "CMSG" Ĵ 4h BLOCKLENGTH 1 Dword Ĵ Lnge in Bytes bis zum nchsten Block. Ĵ 8h FILLER 1 Byte Ĵ reserviert Ĵ 9h MESSAGE Chars Ĵ ASCII-Text mit einer festen Zeilenlnge von 40 Zeichen. Lnge von MESSAGE = (BLOCKLENGTH - 1) Bytes. Ŀ SEQU Block: Sequencer, Abspielreihenfolge der Pattern ͵ Blockoffs. Bezeichner Datentyp Ĵ 0h BLOCKID 1 Dword Ĵ Blockkennung "SEQU" Ĵ 4h BLOCKLENGTH 1 Dword Ĵ Lnge in Bytes bis zum nchsten Block. Ĵ 8h SEQUENCER LOOP START 1 Word Ĵ Sequencer Schleifenanfang Ĵ 0ah SEQUENCER LOOP END 1 Word Ĵ Sequencer Schleifenende Ĵ 0ch SEQUENCER Words Ĵ Liste der Patternnummern die nacheinander abgespielt werden. Lnge von SEQUENCER = (BLOCKLENGTH - 4) Bytes Ŀ PATT Block: Patterndaten ͵ Blockoffs. Bezeichner Datentyp Ĵ 0h BLOCKID 1 Dword Ĵ Blockkennung "PATT" Ĵ 4h BLOCKLENGTH 1 Dword Ĵ Lnge in Bytes bis zum nchsten Block. Ĵ 8h PATTERN ENTRIES (1-1024) 1 Word Ĵ Anzahl der gespeicherten Pattern. Ĵ 0ah MAX TRACKS (1-32) 1 Byte Ĵ Anzahl der der maximal benutzten Tracks. Ĵ 0bh PATTERNS Words Ĵ Folgende Struktur PATTERN ENTRIES mal wiederholt Ĵ Patternoff. Bezeichner Datentyp Ĵ 0h TRACK ENTRIES (1-1024) 1 Byte Ĵ Anzahl der gespeicherten Tracks in diesem Pattern. Ĵ 1h BEAT 1 Byte Ĵ BEAT = xxxxyyyy reserviert Notenzeilen pro Beatschlag Ĵ 2h TICK ENTRIES 1 Word Ĵ Anzahl der gespeicherten Notenzeilen in diesem Pattern Ĵ 4h PATTERNLENGTH 1 Dword Ĵ Lnge der Patterndata, Bytes bis zum nchsten Pattern. Ĵ 6h PATTERDATA Bytes Ĵ Der Patterndatenstrom ist folgendermassen codiert: Folgende Struktur TICK ENTRIES mal wiederholt Ĵ ( * TRACK ENTRIES) Ĵ GLOBAL TRACK INFO 1 Byte (COUNTER) 1 Byte (DATA) 1 Byte INFO = xxxxxxxx Global Track Ereigniss reserviert Pack Falls Pack=1 ist das nchst gelesene Byte COUNTER. COUNTER ist ein Zhler der jede Notenzeile herunter gezhlt wird, es sind keine GLOBAL Track Informationen gespeichert bis COUNTER wieder auf 0 steht. COUNTER wird bei einem Patternwechsel auf 0 gesetzt. Ist Pack=0 so ist kein COUNTER gespeichert und fr COUNTER gilt der Wert 0, d.h. im nchsten Tick ist wieder ein GLOBAL TRACK gespeichert. Falls Global Track Ereigniss > 0 ist folgt ein weiters Byte DATA, das die Effektdaten fr den zugehrige Ereigniss liefert. Ist das Global Track Ereigniss = 0 ist DATA nicht gespeichert. Definition der Global Track Ereignisse siehe DMF_EFF.TXT Ĵ TRACK INFO 1 Byte (COUNTER) 1 Byte (INSTRUMENT) 1 Byte (NOTE) 1 Byte (VOLUME) 1 Byte (INSTRUMENT EFFECT) 2 Bytes (NOTE EFFECT) 2 Bytes (VOLUME EFFECT) 2 Bytes INFO INFO = xxxxxxxx x reserviert 1=VOLUME EFFECT gespeichert / 0=nicht gespeichert 1=NOTE EFFECT gespeichert / 0 ... 1=INSTRUMENT EFFECT gespeichert / 0 ... 1=VOLUME gespeichert / 0 ... 1=NOTE gespeichert / 0 ... 1=INSTRUMENT gespeichert / 0 ... 1=COUNTER gespeichert / 0 ... Folgende Werte sind also nur gespeichert wenn die entsprechenden Bits in INFO gesetzt sind, wenn nicht bedeuted das keine nderung des entsprechenden Parameters. COUNTER COUNTER ist ein Zhler der jeden Tick herunter gezhlt wird, es sind keine Informationen fr diesen Track gespeichert bis COUNTER wieder auf 0 steht. COUNTER wird bei einem Patternwechsel auf 0 gesetzt. Ist COUNTER nicht gespeichert so gilt fr COUNTER der Wert 0, d.h. fr die nchsten Notenzeilen sind wieder Daten fr diesen Track gespeichert. INSTRUMENT Die Samplenummer des Samples das Angeschlagen wird. NOTE 0 = Keine nderung 1-108 = Note in Halbtonschritten, C0=1 bis H8=108. Dies entspricht einer Midi Note mit 1 addiert. 109-128 = Nicht definiert 129-236 = Die Note wird in den Notenpuffer gespeichert und nicht gespielt, eine spielende Note wird nicht verndert. Das MSBit wird gelscht die Noten entsprechen dann den Noten 1-108. Der Notenpuffer wird als 2 Parameter fr Noten-Effekte verwendet z.B. fr Note Portamentos, wo die Effekt- daten schon fr den Steigungsgrad vergeben sind. 237-254 = Nicht definiert 255 = Note Off, setzt die Notenfrequenz auf 0 hz VOLUME 0 = Nicht definiert 1-255 = Neue Lautstrke des Tracks, lineare Skalierung INSTRUMENT EFFECT 1.Byte: Instrument Effekt Nr. 2.Byte: Instrument Effekt Daten NOTE EFFECT 1.Byte: Noten Effekt Nr. 2.Byte: Noten Effekt Daten VOLUME EFFECT 1.Byte: Volume Effekt Nr. 2.Byte: Volume Effekt Daten Definition der Volume,Noten,Instrument Effekte in DMF_EFF.TXT Ĵ Ĵ Ŀ SMPI Block: Sample Defintionen ͵ Blockoffs. Bezeichner Datentyp Ĵ 0h BLOCKID 1 Dword Ĵ Blockkennung "SMPI" Ĵ 4h BLOCKLENGTH 1 Dword Ĵ Lnge in Bytes bis zum nchsten Block. Ĵ 8h SAMPLE ENTRIES (1-255) 1 Word Ĵ Anzahl der gespeicherten Samples, maximal 255. Ĵ 6h SAMPLES Bytes Ĵ Folgende Struktur SAMPLE ENTRIES mal wiederholt Ĵ Sampleoff. Bezeichner Datentyp Ĵ 0h Y = NAME LENGTH (0-30) 1 Byte Ĵ Lnge des Samplenamens, die Lnge des ist auf maximal 30 Zeichen beschrnkt. Ĵ 1h SAMPLE NAME X Chars Ĵ Name des Samples in ASCII Zeichen. Lnge des Namens ist NAME LENGTH Zeichen. Ĵ Y + 1h SAMPLE LENGTH 1 Dword Ĵ Lnge des Samples in Bytes. Ĵ Y + 5h SAMPLE LOOP START 1 Dword Ĵ Sample Schleifen Start Position. Ĵ Y + 9h SAMPLE LOOP END 1 Dword Ĵ Sample Schleifen End Position. Ĵ Y + 0dh C3 FREQUENCY 1 Word Ĵ Frequenz, in Hz, mit der das Sample bei der Note C-3 gespielt wird. Das Sample kann dadurch beliebig gestimmt werden. Gltiger Bereich fr C3 FREQUENCY ist 1000-45000 Hz. Ĵ Y + 0fh VOLUME 1 Byte Ĵ Samplelautstrke. VOLUME = 0 kein Auswirkung 1-255 Lautstrke, linearer Skalierung Ĵ Y + 10h TYPE 1 Byte Ĵ TYPE = xxxxxxx0 = kein Schleife xxxxxxx1 = Sample wird mit einer Schleife gespielt, das Sample spielt vom Start bis SAMPLE LOOP END und wiederholt danach den Bereich von SAMPLE LOOP START bis SAMPLE LOOP END. xxxxxx0x = 8BIT Sample xxxxxx1x = 16BIT Sample xxxxXXxx = Kompremierungsverfahren xxxx00xx = Unkompremiert vorzeichenbehaftet xxxx01xx = Kompremierungs Typ0 xxxx10xx = (Kompremierungs Typ1) xxxx11xx = (Kompremierungs Typ2) xXXXxxxx = nicht Definiert 0xxxxxxx = --> Die Sampledaten sind im SMPD Block des DMFs gespeichert. 1xxxxxxx = --> Die Sampledaten sind in einer Biblothek gespeichert. Ĵ Y + 11h LIBRARY NAME 8 Byte Ĵ Biblotheks Kennzeichnung unter der das Sample zu finden ist. Ĵ Y + 19h FILLER 1 Word Ĵ reserviert Ĵ Y + 1bh ID CRC32 1 DWord Ĵ Prfsumme der Sampledaten. Ĵ Ŀ SMPD Block: Sample Daten ͵ Blockoffs. Bezeichner Datentyp Ĵ 0h BLOCKID 1 Dword Ĵ Blockkennung "SMPD" Ĵ 4h BLOCKLENGTH 1 Dword Ĵ Lnge in Bytes bis zum nchsten Block. Ĵ 8h SAMPLE DATA Bytes Ĵ Folgende Struktur SAMPLE ENTRIES (SMPI) wiederholt Ĵ Sampleoff. Bezeichner Datentyp Ĵ 0h SAMPLE DATA LENGTH 1 Dword Ĵ Lnge des Sampledatenstroms. Bei kompremierten Samples die Lnge des Samplepackstroms. Bei einem Sample das in einer Biblothek gespeichert ist steht SAMPLE DATA LENGTH auf 0. Ĵ 4h SAMPLE DATA STREAM X Bytes Ĵ Sampledatenstrom. Ĵ Ŀ ENDE Block: End-Markierung des DDMFs ͵ Blockoffs. Bezeichner Datentyp Ĵ 0h "ENDE" 1 Dword ------------------------------------------------------------------------------- The Digital Music Files are high quality MOD style files with up to 32 channels/1024 beats per track. The X-Tracker by the demo group D-Lusion produces this format. In general, the format is well organised due to the ID/Blocklength structure wich makes downward compatibility to older version files easy, but the Version 4 (current version) of the file format, produced by X-Tracker 0.30 still requires some manual scanning for the next ID which I regard as not so nice. Version 5 of the format has the [SEQU] block length fixed, but the [SMPD] block has the length 0. The file consists of several blocks, each with a 4 char (dwordint) ID tag and a length of the record data. The main file header looks as follows : OFFSET Count TYPE Description 0000h 4 char ID='DDMF' 0004h 1 byte Version id. 4 -> XTracker 0.30 0005h 8 char Tracker name, e.g. 'XTRACKER', 'HACKTRAK' :-) 000Dh 30 char Song name (ASCIIZ?) 002Bh 20 char Name of composer (ASCIIZ?) 0049h 1 byte Day of creation 004Ah 1 byte Month of creation 004Bh 1 byte Year of creation The other headers have the standard skip record format, in this section named DMFblock. The offsets start _after_ this header record : OFFSET Count TYPE Description 0000h 4 char Record tag (see below) 0004h 1 dword Size of data bedwording to this tag DMFblock [INFO] Contains some message in ASCII. Length of the message is the size of the record. DMFblock [CMSG] Contains the message the composer wants to bring to us. After the ID record, another fill byte preceeds the real message ! OFFSET Count TYPE Description 0000h 1 byte Junk byte 0001h ? char Composer message DMFblock [SEQU] Contains the information necessary for sequencing the different tracks. OFFSET Count TYPE Description 0000h 1 word Song loop start 0002h 1 word Song loop end 0004h ? word Sequencer data DMFblock [PATT] This block contains the information about the different patterns and tracks. 0000h 1 word Maximum pattern (=Songlength) ="MPT" 0004h 1 byte Number of channels of this song (<= 16) 0005h "MPT" rec Pattern data. 1 byte Track entries. (<=32) ="TET" How many tracks this pattern has. XTracker allows a different number of tracks for each pattern. 1 byte Beat information High nibble : Ticks per beat Low nibble : Beats per measure 1 word Maximum number of ticks (<=512) 1 dword Number of bytes to skip for the next pattern information. ? rec Track data stream 1 byte Global track effect 1 byte Global track data (only if global effect >0 !!!) "TET" rec 1 byte Information byte, bitmapped For each bit set in the info byte, one or two data byte(s) follow. This info byte must not always be there, see below. For effects, 2 bytes follow. 0 - reserved 1 - Volume effect 2 - Note effect 3 - Instrument effect 4 - Volume set 5 - Note set 6 - Instrument set 7 - Counter to next information byte. Not set means, that next info byte follows in 1 tick, unit is in ticks. The maximum number of effects is 3 at a time, the maxximum size of a track information is 11 bytes (with info=0FEh). ? rec Effect bytes 1 byte Effect number 1 byte Effect data ? byte Set data ** Here follows the pattern data, but it's too late today ** DMFblock [INST] This block contains the information about the instrument data. If this block does not exists, then the instrument numbers in the patterns point directly to the samples in the [SMPI] block. OFFSET Count TYPE Description 0000h 1 byte Number of instruments 0001h ? rec Instrument information block 30 char The name of the instrument 1 byte Instrument type, bitmapped 0 - Instrument type 1 - Instrument type 00 - Sample in [SMPI] block 01 - MIDI device 10 - FM instrument 11 - reserved 2 - valid attack envelope 3 - sustain on 4 - reserved 5 - reserved 6 - reserved 7 - reserved 1 byte Range entries ="REN" Like the GF1 patterns, an instrument can consist of several samples. "REN" rec Range definition 1 byte Sample to be played in this range 1 byte Length of this range in half tone steps up 6 byte Not yet defined 6-point envelope DMFblock [SMPI] This block contains the information about the samples stored in the file. OFFSET Count TYPE Description 0000h 1 byte Number of samples (<= 250) ="NUM" "NUM" rec Sample record 1 byte Length of sample name ? char Name of the sample 1 dword Length of sample in bytes 1 dword Start of sample loop 1 dword End of sample loop 1 word Frequency used for C-3 1 byte Volume for sample 0 - Don't change current volume otherwise volume (linear scale) 1 byte Sample type, bitmapped 0 - not looped/looped 1 - 8/16-bit sample (16-bit not supported with X-Tracker v0.30) 2,3 - Pack type : 00 - unpacked, signed sample 01 - pack type 0 10 - pack type 1 11 - pack type 2 4-6 - reserved, set to zero 7 - Sample stored in dmf/bib 1 word reserved, set to zero 1 dword crc32 of sample to identify samples in BIB. DMFblock [SMPD] This block contains the sample data (raw or packed, see [SMPI] block) in the following format : etc. OFFSET Count TYPE Description 0000h 1 dword Length of the following sample ? byte Sample data (might be packed) DMFBlock [ENDE] This block serves as a end of file marker and can be used for validation. Note that the four ID characters are _not_ followed by a length dword ! Each DMF file simply ends with the four characters 'ENDE'.