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.