Provided by: allegro5-doc_5.2.3.0-1_all bug

NAME

       al_init_acodec_addon - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_acodec.h>

              bool al_init_acodec_addon(void)

DESCRIPTION

       This    function    registers    all    the   known   audio   file   type   handlers   for
       al_load_sample(3alleg5), al_save_sample(3alleg5), al_load_audio_stream(3alleg5), etc.

       Depending on what libraries are available, the full set of recognised extensions is: .wav,
       .flac, .ogg, .opus, .it, .mod, .s3m, .xm, .voc.

       Limitations:

       • Saving is only supported for wav files.

       • The  wav  file loader currently only supports 8/16 bit little endian PCM files.  16 bits
         are used when saving wav files.  Use flac files if more precision is required.

       • Module files (.it, .mod, .s3m, .xm) are often  composed  with  streaming  in  mind,  and
         sometimes  cannot be easily rendered into a finite length sample.  Therefore they cannot
         be loaded with al_load_sample(3alleg5)/al_load_sample_f(3alleg5) and  must  be  streamed
         with al_load_audio_stream(3alleg5) or al_load_audio_stream_f(3alleg5).

       • .voc file streaming is unimplemented.

       Return true on success.