NAME

SYNOPSIS

DESCRIPTION

The argument form where a gain is supplied will override any global gain settings on the output device through WORLDID .

If a callback is provided, it will be triggered as soon as the underlying audio stack tells us that playback of the sample has finished. This is intended as a way of sequencing playback samples together.

Multiple playbacks of the same samples can be running at the same time, limited by the mixing capabilities of the underlying driver stack as well as a compile-time engine limit (32 by default).

If a sample fails to queue or mix properly, the function will return false.

EXAMPLE

function play_audio0()
      local aid = load_asample("test.wav");
      play_audio(aid, 0.5);
      play_audio(aid, function() print("done"); end)
end

MISUSE

function play_audio0()
      play_audio(fill_surface(32, 32, 0, 0, 0), 0.5);
end

SEE ALSO: