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

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。