AudioEffectDistortion
Добавляет эффект искажения звука к аудиошине. Переназначает аудиосэмплы с помощью нелинейной функции для получения искаженного звука.
Добавляет эффект искажения звука к аудиошине. Переназначает аудиосэмплы с помощью нелинейной функции для получения искаженного звука.
Эффект «искажения» изменяет форму волны с помощью нелинейной математической функции (см. доступные в AudioEffectDistortion.ModeEnum), основанной на амплитуде сэмплов формы волны.
Примечание: В нелинейной функции амплитуда входного сэмпла со значением x будет либо увеличена, либо уменьшена до значения y в зависимости от значения функции в x, поэтому даже при одном и том же AudioEffectDistortion.Drive выходной звук будет меняться в зависимости от громкости входного сигнала. Чтобы изменить громкость, сохраняя при этом форму выходной волны, используйте AudioEffectDistortion.PostGain.
В этом эффекте каждый тип представляет собой различную нелинейную функцию. Доступны следующие типы: clip, atan, lofi (bitcrush), overdrive и waveshape. Каждый доступный здесь тип искажения симметричен: отрицательные значения амплитуды изменяются так же, как и положительные.
Хотя искажение всегда изменяет частотный состав, обычно за счет введения высоких гармоник, различные типы искажения предлагают широкий диапазон качества звука; от «мягкого» и «теплого» до «хрустящего» и «резкого».
В играх это может помочь очень эффективно имитировать звук, исходящий от какого-либо насыщенного устройства или динамика. Это также может помочь выделить звук в миксе, добавив более высокие частоты и увеличив громкость.
Примечание: Хотя обычно это незаметно, включенный эффект искажения все равно меняет звук, даже если AudioEffectDistortion.Drive установлено на 0. Это не ошибка. Если такое поведение нежелательно, рассмотрите возможность отключения эффекта с помощью AudioServer.SetBusEffectEnabled.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Конструкторы1
AudioEffectDistortionКонструктор
public AudioEffectDistortion();Свойства5
DriveСвойство
public float Drive { get; set; }Интенсивность искажений. Регулирует степень влияния кривой искажений на входной аудиосигнал, переходя от линейной функции к нелинейной. Значение может варьироваться от 0 до 1.
KeepHfHzСвойство
public float KeepHfHz { get; set; }Фильтр высоких частот, в Гц. Частоты выше этого значения не будут подвержены искажением. Значение может варьироваться от 1 до 20000.
ModeСвойство
public AudioEffectDistortion.ModeEnum Mode { get; set; }Тип искажения. Изменяет нелинейную функцию, используемую для искажения формы сигнала. См. AudioEffectDistortion.ModeEnum.
PostGainСвойство
public float PostGain { get; set; }Усиление после эффекта, в дБ. Значение может варьироваться от -80 до 24.
PreGainСвойство
public float PreGain { get; set; }Усиление до наступления эффекта, в дБ. Значение может варьироваться от -60 до 60.
Методы10
GetDrivefloat
public float GetDrive();floatGetKeepHfHzfloat
public float GetKeepHfHz();floatGetModeAudioEffectDistortion.ModeEnum
public AudioEffectDistortion.ModeEnum GetMode();AudioEffectDistortion.ModeEnumGetPostGainfloat
public float GetPostGain();floatGetPreGainfloat
public float GetPreGain();floatSetDrivevoid
public void SetDrive(float drive);| Имя | Тип | По умолчанию |
|---|---|---|
drive | float | — |
SetKeepHfHzvoid
public void SetKeepHfHz(float keepHfHz);| Имя | Тип | По умолчанию |
|---|---|---|
keepHfHz | float | — |
SetModevoid
public void SetMode(AudioEffectDistortion.ModeEnum mode);| Имя | Тип | По умолчанию |
|---|---|---|
mode | AudioEffectDistortion.ModeEnum | — |
SetPostGainvoid
public void SetPostGain(float postGain);| Имя | Тип | По умолчанию |
|---|---|---|
postGain | float | — |
SetPreGainvoid
public void SetPreGain(float preGain);| Имя | Тип | По умолчанию |
|---|---|---|
preGain | float | — |
AudioEffectDistortion.ModeEnum
| Значение | Описание |
|---|---|
Atan = 1 | Плавно выравнивает форму волны, следуя кривой арктангенса. Громкость звука уменьшается, а затем пики выравниваются до |
Clip = 0 | Резко выравнивает форму волны на уровне 0 дБ. |
Lofi = 2 | Уменьшает битовую глубину звука для получения аудиосигнала с низким разрешением, переходя от 16-битного к 2-битному. Может использоваться для эмуляции звучания ранних цифровых аудиоустройств. |
Overdrive = 3 | Имитирует тёплые искажения, создаваемые полевым транзистором, который обычно используется в твердотельных усилителях для музыкальных инструментов. |
Waveshape = 4 | Сглаживает форму волны до тех пор, пока не достигнет резкого пика при |