Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

AudioEffectHardLimiter

Наследует: AudioEffect < Resource < RefCounted < Object

Добавляет эффект ограничения громкости к аудиошине.

Предотвращает превышение аудиосигналом заданного уровня громкости.

Описание

«Ограничитель» не позволяет аудиосигналам превышать заданный пороговый уровень громкости в дБ. Жесткие ограничители прогнозируют пиковые значения громкости и плавно снижают усиление, когда пиковое значение превышает пороговый уровень, чтобы предотвратить клиппинг. Он сохраняет форму сигнала и предотвращает его превышение порогового уровня. Рекомендуется добавить его на мастер-шину в качестве меры безопасности, чтобы предотвратить внезапные пиковые значения громкости и искажения, вызванные клиппингом, когда громкость превышает 0 дБ.

Если клиппинг желателен, рассмотрите AudioEffectDistortion.MODE_CLIP.

Обучающие материалы

Свойства

float	ceiling_db	`-0.3`
float	pre_gain_db	`0.0`
float	release	`0.1`

Описания свойств

float ceiling_db = -0.3 🔗

void set_ceiling_db(value: float)
float get_ceiling_db()

Максимально допустимое значение формы сигнала в дБ. Это значение может варьироваться от -24 до 0.

Значение по умолчанию -0,3 предотвращает пересечение потенциальных межвыборочных пиков (ISP) 0 дБ, что может вызвать небольшие искажения на некоторых старых устройствах.

float pre_gain_db = 0.0 🔗

void set_pre_gain_db(value: float)
float get_pre_gain_db()

Коэффициент усиления до ограничения, в дБ. Значение может варьироваться от -24 до 24.

float release = 0.1 🔗

void set_release(value: float)
float get_release()

Время в секундах, необходимое для полного снятия снижения усиления. Значение может варьироваться от 0,01 до 3.