play_audio_stream(3)

NAME
play_audio_stream

SYNOPSIS
#include <allegro.h>

AUDIOSTREAM *play_audio_stream(int len, bits, stereo, freq, vol, pan);

DESCRIPTION
This function creates a new audio stream and starts it playing. The length is the size of each transfer buffer (in samples), which should normally be a power of two somewhere around 1k in size: larger buffers are more efficient and require fewer updates, but result in more latency between you providing the data and it actually being played. The bits parameter must be 8 or 16, freq is the sample rate of the data, and the vol and pan values use the same 0-255 ranges as the regular sample playing functions. If you want to adjust the pitch, volume, or panning of a stream once it is playing, you can use the regular voice_*() functions with stream->voice as a parameter. The sample data is always in unsigned format, with stereo waveforms consisting of alternate left/right samples.

SEE ALSO
install_sound(3), get_audio_stream_buffer(3), stop_audio_stream(3)