Difference between revisions of "Source:setVolume"

(Added a minor detail, since people might expect it to work differently.)
m (Examples)
 
(One intermediate revision by one other user not shown)
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.
+
     -- Note that this code, as-is, will set the volume to 1.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
 +
    sound:setVolume(1) -- Reset to maximum volume.
 
end
 
end
 
</source>
 
</source>
Line 34: Line 35:
 
end
 
end
 
</source>
 
</source>
 +
 
== See Also ==
 
== See Also ==
 
* [[parent::Source]]
 
* [[parent::Source]]

Latest revision as of 14:26, 31 May 2018

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 1.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
    sound:setVolume(1) -- Reset to maximum volume.
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