reckfellENGINE

AudioEffectDistortion

Добавляет эффект искажения звука к аудиошине. Переназначает аудиосэмплы с помощью нелинейной функции для получения искаженного звука.

На этой странице
class AudioEffectDistortionReckfellSharpНаследует AudioEffect

Добавляет эффект искажения звука к аудиошине. Переназначает аудиосэмплы с помощью нелинейной функции для получения искаженного звука.

Эффект «искажения» изменяет форму волны с помощью нелинейной математической функции (см. доступные в 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Конструктор
# AudioEffectDistortion
C#
public AudioEffectDistortion();

Свойства5

DriveСвойство
# Drive
C#
public float Drive { get; set; }

Интенсивность искажений. Регулирует степень влияния кривой искажений на входной аудиосигнал, переходя от линейной функции к нелинейной. Значение может варьироваться от 0 до 1.

KeepHfHzСвойство
# KeepHfHz
C#
public float KeepHfHz { get; set; }

Фильтр высоких частот, в Гц. Частоты выше этого значения не будут подвержены искажением. Значение может варьироваться от 1 до 20000.

ModeСвойство
# Mode
C#
public AudioEffectDistortion.ModeEnum Mode { get; set; }

Тип искажения. Изменяет нелинейную функцию, используемую для искажения формы сигнала. См. AudioEffectDistortion.ModeEnum.

PostGainСвойство
# PostGain
C#
public float PostGain { get; set; }

Усиление после эффекта, в дБ. Значение может варьироваться от -80 до 24.

PreGainСвойство
# PreGain
C#
public float PreGain { get; set; }

Усиление до наступления эффекта, в дБ. Значение может варьироваться от -60 до 60.

Методы10

GetDrivefloat
# GetDrive
C#
public float GetDrive();
Возвращает float
GetKeepHfHzfloat
# GetKeepHfHz
C#
public float GetKeepHfHz();
Возвращает float
GetModeAudioEffectDistortion.ModeEnum
# GetMode
C#
public AudioEffectDistortion.ModeEnum GetMode();
Возвращает AudioEffectDistortion.ModeEnum
GetPostGainfloat
# GetPostGain
C#
public float GetPostGain();
Возвращает float
GetPreGainfloat
# GetPreGain
C#
public float GetPreGain();
Возвращает float
SetDrivevoid
# SetDrive
C#
public void SetDrive(float drive);
Параметры
ИмяТипПо умолчанию
drivefloat—
SetKeepHfHzvoid
# SetKeepHfHz
C#
public void SetKeepHfHz(float keepHfHz);
Параметры
ИмяТипПо умолчанию
keepHfHzfloat—
SetModevoid
# SetMode
C#
public void SetMode(AudioEffectDistortion.ModeEnum mode);
Параметры
ИмяТипПо умолчанию
modeAudioEffectDistortion.ModeEnum—
SetPostGainvoid
# SetPostGain
C#
public void SetPostGain(float postGain);
Параметры
ИмяТипПо умолчанию
postGainfloat—
SetPreGainvoid
# SetPreGain
C#
public void SetPreGain(float preGain);
Параметры
ИмяТипПо умолчанию
preGainfloat—

AudioEffectDistortion.ModeEnum

ЗначениеОписание
Atan = 1

Плавно выравнивает форму волны, следуя кривой арктангенса. Громкость звука уменьшается, а затем пики выравниваются до PI * 4.0 (линейное значение), если они были нормализованы заранее.

Clip = 0

Резко выравнивает форму волны на уровне 0 дБ. AudioEffectDistortion.Drive экспоненциально увеличивает амплитуду сэмплов. Этот режим работает как жесткий клиппер, если AudioEffectDistortion.Drive установлено на 0, и является единственным режимом, который обрезает аудиосигналы на уровне 0 дБ.

Lofi = 2

Уменьшает битовую глубину звука для получения аудиосигнала с низким разрешением, переходя от 16-битного к 2-битному. Может использоваться для эмуляции звучания ранних цифровых аудиоустройств.

Overdrive = 3

Имитирует тёплые искажения, создаваемые полевым транзистором, который обычно используется в твердотельных усилителях для музыкальных инструментов. AudioEffectDistortion.Drive не оказывает никакого эффекта в этом режиме.

Waveshape = 4

Сглаживает форму волны до тех пор, пока не достигнет резкого пика при drive = 1, следуя общей абсолютной сигмоидной функции.

Документация Reckfell EngineНаверх ↑
БЫСТРЫЙ ПЕРЕХОДНачало работыEntity и иерархияC# & .NET 10Сцены и префабы
Руководства и полный API Reckfell K
reckfellENGINE
RECKFELL ACCOUNT

Вход в аккаунт

Войдите в аккаунт Reckfell.

Один аккаунт для всей платформы Reckfell.