class_audioeffectlimiter.rst 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the AudioEffectLimiter.xml source instead.
  3. .. The source is found in doc/classes or modules/<name>/doc_classes.
  4. .. _class_AudioEffectLimiter:
  5. AudioEffectLimiter
  6. ==================
  7. **Inherits:** :ref:`AudioEffect<class_audioeffect>` **<** :ref:`Resource<class_resource>` **<** :ref:`Reference<class_reference>` **<** :ref:`Object<class_object>`
  8. **Category:** Core
  9. Brief Description
  10. -----------------
  11. Adds a soft clip Limiter audio effect to an Audio bus.
  12. Member Functions
  13. ----------------
  14. +----------------------------+----------------------------------------------------------------------------------------------------------------------------+
  15. | :ref:`float<class_float>` | :ref:`get_ceiling_db<class_AudioEffectLimiter_get_ceiling_db>` **(** **)** const |
  16. +----------------------------+----------------------------------------------------------------------------------------------------------------------------+
  17. | :ref:`float<class_float>` | :ref:`get_soft_clip_db<class_AudioEffectLimiter_get_soft_clip_db>` **(** **)** const |
  18. +----------------------------+----------------------------------------------------------------------------------------------------------------------------+
  19. | :ref:`float<class_float>` | :ref:`get_soft_clip_ratio<class_AudioEffectLimiter_get_soft_clip_ratio>` **(** **)** const |
  20. +----------------------------+----------------------------------------------------------------------------------------------------------------------------+
  21. | :ref:`float<class_float>` | :ref:`get_threshold_db<class_AudioEffectLimiter_get_threshold_db>` **(** **)** const |
  22. +----------------------------+----------------------------------------------------------------------------------------------------------------------------+
  23. | void | :ref:`set_ceiling_db<class_AudioEffectLimiter_set_ceiling_db>` **(** :ref:`float<class_float>` ceiling **)** |
  24. +----------------------------+----------------------------------------------------------------------------------------------------------------------------+
  25. | void | :ref:`set_soft_clip_db<class_AudioEffectLimiter_set_soft_clip_db>` **(** :ref:`float<class_float>` soft_clip **)** |
  26. +----------------------------+----------------------------------------------------------------------------------------------------------------------------+
  27. | void | :ref:`set_soft_clip_ratio<class_AudioEffectLimiter_set_soft_clip_ratio>` **(** :ref:`float<class_float>` soft_clip **)** |
  28. +----------------------------+----------------------------------------------------------------------------------------------------------------------------+
  29. | void | :ref:`set_threshold_db<class_AudioEffectLimiter_set_threshold_db>` **(** :ref:`float<class_float>` threshold **)** |
  30. +----------------------------+----------------------------------------------------------------------------------------------------------------------------+
  31. Member Variables
  32. ----------------
  33. - :ref:`float<class_float>` **ceiling_db** - The waveform's maximum allowed value. Value can range from -20 to -0.1. Default value: [code]-0.1dB[/code].
  34. - :ref:`float<class_float>` **soft_clip_db** - Applies a gain to the limited waves. Value can range from 0 to 6. Default value: [code]2dB[/code].
  35. - :ref:`float<class_float>` **soft_clip_ratio**
  36. - :ref:`float<class_float>` **threshold_db** - Threshold from which the limiter begins to be active. Value can range from -30 to 0. Default value: [code]0dB[/code].
  37. Description
  38. -----------
  39. A limiter is similar to a compressor, but it’s less flexible and designed to disallow sound going over a given dB threshold. Adding one in the Master Bus is always recommended to reduce the effects of clipping.
  40. Soft clipping starts to reduce the peaks a little below the threshold level and progressively increases its effect as the input level increases such that the threshold is never exceeded.
  41. Member Function Description
  42. ---------------------------
  43. .. _class_AudioEffectLimiter_get_ceiling_db:
  44. - :ref:`float<class_float>` **get_ceiling_db** **(** **)** const
  45. .. _class_AudioEffectLimiter_get_soft_clip_db:
  46. - :ref:`float<class_float>` **get_soft_clip_db** **(** **)** const
  47. .. _class_AudioEffectLimiter_get_soft_clip_ratio:
  48. - :ref:`float<class_float>` **get_soft_clip_ratio** **(** **)** const
  49. .. _class_AudioEffectLimiter_get_threshold_db:
  50. - :ref:`float<class_float>` **get_threshold_db** **(** **)** const
  51. .. _class_AudioEffectLimiter_set_ceiling_db:
  52. - void **set_ceiling_db** **(** :ref:`float<class_float>` ceiling **)**
  53. .. _class_AudioEffectLimiter_set_soft_clip_db:
  54. - void **set_soft_clip_db** **(** :ref:`float<class_float>` soft_clip **)**
  55. .. _class_AudioEffectLimiter_set_soft_clip_ratio:
  56. - void **set_soft_clip_ratio** **(** :ref:`float<class_float>` soft_clip **)**
  57. .. _class_AudioEffectLimiter_set_threshold_db:
  58. - void **set_threshold_db** **(** :ref:`float<class_float>` threshold **)**