class_audioeffectlimiter.rst 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546
  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 Variables
  13. ----------------
  14. .. _class_AudioEffectLimiter_ceiling_db:
  15. - :ref:`float<class_float>` **ceiling_db** - The waveform's maximum allowed value. Value can range from -20 to -0.1. Default value: ``-0.1dB``.
  16. .. _class_AudioEffectLimiter_soft_clip_db:
  17. - :ref:`float<class_float>` **soft_clip_db** - Applies a gain to the limited waves. Value can range from 0 to 6. Default value: ``2dB``.
  18. .. _class_AudioEffectLimiter_soft_clip_ratio:
  19. - :ref:`float<class_float>` **soft_clip_ratio**
  20. .. _class_AudioEffectLimiter_threshold_db:
  21. - :ref:`float<class_float>` **threshold_db** - Threshold from which the limiter begins to be active. Value can range from -30 to 0. Default value: ``0dB``.
  22. Description
  23. -----------
  24. 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.
  25. 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.