plucky (3) al_play_audio_stream_f.3alleg5.gz

Provided by: allegro5-doc_5.2.10.1+dfsg-1_all bug

NAME

       al_play_audio_stream_f - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_audio.h>

              ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident)

DESCRIPTION

       Loads  and  plays  an audio file from ALLEGRO_FILE(3alleg5) stream, streaming 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(3alleg5), but can also be done via al_set_default_mixer(3alleg5).

       The file type is determined by the passed `ident' parameter, which is a file name extension including the
       leading dot.

       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.  On success the file should be considered owned by
       the audio stream, and will be closed when the audio stream is destroyed.  On failure  the  file  will  be
       closed.

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

SEE ALSO

       al_play_audio_stream(3alleg5), al_load_audio_stream_f(3alleg5)

SINCE

       5.2.8

              [Unstable API]: New API.