Files
godot-docs/classes/class_audioeffectreverb.rst

143 lines
9.0 KiB
ReStructuredText

.. 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 Reverb audio effect to an Audio bus.
Simulates the sound of acoustic environments such as rooms, concert halls, caverns, or an open spaces.
Member Functions
----------------
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_damping<class_AudioEffectReverb_get_damping>` **(** **)** const |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_dry<class_AudioEffectReverb_get_dry>` **(** **)** const |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_hpf<class_AudioEffectReverb_get_hpf>` **(** **)** const |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_predelay_feedback<class_AudioEffectReverb_get_predelay_feedback>` **(** **)** const |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_predelay_msec<class_AudioEffectReverb_get_predelay_msec>` **(** **)** const |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_room_size<class_AudioEffectReverb_get_room_size>` **(** **)** const |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_spread<class_AudioEffectReverb_get_spread>` **(** **)** const |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_wet<class_AudioEffectReverb_get_wet>` **(** **)** const |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_damping<class_AudioEffectReverb_set_damping>` **(** :ref:`float<class_float>` amount **)** |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_dry<class_AudioEffectReverb_set_dry>` **(** :ref:`float<class_float>` amount **)** |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_hpf<class_AudioEffectReverb_set_hpf>` **(** :ref:`float<class_float>` amount **)** |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_predelay_feedback<class_AudioEffectReverb_set_predelay_feedback>` **(** :ref:`float<class_float>` feedback **)** |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_predelay_msec<class_AudioEffectReverb_set_predelay_msec>` **(** :ref:`float<class_float>` msec **)** |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_room_size<class_AudioEffectReverb_set_room_size>` **(** :ref:`float<class_float>` size **)** |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_spread<class_AudioEffectReverb_set_spread>` **(** :ref:`float<class_float>` amount **)** |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_wet<class_AudioEffectReverb_set_wet>` **(** :ref:`float<class_float>` amount **)** |
+----------------------------+------------------------------------------------------------------------------------------------------------------------------+
Member Variables
----------------
- :ref:`float<class_float>` **damping** - Widens or narrows the stereo image of the reverb tail. 1 means fully widens. Value can range from 0 to 1. Default value: ``1``.
- :ref:`float<class_float>` **dry** - Output percent of original sound. At 0, only modified sound is outputted. Value can range from 0 to 1. Default value: ``1``.
- :ref:`float<class_float>` **hipass** - 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. Default value: ``0``.
- :ref:`float<class_float>` **predelay_feedback** - Output percent of predelay. Value can range from 0 to 1. Default value: ``1``.
- :ref:`float<class_float>` **predelay_msec** - Time between the original signal and the early reflections of the reverb signal. Default value: ``150ms``.
- :ref:`float<class_float>` **room_size** - Dimensions of simulated room. Bigger means more echoes. Value can range from 0 to 1. Default value: ``0.8``.
- :ref:`float<class_float>` **spread** - Defines how reflective the imaginary room's walls are. Value can range from 0 to 1. Default value: ``1``.
- :ref:`float<class_float>` **wet** - Output percent of modified sound. At 0, only original sound is outputted. Value can range from 0 to 1. Default value: ``0.5``.
Description
-----------
Simulates rooms of different sizes. Its parameters can be adjusted to simulate the sound of a specific room.
Member Function Description
---------------------------
.. _class_AudioEffectReverb_get_damping:
- :ref:`float<class_float>` **get_damping** **(** **)** const
.. _class_AudioEffectReverb_get_dry:
- :ref:`float<class_float>` **get_dry** **(** **)** const
.. _class_AudioEffectReverb_get_hpf:
- :ref:`float<class_float>` **get_hpf** **(** **)** const
.. _class_AudioEffectReverb_get_predelay_feedback:
- :ref:`float<class_float>` **get_predelay_feedback** **(** **)** const
.. _class_AudioEffectReverb_get_predelay_msec:
- :ref:`float<class_float>` **get_predelay_msec** **(** **)** const
.. _class_AudioEffectReverb_get_room_size:
- :ref:`float<class_float>` **get_room_size** **(** **)** const
.. _class_AudioEffectReverb_get_spread:
- :ref:`float<class_float>` **get_spread** **(** **)** const
.. _class_AudioEffectReverb_get_wet:
- :ref:`float<class_float>` **get_wet** **(** **)** const
.. _class_AudioEffectReverb_set_damping:
- void **set_damping** **(** :ref:`float<class_float>` amount **)**
.. _class_AudioEffectReverb_set_dry:
- void **set_dry** **(** :ref:`float<class_float>` amount **)**
.. _class_AudioEffectReverb_set_hpf:
- void **set_hpf** **(** :ref:`float<class_float>` amount **)**
.. _class_AudioEffectReverb_set_predelay_feedback:
- void **set_predelay_feedback** **(** :ref:`float<class_float>` feedback **)**
.. _class_AudioEffectReverb_set_predelay_msec:
- void **set_predelay_msec** **(** :ref:`float<class_float>` msec **)**
.. _class_AudioEffectReverb_set_room_size:
- void **set_room_size** **(** :ref:`float<class_float>` size **)**
.. _class_AudioEffectReverb_set_spread:
- void **set_spread** **(** :ref:`float<class_float>` amount **)**
.. _class_AudioEffectReverb_set_wet:
- void **set_wet** **(** :ref:`float<class_float>` amount **)**