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.

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.