AudioEffectDistortion

Наследует: AudioEffect < Resource < RefCounted < Object

Добавляет эффект искажения звука к аудио-шине.

Изменяет звук, делая его искаженным.

Описание

Доступны различные типы: clip, tan, lo-fi (bit crushing), 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

Искажения Waveshaper используются в основном электронными музыкантами для достижения сверхрезкого звука.

Описания свойств

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

Фильтр высоких частот, в Гц. Частоты выше этого значения не будут подвержены искажением. Значение может варьироваться от 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.