AudioEffectDistortion

继承： AudioEffect < Resource < RefCounted < Object

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

修改声音使其失真。

描述

有不同的类型可供选择：剪辑、棕褐色、lo-fi（钻头粉碎）、超速驱动或波形。

通过扭曲波形，频率内容会发生变化，这通常会使声音“嘎吱嘎吱”或“粗糙”。对于应用来说，它可以非常有效地模拟来自饱和设备或扬声器的声音。

属性

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(value: float)

• float get_drive()

失真能力。值的范围可以从0到1。

---

float keep_hf_hz = 16000.0 🔗

• void set_keep_hf_hz(value: float)

• float get_keep_hf_hz()

高通滤波器，以Hz为单位。高于此值的频率将不受失真的影响。值的范围可以从1到20000。

---

Mode mode = 0 🔗

• void set_mode(value: Mode)

• Mode get_mode()

失真类型。

---

float post_gain = 0.0 🔗

• void set_post_gain(value: float)

• float get_post_gain()

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

---

float pre_gain = 0.0 🔗

• void set_pre_gain(value: float)

• float get_pre_gain()

增加或减少效果前的音量，以分贝为单位。值可以在-60到60之间。