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

AudioEffectCompressor

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

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

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

Описание

Компрессор уменьшает громкость звуков, когда она превышает определенный пороговый уровень.

Компрессор может иметь множество применений в миксе:

Для сжатия всей громкости на мастер-шине (хотя AudioEffectHardLimiter, вероятно, лучше).
Для обеспечения баланса голосовых аудиоклипов.
Для сайдчейна, используя другую шину в качестве триггера. Это уменьшает громкость шины, к которой он подключен, используя громкость другой аудиошины для определения порогового значения. Этот метод распространен в микшировании видеоигр для уменьшения громкости музыки и звуковых эффектов, когда слышны голоса. Этот эффект также известен как «дакинг».
Для усиления переходных процессов с помощью длительной атаки, позволяя звукам превышать пороговый уровень громкости в течение короткого периода времени перед их сжатием. Это можно использовать для того, чтобы сделать звуковые эффекты более резкими.

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

Свойства

float	attack_us	`20.0`
float	gain	`0.0`
float	mix	`1.0`
float	ratio	`4.0`
float	release_ms	`250.0`
StringName	sidechain	`&""`
float	threshold	`0.0`

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

float attack_us = 20.0 🔗

void set_attack_us(value: float)
float get_attack_us()

Время реакции компрессора при превышении уровня громкости аудиосигнала, в микросекундах. Значение может варьироваться от 20 до 2000.

float gain = 0.0 🔗

void set_gain(value: float)
float get_gain()

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

float mix = 1.0 🔗

void set_mix(value: float)
float get_mix()

Баланс между исходным и сжатым аудиосигналом. Значение может варьироваться от 0 (полностью сухой звук) до 1 (полностью обработанный звук).

float ratio = 4.0 🔗

void set_ratio(value: float)
float get_ratio()

Степень сжатия, применяемая к аудиосигналу после превышения порогового уровня громкости. Чем выше коэффициент, тем сильнее сжатие аудиосигналов, превышающих пороговый уровень громкости. Значение может варьироваться от 1 до 48.

float release_ms = 250.0 🔗

void set_release_ms(value: float)
float get_release_ms()

Задержка компрессора, необходимая для прекращения уменьшения громкости после того, как она упадет ниже порогового уровня, измеряется в миллисекундах. Значение может варьироваться от 20 до 2000.

StringName sidechain = &"" 🔗

void set_sidechain(value: StringName)
StringName get_sidechain()

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

float threshold = 0.0 🔗

void set_threshold(value: float)
float get_threshold()

Уровень громкости, при превышении которого к аудиосигналу применяется компрессия, в дБ. Значение может варьироваться от -60 до 0.