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.