godot-docs/classes/class_audioeffectreverb.rst

:github_url: hide

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the AudioEffectReverb.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.

.. _class_AudioEffectReverb:

AudioEffectReverb
=================

**Inherits:** :ref:`AudioEffect<class_AudioEffect>` **<** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`

**Category:** Core

Brief Description
-----------------

Adds a reverberation audio effect to an Audio bus.

Simulates the sound of acoustic environments such as rooms, concert halls, caverns, or an open spaces.

Properties
----------

+---------------------------+------------------------------------------------------------------------------+-------+
| :ref:`float<class_float>` | :ref:`damping<class_AudioEffectReverb_property_damping>`                     | 0.5   |
+---------------------------+------------------------------------------------------------------------------+-------+
| :ref:`float<class_float>` | :ref:`dry<class_AudioEffectReverb_property_dry>`                             | 1.0   |
+---------------------------+------------------------------------------------------------------------------+-------+
| :ref:`float<class_float>` | :ref:`hipass<class_AudioEffectReverb_property_hipass>`                       | 0.0   |
+---------------------------+------------------------------------------------------------------------------+-------+
| :ref:`float<class_float>` | :ref:`predelay_feedback<class_AudioEffectReverb_property_predelay_feedback>` | 0.4   |
+---------------------------+------------------------------------------------------------------------------+-------+
| :ref:`float<class_float>` | :ref:`predelay_msec<class_AudioEffectReverb_property_predelay_msec>`         | 150.0 |
+---------------------------+------------------------------------------------------------------------------+-------+
| :ref:`float<class_float>` | :ref:`room_size<class_AudioEffectReverb_property_room_size>`                 | 0.8   |
+---------------------------+------------------------------------------------------------------------------+-------+
| :ref:`float<class_float>` | :ref:`spread<class_AudioEffectReverb_property_spread>`                       | 1.0   |
+---------------------------+------------------------------------------------------------------------------+-------+
| :ref:`float<class_float>` | :ref:`wet<class_AudioEffectReverb_property_wet>`                             | 0.5   |
+---------------------------+------------------------------------------------------------------------------+-------+

Description
-----------

Simulates rooms of different sizes. Its parameters can be adjusted to simulate the sound of a specific room.

Property Descriptions
---------------------

.. _class_AudioEffectReverb_property_damping:

- :ref:`float<class_float>` **damping**

+-----------+--------------------+
| *Default* | 0.5                |
+-----------+--------------------+
| *Setter*  | set_damping(value) |
+-----------+--------------------+
| *Getter*  | get_damping()      |
+-----------+--------------------+

Defines how reflective the imaginary room's walls are. Value can range from 0 to 1.

.. _class_AudioEffectReverb_property_dry:

- :ref:`float<class_float>` **dry**

+-----------+----------------+
| *Default* | 1.0            |
+-----------+----------------+
| *Setter*  | set_dry(value) |
+-----------+----------------+
| *Getter*  | get_dry()      |
+-----------+----------------+

Output percent of original sound. At 0, only modified sound is outputted. Value can range from 0 to 1.

.. _class_AudioEffectReverb_property_hipass:

- :ref:`float<class_float>` **hipass**

+-----------+----------------+
| *Default* | 0.0            |
+-----------+----------------+
| *Setter*  | set_hpf(value) |
+-----------+----------------+
| *Getter*  | get_hpf()      |
+-----------+----------------+

High-pass filter passes signals with a frequency higher than a certain cutoff frequency and attenuates signals with frequencies lower than the cutoff frequency. Value can range from 0 to 1.

.. _class_AudioEffectReverb_property_predelay_feedback:

- :ref:`float<class_float>` **predelay_feedback**

+-----------+------------------------------+
| *Default* | 0.4                          |
+-----------+------------------------------+
| *Setter*  | set_predelay_feedback(value) |
+-----------+------------------------------+
| *Getter*  | get_predelay_feedback()      |
+-----------+------------------------------+

Output percent of predelay. Value can range from 0 to 1.

.. _class_AudioEffectReverb_property_predelay_msec:

- :ref:`float<class_float>` **predelay_msec**

+-----------+--------------------------+
| *Default* | 150.0                    |
+-----------+--------------------------+
| *Setter*  | set_predelay_msec(value) |
+-----------+--------------------------+
| *Getter*  | get_predelay_msec()      |
+-----------+--------------------------+

Time between the original signal and the early reflections of the reverb signal, in milliseconds.

.. _class_AudioEffectReverb_property_room_size:

- :ref:`float<class_float>` **room_size**

+-----------+----------------------+
| *Default* | 0.8                  |
+-----------+----------------------+
| *Setter*  | set_room_size(value) |
+-----------+----------------------+
| *Getter*  | get_room_size()      |
+-----------+----------------------+

Dimensions of simulated room. Bigger means more echoes. Value can range from 0 to 1.

.. _class_AudioEffectReverb_property_spread:

- :ref:`float<class_float>` **spread**

+-----------+-------------------+
| *Default* | 1.0               |
+-----------+-------------------+
| *Setter*  | set_spread(value) |
+-----------+-------------------+
| *Getter*  | get_spread()      |
+-----------+-------------------+

Widens or narrows the stereo image of the reverb tail. 1 means fully widens. Value can range from 0 to 1.

.. _class_AudioEffectReverb_property_wet:

- :ref:`float<class_float>` **wet**

+-----------+----------------+
| *Default* | 0.5            |
+-----------+----------------+
| *Setter*  | set_wet(value) |
+-----------+----------------+
| *Getter*  | get_wet()      |
+-----------+----------------+

Output percent of modified sound. At 0, only original sound is outputted. Value can range from 0 to 1.