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 (but doesn't have to) 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 in Hertz. The vol and pan values use the same 0-255 ranges as the regular sample playing functions. The stereo parameter should be set to 1 for stereo streams, or 0 otherwise. 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 alternating left/right samples, left sample first.

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