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

AudioEffectHardLimiter

继承： AudioEffect < Resource < RefCounted < Object

为音频总线添加一个硬限制器音频效果。

描述

限制器是一种旨在阻止声音超过给定dB阈值的效果。硬限幅器预测音量峰值，并将在峰值超过上限阈值时平滑地应用增益降低，以防止削波和失真。它保留了波形并防止其越过上限阈值。建议在主总线中添加一个作为安全措施，以防止出现突然的音量峰值，并防止由削波引起的失真。

教程

属性

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

默认值为 -0.3，可防止潜在的采样间峰值（ISP）跨越 0 dB，这种情况可能会在一些较旧的硬件上造成轻微失真。

float pre_gain_db = 0.0 🔗

  • void set_pre_gain_db(value: float)

  • float get_pre_gain_db()

限制前应用的增益，单位为分贝。

float release = 0.1 🔗

  • void set_release(value: float)

  • float get_release()

增益降低完全释放所需的时间（以秒为单位）。