Jouer du son avec FMOD

Pourquoi FMOD ?

Pourquoi j'ai évité SDL_audio

Pourquoi j'ai évité SDL_mixer

Télécharger FMOD

Installer FMOD

1. Vous avez un dossier "Api" avec la DLL de FMOD (fmod.dll) à placer dans le répertoire de votre projet.
   
   fmod64.dll, que vous trouverez dans le même dossier, est la DLL adaptée aux systèmes d'exploitation 64 bits, pour ceux qui ont des processeurs 64 bits.
   Si vous n'êtes pas sûr de la DLL à prendre, utilisez fmod.dll, il y a 99% de chances pour que ce soit la bonne. Si vous êtes sous Windows XP par exemple, c'est que vous n'êtes pas sous un OS 64 bits, vous pouvez donc prendre fmod.dll.
2. Dans le dossier "api/inc", vous trouverez les .h. Placez-les à côté des autres .h dans le dossier de votre IDE. Par exemple "Code Blocks/mingw32/include/FMOD" (j'ai créé un dossier spécial pour FMOD comme pour SDL).
3. Dans le dossier "api/lib", récupérez le fichier qui correspond à votre compilateur.
   
   • Si vous utilisez Code Blocks ou Dev-C++, donc le compilateur mingw, copiez "libfmod.a" dans le dossier "lib" de votre IDE.
     Dans le cas de Code Blocks, c'est le dossier "CodeBlocks/mingw32/lib".
   • Si vous utilisez Visual C++, récupérez le fichier "fmodvc.lib"
4. Enfin, et c'est peut-être le plus important, dans le dossier "documentation" vous trouverez un fichier d'aide qui correspond à la documentation de FMOD. Je vous conseille de le placer quelque part sur votre disque dur et d'en faire un raccourci bien visible, par exemple dans le menu Démarrer.
   En effet, la documentation liste toutes les possibilités de FMOD dans le détail. Dans ce chapitre, on ne pourra voir que les principales. Si vous voulez allez plus loin, il faudra donc vous plonger dans cette doc
   
   
   La doc est aussi accessible en ligne à l'adresse : http://www.fmod.org/docs.

Les différentes sections de FMOD

• FSOUND : cette partie gère tous les sons de type PCM. Il s'agit tout simplement de sons "réels" enregistrés, cela comprend aussi bien les formats compressés que non compressés : WAV, MP3, OGG, etc. Ces sons peuvent être des musiques ou des courts son comme un bruit de pas, un bruit de balle... D'ailleurs, FMOD distingue 2 types de sons :
  
  • Les sons courts (bruit de pas, bruit de balle) destinés à être répétés souvent.
  • Les sons longs, comme une musique qui dure 3 minutes par exemple (ça peut être la musique de fond de votre jeu).
• FMUSIC : cette section gère les musiques au format binaire. Cette fois, il n'y a pas de son enregistré, juste les notes de musique. Le format binaire le plus connu est probablement le MIDI. Vous savez probablement que les MIDI sont des fichiers audio très petits : c'est justement parce qu'ils enregistrent seulement les notes de musique (il ne peut donc pas y avoir de "paroles" avec un tel format de fichier). Cette section peut être très utile pour jouer des vieilles musiques type Gameboy ou SuperNES, comme par exemple la musique de Super Mario, de Tetris, etc.

• FSOUND : sons courts
• FSOUND : sons longs (musiques)
• FMUSIC : musique type MIDI

Inclure le header

1

#include <FMOD/fmod.h>

Initialiser FMOD

• La fréquence d'échantillonnage : comptez pas sur moi pour vous faire un cours de physique ici
  En gros, ce paramètre permet d'indiquer la qualité de son que doit gérer FMOD. Plus la fréquence est élevée, meilleur est le son (mais la puissance demandée est plus grande). Voici quelques exemples de fréquences pour vous aider à faire votre choix :
  
  • Qualité CD : 44 100 Hz
  • Qualité radio : 22 050 Hz
  • Qualité téléphonique : 11 025 Hz
  
  Dans tout ce chapitre, nous utiliserons une fréquence de 44 100 Hz.
  
  Si le son que vous utilisez est de mauvaise qualité à la base, FMOD ne l'améliorera pas. Par contre, si vous avez un son de fréquence 44 100 Hz et que FMOD utilise une fréquence de 22 050 Hz, sa qualité sera diminuée.
• Le nombre maximal de canaux que devra gérer FMOD. En d'autres termes, c'est le nombre maximal de sons qui pourront être joués en même temps. Tout dépend de la puissance de votre carte son. On conseille généralement une valeur de 32 (ce sera suffisant pour la plupart des petits jeux). Pour info, FMOD peut théoriquement gérer jusqu'à 1024 canaux différents, mais à ce niveau ça risque de beaucoup faire travailler votre ordinateur !
• Enfin, on peut indiquer des flags. Il n'y a rien de bien intéressant à mettre en général, donc on se contentera d'envoyer 0 (pas de flags).

1

FSOUND_Init(44100, 32, 0);

Libérer FMOD

1

FSOUND_Close();

• Un bruit de balle
• Un bruit de pas
• Un tic-tac (pour faire stresser le joueur avant la fin d'un compte à rebours )
• Des applaudissements
• etc etc

Trouver des sons courts

Le site FindSounds.com, un moteur de recherche de sons courts (ici, des bruits de porte)

Les étapes à suivre pour jouer un son

Le pointeur

1

FSOUND_SAMPLE *tir = NULL;

Charger le son

• Le numéro de la sample pool dans laquelle FMOD doit garder une trace du son. Je m'explique
  La sample pool, que j'ai pas trop essayé de traduire mais on pourrait dire que c'est la "piscine à samples", c'est une sorte de tableau dans lequel FMOD garde une copie des pointeurs vers chacun des sons courts chargés. Cela lui permet de libérer automatiquement la mémoire lorsqu'on appelle FSOUND_Close() (la fonction d'arrêt de FMOD) : il suffit à FMOD de lire ce tableau et de libérer chacun des éléments qui s'y trouvent. Toutefois, plutôt que de faire confiance à FMOD, il est mieux de penser à appeler nous-mêmes la fonction de libération de mémoire (FSOUND_Sample_Free()) que nous allons découvrir dans quelques instants.
  
  Bref, tout ce blabla pour dire que ce paramètre sert au fonctionnement interne de FMOD pour qu'il s'assure de libérer tous les sons à la fin au cas où vous auriez oublié de le faire.
  Pour indiquer un numéro de la sample pool, le mieux est d'envoyer FSOUND_FREE à la fonction. Elle se chargera alors de prendre le premier emplacement libre de la sample pool qu'elle trouvera. Ne vous posez donc pas trop de questions ce n'est pas bien utile ici, envoyez juste FSOUND_FREE
• Le nom du fichier son à charger. Il peut être de format WAV, MP3, OGG, etc. Toutefois, il vaut mieux charger des sons courts (quelques secondes maximum) plutôt que des sons longs. En effet, la fonction chargera et décodera tout le son en mémoire, ce qui peut prendre de la place si le son est une musique !
• Le troisième paramètre ne nous intéresse pas, il permet de préciser les caractéristiques du fichier qu'on veut charger (fréquence d'échantillonnage, etc.). Or, dans le cas des WAV, MP3, OGG et cie, ces informations sont inscrites dans le fichier. On va donc envoyer la valeur 0 pour ne rien préciser.
• L'offset où doit commencer la lecture. Cela permet de commencer la lecture du son à un moment précis. Mettez 0 pour commencer du début.
• La longueur : si vous précisez un offset, il faudra aussi donner la longueur de son à lire. On mettra là encore 0 car on veut tout lire.

1

tir = FSOUND_Sample_Load(FSOUND_FREE, "pan.wav", 0, 0, 0);

Si vous voulez faire les tests en même temps que moi (et si vous ne voulez pas vous devriez ), voici le fichier son pan.wav sur lequel nous allons travailler par la suite.

Jouer le son

1

FSOUND_PlaySound(FSOUND_FREE, tir);

Libérer le son de la mémoire

1

FSOUND_Sample_Free(tir);

Exemple : un jeu de tir

Le sujet

Oui je sais...
J'aurais dû faire les Beaux Arts

• Fond de fenêtre : noir.
• Pointeur de la souris : invisible.
• L'image du viseur est blittée à la position de la souris lorsqu'on la déplace. Attention : il faut que le CENTRE de l'image soit placé au niveau du pointeur de la souris.
• Quand on clique, le son pan.wav doit être joué.

La correction

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

#include <stdlib.h>
#include <stdio.h>
#include <SDL/SDL.h>
#include <SDL/SDL_image.h>
#include <FMOD/fmod.h>

int main(int argc, char *argv[])
{
    SDL_Surface *ecran = NULL, *viseur = NULL;
    SDL_Event event;
    SDL_Rect position;
    int continuer = 1;
    FSOUND_SAMPLE *tir = NULL;

    /* Initialisation de FMOD */
    FSOUND_Init(44100, 32, 0);

    /* Chargement du son et vérification du chargement */
    tir = FSOUND_Sample_Load(FSOUND_FREE, "pan.wav", 0, 0, 0);
    if (tir == NULL)
    {
        fprintf(stderr, "Impossible de lire pan.wav\n");
        exit(EXIT_FAILURE);
    }

    /* Initialisation de la SDL */
    SDL_Init(SDL_INIT_VIDEO);

    SDL_ShowCursor(SDL_DISABLE);
    ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE | SDL_DOUBLEBUF);
    SDL_WM_SetCaption("Gestion du son avec FMOD", NULL);

    viseur = IMG_Load("viseur.png");


    while (continuer)
    {
        SDL_WaitEvent(&event);


        switch(event.type)
        {
            case SDL_QUIT:
                continuer = 0;
                break;
            case SDL_MOUSEBUTTONDOWN:
                /* Lorqu'on clique, on joue le son */
                FSOUND_PlaySound(FSOUND_FREE, tir);
                break;
            case SDL_MOUSEMOTION:
                /* Lorsqu'on déplace la souris, on place le centre du viseur à la position de la souris
                ... D'où notamment le "viseur->w / 2" pour réussir à faire cela */
                position.x = event.motion.x - (viseur->w / 2);
                position.y = event.motion.y - (viseur->h / 2);
                break;
        }

        SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->format, 0, 0, 0));
        SDL_BlitSurface(viseur, NULL, ecran, &position);
        SDL_Flip(ecran);
    }

    /* On ferme la SDL */
    SDL_FreeSurface(viseur);
    SDL_Quit();

    /* On libère le son et on ferme FMOD */
    FSOUND_Sample_Free(tir);
    FSOUND_Close();

    return EXIT_SUCCESS;
}

Le jeu avec le viseur. Quand on clique avec la souris, on entend "PAN !"

Code incorrect (viseur mal placé)		Code : C 1 2 position.x = event.motion.x; position.y = event.motion.y;
Code correct (viseur bien placé)		Code : C 1 2 position.x = event.motion.x - (viseur->w / 2); position.y = event.motion.y - (viseur->h / 2);

Idées d'amélioration

Bien sûr, les forums du Site du Zéro sont toujours là pour vous aider si vous êtes bloqués à un moment de la création de votre jeu. Il est normal de rencontrer des difficultés, quel que soit le niveau qu'on ait

Trouver des musiques

Jamendo.com propose des musiques libre de droit (ici le groupe Hype)

Les étapes à suivre pour jouer une musique

Le pointeur

1

FSOUND_STREAM *musique = NULL;

Charger le son

1

musique = FSOUND_Stream_Open("Hype_Home.mp3", 0, 0, 0);

Jouer la musique

• Le numéro du canal sur lequel jouer le son (envoyez FSOUND_FREE et FMOD se débrouillera tout seul pour trouver un canal libre)
• Le pointeur vers le fichier à lire (dans notre cas il s'appelle musique).

1

FSOUND_Stream_Play(FSOUND_FREE, musique);

Modifier le volume

1

FSOUND_SetVolume(FSOUND_ALL, 120);

• Le numéro du canal dont on doit changer le volume (pour changer le volume de tous les canaux, envoyez FSOUND_ALL)
• Le nouveau volume : mettez un nombre de 0 (silencieux) à 255 (volume maximal)

Répétition de la chanson

• Le pointeur vers la chanson
• Le nombre de fois qu'elle doit être répétée. Si vous mettez 1, la chanson sera donc répétée une seule fois. Si vous mettez un nombre négatif (comme -1), la chanson sera répétée à l'infini.

1

FSOUND_Stream_SetLoopCount(musique, -1);

Mettre en pause la chanson

• FSOUND_GetPaused(numero_du_canal) : indique si la chanson jouée sur le canal indiqué est en pause ou pas. Elle renvoie vrai si la chanson est en pause, faux si elle est en train d'être jouée.
• FSOUND_SetPaused(numero_du_canal, etat) : met en pause ou réactive la lecture de la chanson sur le canal indiqué. Envoyez 1 (vrai) pour mettre en pause, 0 (faux) pour réactiver la lecture.

1
2
3
4
5
6
7
8
9

case SDL_KEYDOWN:
    if (event.key.keysym.sym == SDLK_p) // Si on appuie sur P
    {
        if (FSOUND_GetPaused(1)) // Si la chanson est en pause
            FSOUND_SetPaused(FSOUND_ALL, 0); // On enlève la pause
        else // Sinon, elle est en cours de lecture
            FSOUND_SetPaused(FSOUND_ALL, 1); // On met en pause
    }
    break;

Stopper la lecture

1

FSOUND_Stream_Stop(musique);

Et bien d'autres choses

Libérer la mémoire

1

FSOUND_Stream_Close(musique);

Code complet de lecture du MP3

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

int main(int argc, char *argv[])
{
    SDL_Surface *ecran = NULL, *pochette = NULL;
    SDL_Event event;
    SDL_Rect position;
    int continuer = 1;
    FSOUND_STREAM *musique = NULL;

    FSOUND_Init(44100, 32, 0);
    musique = FSOUND_Stream_Open("Hype_Home.mp3", FSOUND_LOOP_NORMAL, 0, 0); /* On ouvre la musique */
    if (musique == NULL) /* On vérifie si elle a bien été ouverte (IMPORTANT) */
    {
        fprintf(stderr, "Impossible de lire Hype_Home.mp3\n");
        exit(EXIT_FAILURE);
    }

    FSOUND_Stream_SetLoopCount(musique, -1); /* On active la répétition de la musique à l'infini */
    FSOUND_Stream_Play(FSOUND_FREE, musique); /* On joue la musique */

    SDL_Init(SDL_INIT_VIDEO);


    ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE | SDL_DOUBLEBUF);
    SDL_WM_SetCaption("Gestion du son avec FMOD", NULL);
    pochette = IMG_Load("hype_liesandspeeches.jpg");
    position.x = 0;
    position.y = 0;


    while (continuer)
    {
        SDL_WaitEvent(&event);
        switch(event.type)
        {
            case SDL_QUIT:
                continuer = 0;
                break;
            case SDL_KEYDOWN:
                if (event.key.keysym.sym == SDLK_p) //Si on appuie sur P
                {
                    if (FSOUND_GetPaused(1)) // Si la chanson est en pause (sur le canal 1)
                        FSOUND_SetPaused(1, 0); // On enlève la pause
                    else // Sinon, elle est en cours de lecture
                        FSOUND_SetPaused(1, 1); // On active la pause
                }
                break;
        }

        SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->format, 0, 0, 0));
        SDL_BlitSurface(pochette, NULL, ecran, &position);
        SDL_Flip(ecran);
    }

    FSOUND_Stream_Close(musique); /* On libère la mémoire */
    FSOUND_Close();

    SDL_FreeSurface(pochette);
    SDL_Quit();

    return EXIT_SUCCESS;
}

L'intérêt dans cette image, c'est le son qui se joue derrière
(euh oui certes, les images ne produisent pas de son...)

Trouver des MIDI

Le moteur de recherche de fichiers MIDI MusicRobot.com
(ici, à la recherche d'un MIDI de Mario)

Les étapes à suivre pour jouer un MIDI

Le pointeur

1

FMUSIC_MODULE *musique = NULL;

Charger un MIDI

1

musique = FMUSIC_LoadSong("mario.mid");

Jouer un MIDI

1

FMUSIC_PlaySong(musique);

Répéter un MIDI

1

FMUSIC_SetLooping(musique, 1);

Mettre en pause un MIDI

1

FMUSIC_GetPaused(musique);

1

FMUSIC_SetPaused(musique, 1);

1
2
3
4
5
6
7
8

case SDL_KEYDOWN:
    if (event.key.keysym.sym == SDLK_p) //Si on appuie sur P
    {
        if (FMUSIC_GetPaused(musique)) // Si la chanson est en pause
            FMUSIC_SetPaused(musique, 0); // On enlève la pause
        else // Sinon, elle est en cours de lecture
            FMUSIC_SetPaused(musique, 1); // On active la pause
    }

Modifier le volume

1

FMUSIC_SetMasterVolume(musique, 150);

• 0 = silencieux
• 256 = volume maximal

Stopper la lecture

1

FMUSIC_StopSong(musique);

Libérer la musique MIDI

1

FMUSIC_FreeSong(musique);

Code d'exemple pour résumer

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

int main(int argc, char *argv[])
{
    SDL_Surface *ecran = NULL, *niveau = NULL;
    SDL_Event event;
    SDL_Rect position;
    int continuer = 1;
    FMUSIC_MODULE *musique = NULL;

    FSOUND_Init(44100, 32, 0);
    musique = FMUSIC_LoadSong("mario.mid"); // Chargement de la chanson
    if (musique == NULL)
    {
        fprintf(stderr, "Impossible de lire mario.mid\n");
        exit(EXIT_FAILURE);
    }
    FMUSIC_SetLooping(musique, 1); // Répétition infinie
    FMUSIC_PlaySong(musique); // On joue la chanson


    SDL_Init(SDL_INIT_VIDEO);

    ecran = SDL_SetVideoMode(640, 480, 32, SDL_HWSURFACE | SDL_DOUBLEBUF);
    SDL_WM_SetCaption("Gestion du son avec FMOD", NULL);
    niveau = IMG_Load("mario_niveau.jpg"); // Je me permets de mettre une petite image de fond ^^
    position.x = 0;
    position.y = 0;


    while (continuer)
    {
        SDL_WaitEvent(&event);
        switch(event.type)
        {
            case SDL_QUIT:
                continuer = 0;
                break;
            case SDL_KEYDOWN:
                if (event.key.keysym.sym == SDLK_p) //Si on appuie sur P
                {
                    if (FMUSIC_GetPaused(musique)) // Si la chanson est en pause
                        FMUSIC_SetPaused(musique, 0); // On enlève la pause
                    else // Sinon, elle est en cours de lecture
                        FMUSIC_SetPaused(musique, 1); // On active la pause
                }
                break;
        }

        SDL_FillRect(ecran, NULL, SDL_MapRGB(ecran->format, 0, 0, 0));
        SDL_BlitSurface(niveau, NULL, ecran, &position);
        SDL_Flip(ecran);
    }

    FMUSIC_FreeSong(musique); // Déchargement de la chanson
    FSOUND_Close();

    SDL_FreeSurface(niveau);
    SDL_Quit();

    return EXIT_SUCCESS;
}

Oui oui il y a la musique de Mario en fond !
(mais n'allez pas croire que c'est un jeu, c'est juste une image !)

La musique MIDI de Mario (240 Ko)
(la compression Flash a un peu déterioré le son désolé )