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

NAME

       al_load_sample_f - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_audio.h>

              ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident)

DESCRIPTION

       Loads  an audio file from an ALLEGRO_FILE(3alleg5) stream into an ALLEGRO_SAMPLE(3alleg5).
       The file type is determined by  the  passed  `ident'  parameter,  which  is  a  file  name
       extension including the leading dot.

       Note  that this stores the entire file in memory at once, which may be time consuming.  To
       read   the   file   as   it   is   needed,    use    al_load_audio_stream_f(3alleg5)    or
       al_play_audio_stream_f(3alleg5).

       Returns the sample on success, NULL on failure.  The file remains open afterwards.

              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_register_sample_loader_f(3alleg5), al_init_acodec_addon(3alleg5)