love.audio.setEffect

Доступно начиная с LÖVE 11.0
Эта функция не поддерживается в более ранних версиях.

Определяет эффект, который можно применить к источнику.

Не все системы поддерживают аудиоэффекты. Используйте love.audio.isEffectsSupported для проверки.

Функция

Синопсис

love.audio.setEffect(name, settings)

Аргументы

string name

Название эффекта.

table settings

Настройки для этого эффекта, со следующими полями:

EffectType type

Тип используемого эффекта.

number volume

Громкость эффекта.

number ...

Настройки, специфичные для эффекта. См. EffectType для доступных эффектов и соответствующих настроек.

Возвращаемые значения

boolean success

Успешность создания эффекта.

Функция

Синопсис

love.audio.setEffect(name, enabled)

Аргументы

string name

Название эффекта.

boolean enabled (true)

Если false и заданное имя эффекта было ранее установлено, отключает эффект.

Возвращаемые значения

boolean success

Успешность отключения эффекта.

Примеры

Воспроизведение музыки с добавлением реверберации

love.audio.setEffect('myEffect', {type = 'reverb'})
local source = love.audio.newSource('music.ogg', 'stream')
source:setEffect('myEffect')
source:play()

Воспроизведение музыки с искажением

love.audio.setEffect('myEffect', {
	type = 'distortion',
	gain = .5,
	edge = .25,
})
local source = love.audio.newSource('music.ogg', 'stream')
source:setEffect('myEffect')
source:play()

См. также

• love.audio
• love.audio.isEffectsSupported
• Source:setEffect