love.audio.setEffect (Français)

Disponible depuis LÖVE 11.0
Ce-tte function n'est pas supporté-e par des versions plus anciennes.

Définit un effet pouvant être appliqué à une Source.

Tous les systèmes ne supportent pas les effets audio. Utiliser love.audio.isEffectsSupported pour vérifier.

Fonction

Synopsis

love.audio.setEffect(name, settings)

Arguments

string (Français) name
Le nom de l'effect.
table (Français) settings
Les réglages à utiliser pour cet effet, avec les champs suivants :
EffectType (Français) type
Le type d'effet à utiliser.
number (Français) volume
Le volume de l'effet.
number (Français) ...
Réglages spécifiques à l'effet. Voir EffectType pour les effets disponibles et leurs réglages correspondants.

Retourne

boolean (Français) success
Est-ce que l'effet à été créé avec succès.

Fonction

Synopsis

love.audio.setEffect(name, enabled)

Arguments

string (Français) name
Le nom de l'effet.
boolean (Français) enabled (true)
Si false et que le nom d'effet donné était déjà réglé, désactive l'effet.

Retourne

boolean (Français) success
Est-ce que l'effet à été désactivé avec succès.

Exe1mples

Jouer de la musique avec l'ajout de reverbération

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

Jouer une musique avec de la distorsion

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

See Also


Autres langues