DESCRIPTION.

La procédure PROC_trackMusic() ajoute des données dans la mémoire tampon d'un canal audio pour assurer la poursuite de la lecture en cours et éventuellement de la relancer depuis le début.

SYNTAXE.

PROC_trackMusic( adresse , copie , debut , fin )

REMARQUES.

adresse doit être la valeur retournée par la fonction :

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

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

Le fichier sonore, associé à adresse doit être en cours de lecture lors de l'appel de la procédure PROC_trackMusic.

copie doit être 0 si la procédure PROC_mixSound() n'a pas été utilisé pour insérer un effet sonore dans adresse. ou alors la valeur retournée par la fonction FN_copyMusic() utilisée pour créer une copie en mémoire du fichier sonore correspondant à adresse. 

debut doit être -1 arrêter immédiatement la lecture de adresse ou un nombre entier indiquant un décalage, en millisecondes, par rapport au début du début  de adresse. Si début est différent de -1, adresse sera lu en boucle.

fin doit être -1 si adresse ne doit pas être rejouer ou 0 pour relancer sa lecture quand il aura été entièrement exécuté.

Cette procédure PROC_trackMusic() doit être appelée périodiquement, environ toutes les cinq secondes, pour replacer 5Mo de données, provenant du fichier associé à adresse, dans la mémoire tampon du canal audio, afin de poursuivre sa lecture mais aussi pour de gérer le comportement du programme lorsque adresse aurar atteint la fin des données en mémoire. 

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 la procédure PROC_playSoundFrom() qui lit un fichier audio chargé à partir d'une position données.

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

La fonction PROC_trackMusic() 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/monfichier.mp3" , 44100 , 2 )

REM --- Lecture du fichier ---

PROC_playSound( kmusique )

PRINT "Appuyer sur Q pour arreter ... "

REPEAT

PROC_trackMusic( kmusique , 0 , 0 , -1 )

PRINT TIME$

ktouche$ = INKEY$( 100 )

UNTIL ktouche$ = "Q" OR ktouche$ = "q"

REM --- Purge de la memoire ---

PROC_freeMP3( kmusique )

REM --- Fin de la memoire ---

END