2017-09-12 20:42:36 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
2023-03-01 00:44:37 +00:00
<class name= "AudioEffectLimiter" inherits= "AudioEffect" version= "4.1" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2017-09-12 20:42:36 +00:00
<brief_description >
2019-06-21 23:04:47 +00:00
Adds a soft-clip limiter audio effect to an Audio bus.
2017-09-12 20:42:36 +00:00
</brief_description>
<description >
2019-06-21 23:04:47 +00:00
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.
2017-09-16 16:47:19 +00:00
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.
2017-09-12 20:42:36 +00:00
</description>
<tutorials >
2022-06-19 23:11:11 +00:00
<link title= "Audio buses" > $DOCS_URL/tutorials/audio/audio_buses.html</link>
2017-09-12 20:42:36 +00:00
</tutorials>
<members >
2019-06-29 10:38:01 +00:00
<member name= "ceiling_db" type= "float" setter= "set_ceiling_db" getter= "get_ceiling_db" default= "-0.1" >
2019-06-29 13:24:23 +00:00
The waveform's maximum allowed value, in decibels. Value can range from -20 to -0.1.
2017-09-12 20:42:36 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "soft_clip_db" type= "float" setter= "set_soft_clip_db" getter= "get_soft_clip_db" default= "2.0" >
2019-06-29 13:24:23 +00:00
Applies a gain to the limited waves, in decibels. Value can range from 0 to 6.
2017-09-12 20:42:36 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "soft_clip_ratio" type= "float" setter= "set_soft_clip_ratio" getter= "get_soft_clip_ratio" default= "10.0" >
2017-09-12 20:42:36 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "threshold_db" type= "float" setter= "set_threshold_db" getter= "get_threshold_db" default= "0.0" >
2019-06-29 13:24:23 +00:00
Threshold from which the limiter begins to be active, in decibels. Value can range from -30 to 0.
2017-09-12 20:42:36 +00:00
</member>
</members>
</class>