AudioEffectCompressor

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

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

Уменьшает звуки, превышающие определенный пороговый уровень, сглаживает динамику и увеличивает общую громкость.

Описание

Компрессор динамического диапазона снижает уровень звука, когда амплитуда превышает определённый порог в децибелах. Одно из основных применений компрессора — расширение динамического диапазона путём минимального ограничения (когда звук превышает 0 дБ).

Компрессор используется в миксе по-разному:

На мастер-шине для компрессии всего выходного сигнала (хотя 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()

Усиление, применяемое к выходному сигналу.

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.