DDF Playlist

Stored in the DDFPLAY data lump, or the playlist.ddf file.

DDFPLAY is used to define music entries in EDGE-Classic. Each entry begins with a unique reference number, in square brackets, and represents a piece of music that can be played at some point in the game. Either during a level, or as one of the intermission or title pieces of music. These entries are then referred to from the other DDF files, such as DDFLEVL/levels.ddf or DDFGAME/game.ddf.

NOTE: When using filenames, directories must be separated by / instead of the \ character which is normally used under Windows. The reason is because the \ character has a special meaning in DDF: it is the escape character, and "\n" is used to put newlines into DDF strings.

Format

Entries in DDFPLAY have the following format:

[ENTRY NUMBER] MUSICINFO=[TYPE]:[FORMAT]:[SONG NAME];

Where each command is as follows:

COMMAND	DESCRIPTION
[ENTRY_NUMBER]	A two digit number, used to reference this entry in games.ddf and level.ddf.
[TYPE]	This can be MIDI, MUS, MP3, OGG, SID, FLAC, M4P, RAD, IMF280, IMF560 or IMF700 and should refer to the type of music source that is being used.
[FORMAT]	If the music is in a wadfile, this must be LUMP. If the music is in a pack, this must be PACK. If the music is a file on the hard drive this must be FILE.
[SONG NAME]	Name of the actual file in the wadfile or on the hard drive. Entries with an underscore "_" in **require** quotes around the name (e.g. "D_DEAD").

Examples

The following are examples of different playlist entries:

[10] MUSICINFO=MUS:LUMP:"D_DEAD";      // NOTE: names with "_" in them **require** quotes

[23] MUSICINFO=OGG:FILE:"music/QOTSA/A_Song_for_the_dead.ogg";     

DDF docs written by Andy Baker and Ziggy Gnarly, with updates by Andrew Apted, Andy Brewood and Luke Brennan. © EDGE Team, et al. 1998 - 2024.