plucky (3) al_load_audio_stream_f.3alleg5.gz

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

NAME

       al_load_audio_stream_f - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_audio.h>

              ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char *ident,
                 size_t buffer_count, unsigned int samples)

DESCRIPTION

       Loads an audio file from ALLEGRO_FILE(3alleg5) stream as it is needed.

       Unlike  regular  streams, the one returned by this function need not be fed by the user; the library will
       automatically read more of the file as it is needed.  The stream will contain buffer_count  buffers  with
       samples samples.

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

       The audio stream will start in the playing state.  It should be attached to a voice or mixer to  generate
       any output.  See ALLEGRO_AUDIO_STREAM(3alleg5) for more details.

       Returns  the  stream  on success, NULL on failure.  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_load_audio_stream(3alleg5), al_register_audio_stream_loader_f(3alleg5), al_init_acodec_addon(3alleg5)