REVERBS

If snd_waterreverb is true, ZDoom automatically applies an underwater reverb to deep water areas created with Transfer_Heights, 3D floors, or a WaterZone thing. You can change this option from the sound options menu. Underwater reverb is automatic, and does not require any special behavior in the maps for its use. You can also force the underwater reverb effect on in any area of your map by using a SoundEnvironment thing with its first two arguments set to 255 (see below).

Note that this menu option is only for enabling automatic underwater effects in swimmable water. Any reverb environments that have been placed in the map will always be heard, regardless of this option.

To use reverb in your maps, you need to place the SoundEnvironment thing (ednum 9048) into your map, and then change its arguments. The first two values are used.

Because only one reverb can be used at a time, you may want to block off a reverb thing from taking over the whole map. To do this, border the area with lines set to be zone boundaries. In a UDMF map, set zoneboundary to be true. In the Hexen map format, use Line_SetIdentification, with argument 2 set to 1.

If you set the reverb thing to inactive in your map editor, the reverb effect will not take effect immediately. You can then activate it via ACS to "turn on" the reverb effect. However, you cannot simply deactivate the thing to disable the reverb effect; instead, you must activate another one in the same area. If you want the reverb to turn off completely, you can add a reverb thing with its properties set to 0 0 (See below) and activate it when you'd like to disable all reverb effects.

An example map is found here: http://zdoom.org/files/examples/eax.zip

An environment definition takes a fancy name within strings and two numbers as identifiers, the number combination must be unique. The rest is a list of named parameters within curly braces. On Windows, ZDoom includes an interactive reverb editor accessible with the reverbedit console command that lets you adjust these settings and get feedback in realtime.

• AirAbsorptionHF float

Change in level per meter at high frequencies.

• bDecayHFLimit bool

AirAbsorptionHF affects DecayHFRatio.

• bDecayTimeScale bool

EnvironmentSize affects reverberation decay time.

• bEchoTimeScale bool

EnvironmentSize affects echo time.

• bModulationTimeScale bool

EnvironmentSize affects modulation time.

• bReflectionsDelayScale bool

EnvironmentSize affects initial reflection delay time.

• bReflectionsScale bool

EnvironmentSize affects reflection level.

• bReverbDelayScale bool

EnvironmentSize affects late reverberation delay time.

• DecayHFRatio float

High-frequency to mid-frequency decay time ratio.

• DecayLFRatio float

Low-frequency to mid-frequency decay time ratio.

• DecayTime float

Reverberation decay time at mid frequencies.

• Density float

Value that controls the modal density in the late reverberation decay.

• Diffusion float 100.000

Value that controls the echo density in the late reverberation decay.

• EchoDepth float 1.000

Echo depth.

• EchoTime float 0.095

Echo time.

• Environment int

???

• EnvironmentDiffusion float

Environment diffusion.

• EnvironmentSize float

Environment size in meters.

• HFReference float

Reference high frequency in Hertz.

• LFReference float

Reference low frequency in Hertz.

• ModulationDepth float

Modulation depth.

• ModulationTime float

Modulation time.

• Reflections int

Early reflections level relative to room effect.

• ReflectionsDelay float

Initial reflection delay time.

• ReflectionsPanX float
• ReflectionsPanY float
• ReflectionsPanZ float

Early reflections panning vector.

• Reverb int

Late reverberation level relative to room effect.

• ReverbDelay float

Late reverberation delay time relative to initial reflection.

• ReverbPanX float
• ReverbPanY float
• ReverbPanZ float

Late reverberation panning vector.

• Room int

Room effect level at mid-frequencies.

• RoomHF int

Relative room effect level at high frequencies.

• RoomLF int

Relative room effect level at low frequencies.

• RoomRolloffFactor float

Logarithmic distance attenuation rolloff scale factor for reverb room size effect.

"Castle Alcove" 30 0
{
  Environment 20
  EnvironmentDiffusion 0.890
  RoomHF -600
  RoomLF -2000
  DecayTime 1.640
  DecayHFRatio 0.870
  DecayLFRatio 0.310
  Reflections -100
  ReflectionsDelay 0.007
  Reverb -500
  ReverbDelay 0.034
  EchoTime 0.138
  EchoDepth 0.080
  HFReference 5168.600
  LFReference 139.500
  bDecayHFLimit true
  bEchoTimeScale true
}