DESCRIPTION.

La procédure PROC_mixSoundLevel() mixte un fichier audio avec celui en cours de lecture et précisant son volume sonore.

SYNTAXE.

PROC_mixSoundLevel( effet , base , volume )

REMARQUES.

effet et base doivent être des valeurs retournées par la fonction :

- FN_loadMP3(), si le fichier était au format mp3 ;

- FN_loadWAV(), si le fichier était au format wav.

volume doit être un nombre entier compris entre 0 et 128. volume indique le volome sonore niveau relatif auquel effet est joué, si volume vaut 0, effet ne sera pas audible et la valeur de effet est 128 son volume sonore sera au maximum. 

La procédure PROC_mixSoundLevel() insère effet en le mélangeant dans base, en général le fichier de la musique de fond, qui doit être en cours la lecture audio en cours. Pour fonctionner correctement, la durée restante de base doit être supérieure à la durée effet. 

Pour obtenir et jouer des effets sonores qui se mélangent, mais sans jouer de musique de fond, on chargera un fichier sonore, au format mp3 ou wav, silencieux, de la longueur souhaitée pour base.

Rappel : la procédure PROC_initAudio devra toujours être appelée avant tout autre fonction ou procédure de audiolib.bbc.

Voir la fonction FN_loadWAV qui permet de charger un fichier au format wav.

Voir la fonction FN_loadMP3 qui permet de charger un fichier au format mp3. 

Voir l'instruction SOUND qui permet de produire des notes de musique précises ou des sons.

La procédure PROC_mixSoundLevel() est importée depuis le module audiolib.bbc. 

EXEMPLE.

REM --- Importation des modules ---

REM --- Module de la bibliothèque BBC BASIC ---

INSTALL @lib$ + "audiolib.bbc"

REM --- INITIALISATION GENERALE ---

REM --- Initialisation de audiolib ---

PROC_initAudio

REM --- Chargement d'un fichier son ---

kmusique = FN_loadMP3( "/home/user/Musique/musique.mp3" , 44100 , 2 )

keffet = FN_loadMP3( "/home/user/Musique/effet.mp3" , 44100 , 2 )

REM --- Lecture du fichier ---

PROC_playSound( kmusique )

FOR kvolume = 0 TO 128 STEP 16

WAIT( 200 ) 

PROC_mixSoundLevel( keffet , kmusique , kvolume )

NEXT kvolume

REM --- Fin de la memoire ---

END