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...

AudioEffectLimiter

Устарело: Use AudioEffectHardLimiter instead.

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

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

Описание

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

Мягкое ограничение начинает уменьшать пики немного ниже порогового уровня громкости и постепенно усиливает свой эффект по мере увеличения входной громкости, так что пороговый уровень никогда не будет превышен.

Если требуется жесткое ограничение сигнала, рассмотрите AudioEffectDistortion.MODE_CLIP.

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

Свойства

float	ceiling_db	`-0.1`
float	soft_clip_db	`2.0`
float	soft_clip_ratio	`10.0`
float	threshold_db	`0.0`

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

float ceiling_db = -0.1 🔗

void set_ceiling_db(value: float)
float get_ceiling_db()

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

float soft_clip_db = 2.0 🔗

void set_soft_clip_db(value: float)
float get_soft_clip_db()

Изменяет громкость ограниченных волн в дБ. Значение может варьироваться от 0 до 6.

float soft_clip_ratio = 10.0 🔗

void set_soft_clip_ratio(value: float)
float get_soft_clip_ratio()

Это свойство не влияет на звук. Используйте AudioEffectHardLimiter вместо него, поскольку этот эффект лимитера устарел.

float threshold_db = 0.0 🔗

void set_threshold_db(value: float)
float get_threshold_db()

Уровень громкости, с которого начинает работать ограничитель, в дБ. Значение может варьироваться от -30 до 0.