home | help
al_play_audio_stream(3)     Library Functions Manual	 al_play_audio_stream(3)

NAME
     al_play_audio_stream - Allegro 5 API

SYNOPSIS
	    #include <allegro5/allegro_audio.h>

	    ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename)

DESCRIPTION
     Loads  and  plays an audio file, streaming from disk as it is needed.  This
     API can only play one audio stream at a  time.   This  requires  a  default
     mixer to be set, which is typically done via al_reserve_samples(3), but can
     also be done via al_set_default_mixer(3).

     Returns  the  stream on success, NULL on failure.	You must not destroy the
     returned stream, it will be automatically destroyed when the addon is  shut
     down.

	    Note: the allegro_audio library does not support any audio file for-
	    mats by default.  You must use the allegro_acodec addon, or register
	    your own format handler.

SEE ALSO
     al_play_audio_stream_f(3), al_load_audio_stream(3)

SINCE
     5.2.8

	    [Unstable API]: New API.

Allegro reference manual				 al_play_audio_stream(3)

home | help