AudioEffectDistortion

繼承： AudioEffect < Resource < RefCounted < Object

為音訊匯流排新增失真效果。

改變聲波形以產生失真。

說明

可選類型：削頂、正切、Lo-Fi（比特破碎）、Overdrive、Waveshape。

失真會改變波形與頻譜，常帶來「破裂」或「粗糙」質感；在遊戲中能高效模擬設備或喇叭飽和的聲音。

教學

• 音訊匯流排

屬性

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

There is currently no description for this enum. Please help us by contributing one!

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()

效果後增減的音量（dB），可設 -80 至 24。

---

float pre_gain = 0.0 🔗

• void set_pre_gain(value: float)

• float get_pre_gain()

效果前增減的音量（dB），可設 -60 至 60。