Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

AudioEffectDistortion

继承: AudioEffect < Resource < RefCounted < Object

为音频总线添加失真音频效果。

修改声音,使其失真。

描述

可以使用不同的类型:削波、正切、低保真(位破碎)、过载、波形。

通过扭曲波形,频率内容会发生变化,这通常会使声音“清脆”或“粗糙”。对于游戏,它可以非常有效地模拟来自某些饱和设备或扬声器的声音。

教程

属性

float

drive

0.0

float

keep_hf_hz

16000.0

Mode

mode

0

float

post_gain

0.0

float

pre_gain

0.0


枚举

enum Mode:

Mode MODE_CLIP = 0

数字失真效果,可以切断波形顶部和底部的峰值。

Mode MODE_ATAN = 1

Mode MODE_LOFI = 2

低分辨率的数字失真效果(位深度减少)。可以使用它来模拟早期数字音频设备的声音。

Mode MODE_OVERDRIVE = 3

模拟通常用于固态乐器放大器的场效应晶体管产生的暖失真。drive 属性在该模式下无效。

Mode MODE_WAVESHAPE = 4

波形变形失真主要是电子音乐人为了获得格外粗糙的声音而使用的。


属性说明

float drive = 0.0

  • void set_drive ( float value )

  • float get_drive ( )

失真度。值的范围可在 0 到 1 之间。


float keep_hf_hz = 16000.0

  • void set_keep_hf_hz ( float value )

  • float get_keep_hf_hz ( )

高通滤波器,单位为 Hz。高于此值的频率不会受到失真的影响。该值的范围为 1 至 20000。


Mode mode = 0

  • void set_mode ( Mode value )

  • Mode get_mode ( )

失真类型。


float post_gain = 0.0

  • void set_post_gain ( float value )

  • float get_post_gain ( )

在效果后增加或减少的音量,单位为分贝。取值范围从 -80 到 24。


float pre_gain = 0.0

  • void set_pre_gain ( float value )

  • float get_pre_gain ( )

在效果前增加或减少的音量,单位为分贝。取值范围从 -60 到 60。