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.

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.