Utilisation de la librairie FMOD pour lire un MP3 sous C++ Builder

FMOD est une librairie très complète, mais seule la partie permettant de lire des fichiers au format MP3 est l'objet de ce tutoriel.

L'utilisation est libre pour un usage privé. Seule l'utilisation commerciale fait l'objet d'une licence.

Elle est téléchargeable à l'adresse suivante : http://www.fmod.org . La version utilisée ici est la 3.6. Je vous conseille de télécharger les API, ainsi que l'aide, soit au format HTML, soit au format CHM.

Un mini lecteur MP3 écrit avec FMOD : Exécutable - Sources

Lors de la création du projet, il est nécessaire d'effectuer quelques manipulations préliminaires afin de s'assurer que tous les éléments de FMOD soient disponibles.

Dans le répertoire contenant le projet, recopier les fichiers suivants :

• FMOD.DLL ;
• FMOD.H ;
• FMOD_ERRORS.H ;
• FMODBC.LIB ;
• WINCOMPAT.H.

Ajouter FMODBC.LIB à la liste des fichiers utilisés dans le Project Manager. Il s'agit de la librairie d'importation. Elle peut être recréée par la commande :

                IMPLIB FMOD.LIB FMOD.DLL

ajouter le code suivant dans l'unité qui utilisera les fonctions de FMOD :

#define WIN32
#define DLL_EXPORTS

#include "fmod.h"

Les deux defines sont nécessaires pour que les déclarations des prototypes de fonctions soient correctes.
le WIN32 indique que l'on travaille sous Windows.
le DLL_EXPORTS que l'on va utiliser des fonctions importées depuis une DLL.

Il est nécessaire d'initialiser la DLL par la commande suivante :

bool lRet;

lRet = FSOUND_Init(44100, 32, 0);

Les paramètres sont ,dans l'ordre :

• la fréquence de mixage ;
• le nombre de canaux software ;
• des flags d'initialisation.

Pour une description des paramètres, se référer à la documentation de FMOD.

Une valeur de retour à true indique que l'initialisation s'est bien déroulée, false sinon.

FSOUND_STREAM *MP3Stream;

MP3Stream = FSOUND_Stream_OpenFile("test.mp3", FSOUND_NORMAL, 0);

FSOUND_Stream_OpenFile ouvre un fichier et le prépare pour la lecture

Les paramètres sont dans l'ordre :

• le nom du fichier ;
• le mode spécifiant la façon de jouer le morceau ;
• 0 à une exception près.

Le 3e paramètre n'a de raison d'être que si FSOUND_LOADMEMORY est spécifié dans les mode.
Dans ce cas, le 1er paramètre est un pointeur sur un buffer en mémoire contenant le morceau à jouer.
Le 3e paramètre est dans ce cas, la longueur de la zone pointée par le 1er paramètre.

La valeur de retour est un pointeur sur une structure FSOUND_STREAM ou NULL si le fichier n'a pas pu être ouvert.

bool lRet;

lRet = FSOUND_Stream_Close(MP3Stream);

FSOUND_Stream_Close ferme le stream passé en argument et libère les ressources allouées lors de l'ouverture.

Une valeur de retour à true indique que la fermeture s'est bien déroulée, false sinon.

int iChannel;

iChannel = FSOUND_Stream_Play(FSOUND_FREE, MP3Stream);

FSOUN_Stream_Play lance la lecture du Stream passé en second paramètre.
Le premier paramètre permet de spécifier le numéro du canal que l'on veut utiliser. FSOUND_FREE prend le premier canal libre.

La valeur de retour est le numéro du canal attribué pour la lecture du morceau.

int iChannel;
bool lRet, lPaused;

lPaused = FSOUND_GetPaused(iChannel);
lRet = FSOUND_SetPaused(iChannel, lPaused);

FSOUND_GetPaused renvoie l'état de pause du channel passé en paramètre.

FSOUND_SetPaused met le channel passé en 1er paramètre en l'état de pause spécifié par le second paramètre : true met la pause, false l'enlève.

bool lRet;

lRet = FSOUND_Stream_Stop(MP3Stream);

FSOUND_Stream_Stop arrête la lecture du stream passé en paramètre.

À noter que la lecture est arrêtée, mais que le Stream n'est pas libéré.

int iChannel;
bool lMute, lRet;

lMute = FSOUND_GetMute(iChannel);
lRet = FSOUND_SetMute(iChannel, lMute);

FSOUND_GetMute prend en paramètre le numéro de channel dont on veut connaître l'état et renvoie son état : true si le channel est en mute, false sinon.

FSOUND_SetMute prend en 1er paramètre le numéro de channel dont on veut modifier l'état, et en second paramètre le nouvel état : true pour mettre le mute on, false pour mute off.

À noter que seul le volume est coupé, la lecture du stream se poursuit.

IX-A. Obtenir le volume courant▲

int iVol, iChannel;

iVol  = FSOUND_GetVolume(iChannel);

IX-B. Fixer le volume▲

bool lRet;
int iVol, iChannel;

lRet = FSOUND_SetVolume(iChannel, iVol);

X-A. Obtenir la valeur courante de balance▲

int iPan, iChannel;

iPan = FSOUND_GetPan(iChannel);

X-B. Fixer la valeur de la balance▲

bool lRet;
int iPan, iChannel;

lRet = FSOUND_SetPan(iChannel, iPan);

XI-A. Obtenir la durée totale du MP3▲

int iLength;

FSOUND_STREAM *MP3Stream;
iLength = FSOUND_Stream_GetLengthMs(MP3Stream);

XI-B. Obtenir la durée écoulée▲

int iPassed;

FSOUND_STREAM *MP3Stream;
iPassed = FSOUND_Stream_GetTime(MP3Stream);

XI-C. Se déplacer dans le MP3▲

bool lRet;
int iPos;

FSOUND_STREAM *MP3Stream;
lRet = FSOUND_Stream_SetTime(MP3Stream, iPos);

int iErrCode;

iErrCode  = FSOUND_GetError();

Cette fonction renvoie un code d'erreur dont la description est :

float fCPUUsage;

fCPUUsage = FSOUND_GetCPUUsage();

FSOUND_GetCPUUsage permet de connaître la charge CPU ajoutée par FMOD.

La valeur retournée est un flottant compris entre 0.0 et 100.0, représentant le pourcentage de CPU utilisé.