This page has been translated automatically.
Setting Up Development Environment
High-Level Systems
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine and Tools
Double Precision Coordinates
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
Rendering-Related Classes
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Sound Reverb

The famous koan goes: "Two hands clap and there is a sound; what is the sound of one hand?" The same way the sound and its reflections are physically interconnected and constitute the same sonic phenomenon for the listener. After the sound is emitted, there begins a long and multifarious interactions of the dispersing sound waves with the environment. Contribution of the naturally emulated reflections cannot be diminished: they are necessary to give a sound a sense of place and reality, and fool the ear into believing in authenticity of the auditory experience.

Sound reverb

The sound reverberation zone correctly reproduces the way that sound is reflected from surfaces, forming three main components:

  • early reflections,
  • late reverberation and
  • echo.
Besides that, a number of parameters can be changed to alter the type of environment being simulated.

Reverberation Zone Size

The reverberation zone represents a separate acoustic enclosure in the virtual world. It limits the perimeter in which to the sound will be added reverberation. Outside this zone, the sound emitted by sources will not undergo reverberation modification. If two zones overlap with each other, their parameters will be linearly interpolated for proper physical simulation of the mixed characteristics.

The size of the zone (in units) is set along three coordinates axes: X, Y and Z.


For comfortable concentration on the displayed, sound snapping is strongly undesirable. Threshold enables smooth sound transition when the listener moves from the outside area into the reverberation zone. Its values are set as an offset inside the zone along X-, Y- and Z-axis relative to the zone perimeter.

Reverberation zone threshold


When the sound wave reaches an obstacle, smaller part of it is absorbed by the material depending on its rigidity and density characteristics. But the most part bounces off and then reaches the listener's ears. It can also continue to the next obstacle to be bounced off for the second time. This sounds are called the first-order and second-order reflections. Though being perceived a split second later than the original sound, they are still interpreted by the brain as one integrated sound because of their similarity and closeness in time. The integrated sound not only seems to be loader, but it may take some tone coloration.

Even in complete darkness the listener can orient himself basing on the sound environment cues. Of course, it is not possible to reproduce the exact location geometry, but the character of the reflections gives some indication of the immediate surroundings. For example, a strong and immediate primary reflection tells that the walls are close. The change in tonal colouration indicates the reflective quality of the wall — whether it is highly reflective or somewhat absorptive, muting the reflections.

Reflection Gain

The overall amount of the initial reflections can be adjusted independently from other reverberation parameters. Reflection Gain represents linear gain, corrected by the general reverberation sound Gain parameter, with the following values available:

  • A maximum of 3.16 equals +10  dB for the reflections.
  • A minimum of 0 equals -100  dB and results in having no initial reflections at all.

Reflection Delay

It is the amount of delay between the arrival time of the direct emitted sound to the first reflection from the source that helps to estimate subconsciously the location size. The corresponding Reflection Delay parameter ranges from 0 to 0.3  seconds.

  • Reducing the value simulates close and small locations.
  • Increasing the value means the reflective surfaces are situated farther.


With the first and secondary reflections the path of the sound wave does not end. These reflections originate further reflections that in their turn induce more reflections, until totally loosing specularity and becoming inaudible. All this reflections become merged into an overall sonic wash called the reverberation. The reflections and reverberation tend to be perceived as one combined and very prolonged sound wave. The reverberation tail provides yet another environmental audio cue depending on its length and loudness. The more reflective the walls are and the larger the room, the longer the reverberation lasts. The more reflective the walls are and the smaller the room, the louder the reverberation.

Reverberation Decay Time

The decay time defining the character of the reverberation tail can also be tweaked independently for accurate acoustic simulation. It represents the interval between the onset of late reverberation and the time when its intensity has been reduced by 60  dB. The parameter has the following values:

  • A minimum of 0.1  seconds is typically appropriate for the small rooms with dead surfaces.
  • A maximum of 20.0  seconds is typically appropriate for a large room with very live surfaces.

Decay LF Ratio

To fine-tune the decay time of the low frequencies the Decay LF Ratio parameter can be used. It is the ratio of low-frequency decay time relative to the time set by Decay Time.

  • For the decay time to be equal at all frequencies, neutral value 1.0 is used.
  • Increasing the value above the neutral one results in having a longer decay time at the low frequencies than at mid ones. The reverberation acquires the booming character with long low frequencies tail.
  • Decreasing the value below 1.0 shortens the low frequencies decay time relative to the mid ones. The final reverberation sounds more tinny.

Decay HF Ratio

The Decay HF Ratio also adjusts the spectral quality of the Decay Time parameter. It represents a linear multiplier value for the Decay Time parameter.

  • For the decay time to be equal at all frequencies, neutral value 1.0 is used.
  • Increasing the value above the neutral one results in having a longer decay time at the high frequencies than at mid ones. The reverberation will be more brilliant with long high frequencies tail.
  • Decreasing the value below 1.0 shortens the high frequencies decay time relative to the mid ones. The final reverberation sounds more naturally.

Late Reverb Gain

To define the total intensity of the reverberation sound (the averaged square of its amplitude), adjusting the Reverberation Decay is not enough. The late reverb gain controls the overall amount of later reverberation relative to the general Gain parameter.

  • A maximum of 10.0 equals +20  dB for the reverberation.
  • A minimum of 0 equals -100  dB and results in having no reverberation at all.

Late Reverb Delay

Besides the time of the sounding, the begin time of the reverberation relative to the time of the initial reflection (the first of the early reflections) can be set. The Late reverb delay ranges from 0 to 0.1  seconds.


If the reflector is located on the considerable distance from the sound source, it takes some time for the sound wave to reach the listener. Since the perception of a sound usually endures in memory for only 0.1 seconds, there will be a small time delay between the perception of the original sound and the perception of the reflected sound. Such discrete perception of the reflected sound wave is called an echo. The following parameters allow the veridical imitation of this phenomenon:

Echo Depth

The Echo Depth parameter modulates a cyclic echo in the reverberation decay, which is especially noticeable with transient or percussive sounds. It is a linear multiplier value that determines how long the echo will persist along the reverberation decay. The larger the value, the more prominent the echo effect will be.

Combined with diffusion parameter, echo depth introduces a more diffuse environment, where the echo wash dies more quickly, or less diffuse one, with large number of echo repetitions. If Diffusion is set to 0 and Echo Depth is set to 1.0, the echo will persist distinctly until the end of the reverberation decay.

Echo Time

The Echo Time controls the time period for cyclic echo to repeat itself along the reverberation decay. For example, if the time is set to 0.250  seconds, the echo will occur 4 times per second. Therefore, on beating the drum in such reverberation zone, the listener will hear four four repetitions of beat per second.


To control the maximum amount of reflections and reverberation added to the final sound perceived by the listener, the gain parameter is used. It affects all the sound sources placed in the reverberation zone. Gain is a scalar multiplier for the amplitude of the produced reverberation sound.

  • The Gain value of 1.0 (0  db) equals the maximum amount of reflected sound.
  • The Gain value of 0 (-100  db) results in having no reflected sound at all.

Gain at Low Frequencies

For further fine-tuning adjustment, Gain LF is designed. It is a multiplier allowing to attenuate the reflected sound generated in the zone at low frequencies.

  • If the Gain LF value is set to 1.0 (0  db), no filter is applied.
  • The Gain LF value of 0 (-100  db) results in having virtually no reflected sound.

Gain at High Frequencies

The high frequencies are attenuated the same way, as the low ones.

Pitch Modulation

The pitch modulation effect is not usually encountered in the real life, but it can be used to carry the emotional load and add additional expression to the established sound environment. For example, with its help the feeling of dizziness or intoxication is aurally rendered, especially when set to extreme together with other parameters values. This effect will be most noticeable when applied to the reverberation zone with sources that have tonal color or pitch.

Modulation Time

Modulation Time stands for the speed of the vibrato (rate of periodic changes in pitch). The available range is from 0.04 to 4.0  seconds. The default is 0.25  seconds.

Modulation Depth

Modulation Depth is a linear multiplier value that controls the amount of pitch change. Combined with low diffusion values, the mixing of overlapping reflections in the reverberation decay is reduced and perceived effect is reinforced. By default, modulation depth is set to 0.

Room Rolloff

Not only the sound emitted by the source becomes fuzzy and indistinct as the listener withdraws from it. The same is valid for its reflections and reverberations. The room rolloff factor defines the rate at which reflected sound is attenuated with distance. It is concurrent to the appropriate parameter of the sound source, except being set for the whole reverberation zone.

  • By default value is set to 0 because the natural rolloff of reflected sound is automatically simulated for each sound source.
  • Setting the factor to 1.0 will result in reflected sound decay by 6 dB every time the distance doubles.
  • Any other value will be equivalent to scaling factor for the reference source-listener distance.

Air Absorption

Similar to the another appropriate sound source parameter, the transition of the reflected sound through the specific medium, such as fumes or, on the contrary, dry heated air, can be simulated. The present parameter is applied to the reflected sound in the reverberation zone. The air absorption controls the distant-depending attenuation at high frequencies due to propagation medium characteristics. The reason for such filtering is the following: all materials in the sound environment are more efficient at reflecting the specific sound frequencies, but in most cases high frequencies tend to be absorbed more readily than low frequencies. As a result, reverberation time of low frequencies turn out to be longer. In very large spaces, the effect of the air absorbing high frequencies may exaggerate this tendency, giving the reverb tail a rolling or thunder-like quality.

  • The default value of 0.994 (-0.05  dB) per per unit approximates normal atmospheric humidity and temperature.
  • Lower value corresponds to a more humid medium.
  • Higher value corresponds to a less absorbent medium.

Reverberation Density

The density defines the coloration of the late reverberation sound. As the density increases, the individual resonances making up the reverb component of the sound are interlaid more tightly.

  • The default value of 1.0 provides the highest density of reverberation, that tends to sound more natural on drums and percussion.
  • Lowering the value can produce coarse-sounding reverberation for the percussive sounds while often embellishing non-percussive ones and adding more coloration.

Reverberation Diffusion

Closely related to density is diffusion, which determines the rate at which the resonances increase in density after the original sound during the reverberation decay. A square room with flat surfaces might exhibit a relatively low diffusion rate compared with a similarly sized room covered in irregularly shaped surfaces, which is one reason for concert halls being built with pillars and ornate alcoves.

  • The default 1.0 provides the highest increase in density.
  • By reducing the density, the reverberation acquires more granularity in sounding, especially noticeable with percussive sound sources.
  • If set to 0, the reverberation decay sounds like a succession of distinct and individual echoes.
Last update: 2017-07-03
Build: ()