DESCRIPTION.

La fonction FN_copyMusic() crée une copie du fichier audio chargé et retourne un pointeur donnant sa position en mémoire.

SYNTAXE.

kpointeur = FN_copyMusic( adresse )

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.

L'appel de la fonction FN_copyMusic() crée une copie du fichier audio précédemment chargé par la fonction FN_loadMP3 ou la fonction  FN_loadWAV et retourne un pointeur vers cette copie faite de données brutes. Cette copie est généralement utilisée lors des appels suivants aux fonction  PROC_mixCancel() ou PROC_trackMusic(). Cette copie est indispensable car l’ajout d’effets sonores peut modifier le morceau en cours de lecture.

L'appel de la fonction FN_copyMusic() retourne un pointeur vers un emplacement en mémoire. Il est indispensable de mémoriser cette valeur dans une variable. Et étant donné que la valeur renvoyée est un pointeur, elle doit être stockée dans une variable de type variant, sans de suffixe, par exemple kpointeur, ou entier 64 bits, avec le suffixe %%, par exemple kpointeur%%.

Note : afin d'éviter une fuite de mémoire, la copie doit être libérée avant la fin du programme en appelant la routine SDL_free comme suit : SYS "SDL_free" , kpointeur.

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 fonction FN_copyMusic() 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 --- Copie des donnes brutes du fichier son ---

kcopie = FN_copyMusic ( kmusique )