Difference between revisions of "Source:setVolume"

(Added examples)
(Added a minor detail, since people might expect it to work differently.)
Line 15: Line 15:
 
     sound = love.audio.newSource("sound.wav")
 
     sound = love.audio.newSource("sound.wav")
  
 +
    -- Note that this code, as-is, will set the volume to 0.0, as per the last line, and that's how sound:play() will play it back.
 
     sound:setVolume(0.5) -- 50% volume
 
     sound:setVolume(0.5) -- 50% volume
 
     sound:setVolume(0) -- No sound
 
     sound:setVolume(0) -- No sound

Revision as of 16:44, 3 November 2016

Sets the current volume of the Source.

Function

Synopsis

Source:setVolume( volume )

Arguments

number volume
The volume for a Source, where 1.0 is normal volume. Volume cannot be raised above 1.0.

Returns

Nothing.

Examples

Make a sound quieter or completely silent.

function love.load()
    sound = love.audio.newSource("sound.wav")

    -- Note that this code, as-is, will set the volume to 0.0, as per the last line, and that's how sound:play() will play it back.
    sound:setVolume(0.5) -- 50% volume
    sound:setVolume(0) -- No sound
end

Set different volumes depending on the sound type.

function love.load()
    effect = love.audio.newSource("soundeffect.wav")
    music = love.audio.newSource("music.mp3")

    masterVolume = 0.5 -- Maximum volume for all sounds
    effectVolume = 0.75
    musicVolume = 1

    effect:setVolume(masterVolume * effectVolume)
    music:setVolume(masterVolume * musicVolume)
end

See Also


Other Languages