Source:setEffect

Available since LÖVE 11.0

This function is not supported in earlier versions.

Applies an audio effect to the Source.

The effect must have been previously defined using love.audio.setEffect.

Function

Applies the given previously defined effect to this Source.

success = Source:setEffect( name, enable )

string name: The name of the effect previously set up with love.audio.setEffect.
boolean enable (true): If false and the given effect name was previously enabled on this Source, disables the effect.

boolean success: Whether the effect was successfully applied to this Source.

Applies the given previously defined effect to this Source, and applies a filter to the Source which affects the sound fed into the effect.

success = Source:setEffect( name, filtersettings )

string name

The name of the effect previously set up with love.audio.setEffect.

table filtersettings

The filter settings to apply prior to the effect, with the following fields:

FilterType type: The type of filter to use.
number volume: The overall audio input volume for the effect. Must be between 0 and 1. (Does not affect the dry audio output for the source.)
number highgain: Volume of high-frequency audio. Only applies to lowpass and bandpass filters. Must be between 0 and 1.
number lowgain: Volume of low-frequency audio. Only applies to highpass and bandpass filters. Must be between 0 and 1.

boolean success: Whether the effect and filter were successfully applied to this Source.

Audio effect functionality is not supported on iOS.