
===================================================================================
 USING OggVorbis files with Risen3D
===================================================================================

 Risen3D will play .ogg sound files natively where stored as a lump.

 At the time of writing four distributions of replacement iwad music
 using the ogg file format were available;

 1) Sycraft - DOOM, DOOM2, PLUTONIA, TNT
 2) Lorcn  - TNT
 3) Ransu   - DOOM, DOOM2
 4) J_War   - Doom2

 These are all avilable from our website

 Once installed then on starting the Launcher a suitable playlist for
 any installed is generated automatically. For more information see
 Laucher help.


 For the inquisitive a discussion of the map music follows purely for
 interest.

 =========     IWAD music    ===============

 The four main iwads (DOOM, DOOM2, PLUTONIA, TNT) each have a different
 music lump name for each map but this does not mean that each lump's
 music is different music. Some contain identical data with the only
 difference being their lump name. Furthermore some of the TNT map
 maps use doom2 music and Plutonia is an amalgam of Doom and Doom2
 music with no new music.

 It appears that there was no intention to produce unique music files
 for each level (time/cost considerations?) but to allow for future map
 music replacement it was necessary to have different lump names.


 ========= Example: TNT music ===============

 Below is listed the iwad lump names used for the TNT music, any duplicate
 and the file names used by Sycraft and Lorcn for the files distributed;

 NUM	IWAD LUMPNAME	DUPLICATE	SYCRAFT
 ---------------------------------------------------------------------
 MAP01	D_RUNNIN			tnt_runnin.ogg
 MAP02	D_STALKS			tnt_stalks.ogg
 MAP03	D_COUNTD			d_countd.ogg	uses Doom2
 MAP04	D_BETWEE			tnt_betwee.ogg
 MAP05	D_DOOM				tnt_doom.ogg
 MAP06	D_THE_DA			tnt_the_da.ogg
 MAP07	D_SHAWN			        tnt_shawn.ogg
 MAP08	D_DDTBLU			tnt_ddtblu.ogg
 MAP09	D_IN_CIT        D_RUNNIN	tnt_runnin.ogg
 MAP10	D_DEAD				tnt_dead.ogg
 MAP11	D_STLKS2			tnt_stlks2.ogg
 MAP12	D_THEDA2			d_ddtblu.ogg	uses Doom2
 MAP13	D_DOOM2	        D_BETWEE	tnt_betwee.ogg
 MAP14	D_DDTBL2			tnt_ddtbl2.ogg
 MAP15	D_RUNNI2	D_STALKS	tnt_stalks.ogg
 MAP16	D_DEAD2			        tnt_dead2.ogg
 MAP17	D_STLKS3			tnt_doom.ogg
 MAP18	D_ROMERO			tnt_dead.ogg
 MAP19	D_SHAWN2			d_shawn2.ogg	uses Doom2
 MAP20	D_MESSAG			tnt_messag.ogg
 MAP21	D_COUNT2			d_in_cit.ogg	uses Doom2
 MAP22	D_DDTBL3			tnt_ddtbl3.ogg
 MAP23	D_AMPIE				d_ampie.ogg	uses Doom2
 MAP24	D_THEDA3			d_betwee.ogg	uses Doom2
 MAP25	D_ADRIAN			d_doom.ogg	uses Doom2
 MAP26	D_MESSG2		        tnt_dead2.ogg
 MAP27	D_ROMER2	D_DDTBLU	tnt_ddtblu.ogg
 MAP28	D_TENSE	        D_DDTBL3	tnt_ddtbl3.ogg
 MAP29	D_SHAWN3	D_BETWEE	tnt_betwee.ogg
 MAP30	D_OPENIN	D_DDTBLU	tnt_ddtblu.ogg
 MAP31	D_EVIL				tnt_evil.ogg
 MAP32	D_ULTIMA	D_COUNT2	d_in_cit.ogg	uses Doom2

--------- inter music
	D_READ_M			tnt_read_m.ogg
	D_DM2TTL			tnt_dm2ttl.ogg
	D_DM2INT	D_EVIL		tnt_evil.ogg



 
 From the above it becomes clear that there are 23 unique map music lumps and
 not 32.  For the sceptics then to test this start TNT at map 01, note how the
 music sounds and then warp to map09.  You should hear that the map music is
 identical.

 For replacement OGG music, therefore, the need is to produce 23 new map music
 files rather than 32 (excluding the inter music).

 Where ogg music for Doom2 has already been created then this is further
 reduced to 15. As such the Doom2 Sycraft files should also be downloaded and
 installed where wanting a complete set for TNT.


 gmj Feb 2012