Class: Seal::Reverb

Sets the air absorption high-frequency gain of reverb in the interval [0.892, 1.0]. It controls the distance-dependent attenuation at high frequencies caused by the propagation medium. It applies to reflected sound only. You can use this value to simulate sound transmission through foggy air, dry air, smoky atmosphere, and so on. The default value 0.994 (-0.05 dB) per meter, which roughly corresponds to typical condition of atmospheric humidity, temperature, and so on. Lowering the value simulates a more absorbent medium (more humidity in the air, for example); raising the value simulates a less absorbent medium (dry desert air, for example).

Gets the decay time of reverb. The default is 1.49.

Sets the decay time of reverb in the interval [0.1, 20.0], typically from a small room with very dead surfaces to a large room with very live surfaces.

Gets the density of reverb. The default is 1.0.

Sets the modal density of reverb in the interval [0.0, 1.0]. The density controls the coloration of the late reverb. The Lower the value, the more coloration.

Gets the diffusion of reverb. The default is 1.0.

Sets the diffusion of reverb in the interval [0.0, 1.0]. The diffusion controls the echo density in the reverberation decay. Reducing diffusion gives the reverberation a more “grainy” character that is especially noticeable with percussive sound sources. If you set a diffusion value of 0.0, the later reverberation sounds like a succession of distinct echoes.

Gets the gain of reverb. The default is 0.32.

Sets the gain of reverb in the interval [0.0, 1.0], or from -100 dB (no reflected sound at all) to 0 dB (the maximum amount). The gain is the master volume control for the reflected sound (both early reflections and reverberation) that the reverb effect adds to all sources. It sets the maximum amount of reflections and reverberation added to the final sound mix.

Determines if the high-frequency decay of reverb is limited. The default is true.

Sets whether the high-frequency decay time automatically stays below a limit value that's derived from the setting of the air absorption high- frequency gain. This limit applies regardless of the setting of the decay high-frequency ratio, and the limit doesn't affect the value of decay high-frequency ratio. This limit, when on, maintains a natural sounding reverberation decay by allowing you to increase the value of decay time without the risk of getting an unnaturally long decay time at high frequencies. If this flag is set to false, high-frequency decay time isn't automatically limited.

Gets the high-frequency decay ratio of reverb. The default is 0.83.

Sets the high-frequency decay ratio, or the spectral quality of the decay time of reverb in the interval [0.1, 2.0]. It is the ratio of high-frequency decay time relative to the time set by decay Time. 1.0 means neutral: the decay time is equal for all frequencies. As this value increases above 1.0, the high-frequency decay time increases so it's longer than the decay time at low frequencies. You hear a more brilliant reverberation with a longer decay at high frequencies. As this value decreases below 1.0, the high-frequency decay time decreases so it's shorter than the decay time of the low frequencies. You hear a more natural reverberation.

Gets the high-frequency gain of reverb. The default is 0.89.

Sets the high-frequency gain of reverb in the interval [0.0, 1.0], or from -100 dB (virtually no reflected sound) to 0 dB (no filter). The high- frequency gain further tweaks reflected sound by attenuating it at high frequencies. It controls a low-pass filter that applies globally to the reflected sound of all sound sources feeding the particular instance of the reverb effect.

Gets the late delay of reverb. The default is 0.011.

Sets the late delay of reverb in the interval [0.0, 0.1] (in second) It defines the begin time of the late reverberation relative to the time of the initial reflection (the first of the early reflections). Reducing or increasing late delay is useful for simulating a smaller or larger room.

Gets the late gain of reverb. The default is 1.26.

Sets the late gain, or the overall amount of later reverberation relative to the gain of reverb in the interval [0.0, 10.0], or from -100 dB (no late reverberation at all) to 20 dB.

Note that late gain and decay time are independent properties: if you adjust decay time without changing late gain, the total intensity (the averaged square of the amplitude) of the late reverberation remains constant.

Loads the specified reverb paramter preset into reverb.

Gets the reflections delay of reverb. The default is 0.007.

Sets the reflections delay of reverb in the interval [0.0, 0.3] (in seconds). It is the amount of delay between the arrival time of the direct path from the source to the first reflection from the source. You can reduce or increase this delay to simulate closer or more distant reflective surfaces and therefore control the perceived size of the room.

Gets the reflections gain of reverb. The default is 0.05.

Sets the reflections gain, or the overall amount of initial reflections relative to the gain of reverb in the interval [0.0, 3.16], or from -100 dB (no initial reflections at all) to 10 dB. The reflections gain is corrected by the value of the gain property and does not affect the subsequent reverberation decay.

You can increase the amount of initial reflections to simulate a more narrow space or closer walls, especially effective if you associate the initial reflections increase with a reduction in reflections delays by lowering the value of the reflection delay property. To simulate open or semi-open environments, you can maintain the amount of early reflections while reducing the value of the late gain property, which controls later reflections.

Gets the room rolloff factor of reverb. The default is 0.0.

Sets the room rolloff factor of reverb in the interval [0.0, 10.0]. It is one of two methods available to attenuate the reflected sound (containing both reflections and reverberation) according to source- listener distance. It is defined the same way as the global rolloff factor, but operates on reverb sound instead of direct-path sound. Setting the room rolloff factor value to 1.0 specifies that the reflected sound will decay by 6 dB every time the distance doubles. Any value other than 1.0 is equivalent to a scaling factor applied to the quantity specified by ((source listener distance) - (Reference Distance)). Reference Distance is an OpenAL source parameter that specifies the inner border for distance rolloff effects: if the source comes closer to the listener than the reference distance, the direct-path sound isn't increased as the source comes closer to the listener, and neither is the reflected sound.

The default value of Room Rolloff Factor is 0.0 because, by default, the reverb effect naturally manages the reflected sound level automatically for each sound source to simulate the natural rolloff of reflected sound vs. distance in typical rooms. (Note that this isn't the case if the source property @TODO is set to false.) You can use this value as an option to automatic control so you can exaggerate or replace the default automatically-controlled rolloff.