DESCRIPTION.

La fonction FN_loadWAV() charge un fichier au format wav et retourne un pointeur donnant sa position en mémoire.

SYNTAXE.

kpointeur = FN_loadWAV( fichier , taux , mode )

REMARQUES.

fichier doit être une chaine de caractères et correspondant au nom d'un fichier valide au fomat mp3. fichier peut être exprimé de façon : 

- absolue, indiquant le support, le chemin d'accès, le nom et l'extension du fichier ;

- relative, indiquant son nom et son extension, il est supposé se trouver dans un dossier par défaut.

taux doit être un nombre entier indiquant la fréquence d'échantillonnage souhaitée en échantillons par seconde, par exemple : 

- 48000, pour des sons de qualité professionnels ;

- 44100, pour des sons de qualité CD et MP3 standard ;

- 22050, pour des sons de qualité de fichiers légers.

mode doit être un nombre entier indiquant le nombre de canaux qui seront utilisés pour la restitution du son. mode doit valoir :

- 1 pour des sons monophonique ;

- 2 pour des sons stéréophonique.

taux et mode peuvent avoir des valeurs différentes de celles utilisées lors de l'encodage du fichier wav. Dans ce cas une conversion de fréquence d'échantillonnage sera effectuée si nécessaire. 

Note : en général, tous les fichiers audio chargés par votre programme doivent les mêmes valeurs pour taux et mode.

L'appel de la fonction FN_loadWAV() chargera fichier et retourne un pointeur vers le fichier 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%%.

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_loadWAV() 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 ---

kbruitage = FN_loadWAV( "/home/user/Musique/monfichier.wav" , 44100 , 2 )

PRINT kbruitage