love.audio.newSource

Creates a new Source from a filepath, File, Decoder or SoundData. Sources created from SoundData are always static.

This function can be slow if it is called repeatedly, such as from love.update or love.draw. If you need to use a specific resource often, create it once and store it somewhere it can be reused!

The WAV decoder is buggy and as a result may append seconds of silence to loaded sounds. You should convert sounds files to Ogg Vorbis or another supported format.

Function

Synopsis

source = love.audio.newSource( filename, type )

Arguments

string filename

The filepath to the audio file.

SourceType type ("stream")

Streaming or static source.

Returns

Source source

A new Source that can play the specified audio.

Function

Synopsis

source = love.audio.newSource( file, type )

Arguments

File file

A File pointing to an audio file.

SourceType type ("stream")

Streaming or static source.

Returns

Source source

A new Source that can play the specified audio.

Function

Synopsis

source = love.audio.newSource( decoder, type )

Arguments

Decoder decoder

The Decoder to create a Source from.

SourceType type ("stream")

Streaming or static source.

Returns

Source source

A new Source that can play the specified audio.

Function

Synopsis

source = love.audio.newSource( data )

Arguments

SoundData data

The SoundData to create a Source from.

Returns

Source source

A new Source that can play the specified audio. The SourceType of the returned audio is "static".

Examples

Load background music and play it

bgm = love.audio.newSource("bgm.ogg", "stream")
love.audio.play(bgm)

Load a sound effect and play it

sfx = love.audio.newSource("sfx.wav", "static")
love.audio.play(sfx)

Load SoundData and create a Source

data = love.sound.newSoundData("sfx.wav")
sfx = love.audio.newSource(data)

Load Decoder and create a Source

decoder = love.sound.newDecoder("bgm.ogg")
bgm = love.audio.newSource(decoder)

See Also

• love.audio
• Source

Other Languages

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info