{{newin|[[0.9.0]]|090|type=function}}
Sets whether the [[Source]]'s position, velocity, direction, and cone angles are relative to the listener, or absolute.

By default, all sources are absolute and therefore relative to the origin of love's coordinate system [0, 0, 0]. Only absolute sources are affected by the position of the listener. Please note that positional audio only works for mono (i.e. non-stereo) sources. 
== Function ==
=== Synopsis ===
<source lang="lua">
Source:setRelative( enable )
</source>
=== Arguments ===
{{param|boolean|enable ("false")|True to make the position, velocity, direction and cone angles relative to the listener, false to make them absolute.}}
=== Returns ===
Nothing.
=== Absolute Source Demonstration ===
This example demonstrates how an absolute source is affected by the position of the listener.
<source lang="lua">
local x, y, z = 0, 0, 0;
local snd;
local relative;

function love.load()
    snd = love.audio.newSource('beep.wav', 'static')
    snd:setLooping(true);
    snd:play();

    -- By default the sound is not relative.
    relative = snd:isRelative();
end

function love.keypressed(key)
    -- Move the listener via WASD.
    if key == 'a' then
        x = x - 1;
    elseif key == 'd' then
        x = x + 1;
    elseif key == 'w' then
        y = y - 1;
    elseif key == 's' then
        y = y + 1;
    end
    love.audio.setPosition(x, y, z);

    -- Toggle between a relative and absolute source.
    if key == 'r' then
        relative = snd:isRelative();
        snd:setRelative(not relative);
    end
end

function love.draw()
    love.graphics.print('Relative: ' .. tostring(relative), 20, 20);
    love.graphics.print('Listener: (x = ' .. x .. ', y = ' .. y .. ')', 20, 40);
end
</source>
== See Also ==
* [[parent::Source]]
* [[Source:isRelative]]
[[Category:Functions]]
{{#set:Description=Sets whether the Source's position and direction are relative to the listener.}}
== Other Languages ==
{{i18n|Source:setRelative}}