Outils pour utilisateurs

Outils du site


allegro:addon_audio

Ceci est une ancienne révision du document !


Allegro — Audio

Incluez ces headers :

#include <allegro5/allegro_audio.h> /* Pour jouer de la musique */
#include <allegro5/allegro_acodec.h> /* Pour charger de la musique encodée */

Ensuite, après avoir initialisé Allegro (avec al_init) initialisez les deux greffons, les fonctions doivent être absolument appelées dans cet ordre :

   if (!al_install_audio()) {
      // Fail
   }
 
   if (!al_init_acodec_addon()) {
      // Fail
   }

Maintenant on peut charger des sons aux formats .wav, .flac, .ogg, .it, .mod, .s3m, .xm (selon dépendances) et les jouer (à condition qu'un Display ait été crée) dans notre jeu.

   ALLEGRO_SAMPLE *sample
 
   ...
 
   if (!(sample = al_load_sample("music.wav"))) {
      // Fail
   }
 
   al_play_sample(sample, 1.0, 0.0, 1.0, ALLEGRO_PLAYMODE_LOOP, NULL);
 
   ...
 
   al_destroy_sample(sample);

La fonction al_play_sample prend en paramètres :

  • Le gain — volume auquel est joué le fichier, 1.0 est le volume normal
  • La balance — 0.0 pour centré, -1.0 pour gauche et 1.0 pour droite
  • La vitesse — de lecture, 1.0 pour la vitesse normale
  • La répétition : acceptant l'une de ces 3 valeurs
    • ALLEGRO_PLAYMODE_ONCE — joue le son une seule fois
    • ALLEGRO_PLAYMODE_LOOP — joue le son en boucle
    • ALLEGRO_PLAYMODE_BIDIR — ( FIXME bidir ? non décris dans la doc)
  • L'Id du sample — à récupérer pour effectuer des opération sur le sample

Allegro permet aussi d'enregistrer le son du micro, de gérer le mixer système et de gérer des streams audio (pour jouers des compositions de samples).

C.F. http://liballeg.org/a5docs/trunk/audio.html

Liste des greffons

allegro/addon_audio.1519897062.txt.gz · Dernière modification: 2018/03/01 10:37 par mrhide