AudioEffectLimiter.xml 2.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <class name="AudioEffectLimiter" inherits="AudioEffect" category="Core" version="3.0.alpha.custom_build">
  3. <brief_description>
  4. Adds a soft clip Limiter audio effect to an Audio bus.
  5. </brief_description>
  6. <description>
  7. 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.
  8. 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.
  9. </description>
  10. <tutorials>
  11. </tutorials>
  12. <demos>
  13. </demos>
  14. <methods>
  15. <method name="get_ceiling_db" qualifiers="const">
  16. <return type="float">
  17. </return>
  18. <description>
  19. </description>
  20. </method>
  21. <method name="get_soft_clip_db" qualifiers="const">
  22. <return type="float">
  23. </return>
  24. <description>
  25. </description>
  26. </method>
  27. <method name="get_soft_clip_ratio" qualifiers="const">
  28. <return type="float">
  29. </return>
  30. <description>
  31. </description>
  32. </method>
  33. <method name="get_threshold_db" qualifiers="const">
  34. <return type="float">
  35. </return>
  36. <description>
  37. </description>
  38. </method>
  39. <method name="set_ceiling_db">
  40. <return type="void">
  41. </return>
  42. <argument index="0" name="ceiling" type="float">
  43. </argument>
  44. <description>
  45. </description>
  46. </method>
  47. <method name="set_soft_clip_db">
  48. <return type="void">
  49. </return>
  50. <argument index="0" name="soft_clip" type="float">
  51. </argument>
  52. <description>
  53. </description>
  54. </method>
  55. <method name="set_soft_clip_ratio">
  56. <return type="void">
  57. </return>
  58. <argument index="0" name="soft_clip" type="float">
  59. </argument>
  60. <description>
  61. </description>
  62. </method>
  63. <method name="set_threshold_db">
  64. <return type="void">
  65. </return>
  66. <argument index="0" name="threshold" type="float">
  67. </argument>
  68. <description>
  69. </description>
  70. </method>
  71. </methods>
  72. <members>
  73. <member name="ceiling_db" type="float" setter="set_ceiling_db" getter="get_ceiling_db">
  74. The waveform's maximum allowed value. Value can range from -20 to -0.1. Default value: [code]-0.1dB[/code].
  75. </member>
  76. <member name="soft_clip_db" type="float" setter="set_soft_clip_db" getter="get_soft_clip_db">
  77. Applies a gain to the limited waves. Value can range from 0 to 6. Default value: [code]2dB[/code].
  78. </member>
  79. <member name="soft_clip_ratio" type="float" setter="set_soft_clip_ratio" getter="get_soft_clip_ratio">
  80. </member>
  81. <member name="threshold_db" type="float" setter="set_threshold_db" getter="get_threshold_db">
  82. Threshold from which the limiter begins to be active. Value can range from -30 to 0. Default value: [code]0dB[/code].
  83. </member>
  84. </members>
  85. <constants>
  86. </constants>
  87. </class>