GENMIDI

GENMIDI is a WAD lump that contains instrument data for the DMX sound library to use for OPL synthesis. Given an *.OP2 extension, it can be used in MUSPlayer.

The lump is a database of OPL register values, used to program the OPL chip found in the AdLib and Sound Blaster sound cards. It contains 175 entries, one for each of the 128 standard General MIDI instruments and 47 percussion effects.

Instruments settings that were shipped with the DMX library were made by Scott Host of Cygnus Studios using the stock General MIDI settings from AdLib Inc. as a starting point. Then id Software and Rogue Entertainment made their own tweaks to these settings.

Doom and Doom II have different GENMIDI lumps, but Final Doom reuses the Doom II set, resulting in a different sound for the Doom tracks used in Plutonia. Heretic, Hexen, and the Strife demo, on the other hand, use the standard DMX set. The retail version of Strife provides its own set, derived from the Doom II set.

Header
The lump has an 8-byte ASCII header, containing the text "#OPL_II#".

Instrument data
The header is followed by 175 36-byte records of instrument data.

Each record has a 4 byte header of the following form:

The flags value is a bitfield containing several flags that control the record. These are:

Following the header are two 16 byte records of OPL voice data. If the double voice bit is set in the header, both voices will be played simultaneously; otherwise, only the first set of voice data is played.

The voice data has this format:

This data is essentially the same as the data found in Soundblaster SBI files; the differences are that the data is ordered differently, and the key scale and output level fields are split into two separate bytes within GENMIDI. In the SBI format, they are combined as bitfields within a single byte. For this reason, and because of the extra unused fields, the GENMIDI instrument data is longer (16 bytes) than SBI data (11 bytes).

Instrument names
Following the instrument data is 175 32-byte ASCII fields containing the names of the standard General MIDI instruments. It is not clear how these names are used within the sound code, if at all.

Waveform support
All stock GENMIDI Instruments are designed to play on OPL2, so none of the OPL3 waveforms are ever used. However, DMX supports the additional 4 waveforms provided by the OPL3 chip, provided that DMX is set to OPL3 mode.

Quirks and limitations

 * When a double voice instrument is played, both voices' carrier waves will play as if they have the same volume level, which is determined by the first voice.
 * Voices in AM mode may exhibit issues when feedback is used.
 * The octave range is narrower than what the OPL chip allows. Notes under or over a certain octave threshold will "fold back", or repeat the notes from the lowest or highest octave.

Use in modern ports
Most modern operating systems do not provide the ability to program the OPL chip directly; indeed, most modern computers do not even contain OPL-compatible sound chips. It is therefore common for source ports to simply use the standard MIDI playback API, and the GENMIDI lump is not used. There are a few source ports which do use the GENMIDI lump; particularly as it is necessary when performing OPL emulation. Ports with GENMIDI support include Chocolate Doom and ZDoom.

Trivia

 * The Stock DMX, Doom and Doom II GENMIDI lumps contain some percussion instruments that were once defined, but intentionally silenced. These include the Short and Long Whistle, the Short and Long Guiro, and the Mute and Open Cuica.
 * There exist instruments in the Doom GENMIDI lump with defined second voices, but the double voice flag is disabled.
 * Some instruments have an asterisk before the instrument names. This is likely left over from development to indicate a pasted duplicate of an existing instrument.
 * Instrument 88, listed as "Pad 1 (new age)" in the GM standard, is misnamed as "* Lead 8 (bass & lead)". It is also a direct copy of Instrument 87, listed as "Lead 8 (bass & lead)". This is clearly a mistake, given that these two instruments are located next to each other in the instrument listing.
 * The most notable GENMIDI voices differing between Doom and Doom II are the Overdriven Guitar, Fretless Bass, and Acoustic Bass. The Acoustic Bass in Doom was an octave higher than intended, which was fixed in Doom II. The Fretless Bass changes were likely for aesthetics, given that Fretless Bass was used a lot more in Doom II music. The Overdriven Guitar in Doom II is a slight modification of the Distortion Guitar from Doom.