Doom GUS addon

TITLE: Doom: dmxgus & Gravis UltraSound Ports
AUTHOR: TKBS
SITE: TKBS.UK | wordpress = @unrealbyfusilade
DATE: 2024
INFO: Ports of GRAVIS .pat files to .sf2 | .dls | .cfg | .ini
1. * dmxgus.ini Memory Re-Mappings ported to timidity.cfg
2. * 1.1 | 1.6 | C = [256 | 512 | 768 | 1024] & [Unlimited]
3. * additional upgraded 1024 mem size re-mappings to add missing drum set instruments
4. * Gravis Soundfonts .sf2 and .dls

------------------------------
Recommendations:
------------------------------
* Use the Full Instrument Set from gravis for ini | cfg
For timidity:
timidity_(gus_ultramid.ini)_FULL.cfg
For Doom:
UNLIMITD.INI

------------------------------
Contents:
------------------------------
* Inside the .pk3;

[WADs]
ULTRAMID.wad = The Original Gravis "Ultramid.ini" - No doom Re-Mapping

[.cfg]
timidiy.cfg = All mem size mappings ++
1.1 | 1.6 | C = [256 | 512 | 768 | 1024] & [Unlimited]

[.sf2 | .dls]
001 = a straight port of gravis .pat files to .sf2
= uses "ultramid.ini" patch-instruments list.
= retains original data & settings etc
= Filename: "TKBS-GUS.sf2" | TKBS-GUS.dls

002 = dmxgusC.ini 1024 Mem Size Set as .sf2
= Filename: "dmxgusC_1024.sf2" | dmxgusC_1024.dls
- Only the doom II dmxgusC.ini 1024 MEM Size Instrument mappings.

[dmxgus v1 (Ultramid.ini version)]; //timidiy.cfg('s) = all cfg's variants
1. timidity_(dmxgus1.1)_256.cfg
2. timidity_(dmxgus1.1)_512.cfg
3. timidity_(dmxgus1.1)_768.cfg
4. timidity_(dmxgus1.1)_1024.cfg
5. timidity_(dmxgus1.1)_1024_upgraded.cfg
- Adds Drum Set entries to BLANK spaces from other mem sizes ( 256 | 512 | 768 )
6. timidity_(dmxgus1.1)_1024_upgraded+C.cfg
- Also Adds "dmxgusC.ini" drums to fill blanks.

[dmxgus v2 (Tom Klok's version)];
1. timidity_(dmxgus1.6)_256.cfg
2. timidity_(dmxgus1.6)_512.cfg
3. timidity_(dmxgus1.6)_768.cfg
4. timidity_(dmxgus1.6)_1024.cfg
5. timidity_(dmxgus1.6)_1024_upgraded.cfg
- Adds Drum Set entries to BLANK spaces from other mem sizes ( 256 | 512 | 768 )
6. timidity_(dmxgus1.6)_1024_upgraded+C.cfg
- Also Adds "dmxgusC.ini" drums to fill blanks.

[dmxgusC (doom2 version)];
1. timidity_(dmxgusC)_1024.cfg.txt
2. timidity_(dmxgusC)_1024_Upgraded.txt
- Adds Drum Set entries to BLANK spaces from other mem sizes ( 256 | 512 | 768 )

[Ultramid.ini -> .cfg];
1. timidity_(gus_ultramid.ini)_FULL.cfg
- ultramid.ini 1024 mem size set to use the full instrument set.
2. timidity_(gus_ultramid.ini)_1024.cfg
- ultramid.ini 1024 mem size set.
3. timidity_(gus_ppatlite.ini)_1024.cfg
- ppatlite.ini 1024 mem size set.

[Ultramid.ini];
UNLIMITD.INI

---------------------------
FIXING THE DRUM SET:
---------------------------
["+ missing drum set instruments"]
* users can re-implement lost instruments: additional instruments were blanked for memory saving reasons etc;

Examples: [patch ## are blank]
* In dmxgus.ini v1 (ultramid.ini)
* and In dmxgus.ini v2 (T.klok's)
* Some instruments are 'blank' whilst in other mem size re-mapping exists as an instrument

[OLD]
31 BLANK
[NEW - EXTRAS]
31 sticks

* For a Full, easier to read, example of adding the missing instruments See;
timidity_(dmxgus1.1)_1024_upgraded.cfg
timidity_(dmxgus1.6)_1024_upgraded.cfg

----------------
Conclusion:
----------------
* tom kloks re-mappings produce an ok result, but they were based on GUS having limited memory, are nothing like a full instrument set, nor are they anywhere near a good replacement to original roland instrument sets.
* use the full set

----------------
Notes:
----------------
- I am not sure how much memory room there is, but it should be possible to add them all.
- i have not checked if the instruments/ patch numbers are even used.
(*a*) - in may be possible to use with original doom engine (e.g. MSDOS/ DOSBox) - but not tested!
(*b*) - Using zdoom etc with GUS Unlimited memory will work.
(*c*) - the timidity config is easier to read that a full dmxgus.ini.
* based on the id release notes: it doesn't ever specify the ini needs to be inside the .wad, but it does need to be re-named to "dmxgus.ini"
* doom was released in 1993 Not 1994: and "Tom Klok" is not the midi composer "Bobby Prince" was, but for whatever reason the ini was changed.
* many variants of dmxgus.ini's exist, and many timidity.cfg variants, but they are usually based on the tom klok ini files, the 2nd dmxgusC.ini.
* i do not know how zdoom handles the loading of dmxgus stuff, so i do not know if you can put dmgus.ini & dmxgusC.ini in the same .wad | .pk3, or whether doom 1 will run a "dmxgusC.ini"
* DOOMII music really does not suit doom at all and most doom I tracks are not great.

----------------
general info:
----------------
TOTAL:
256 melodic and percussive instruments

GUS:
128
129 to 255 = percussive instruments played on channel 10;
ultramid.ini = 155 (27) to 215 (87)

GM:
163 to 209 = General MIDI programs 35 to 8