intMLV_change_audio_buffer_size(intbuffer_size)
Change la taille du buffer audio. La taille doit être une puissance de 2. Le porgramme rempli
périodiquement un buffer audio à faire jouer par la carte son. Plus la taille du buffer audio est grande,
plus le programme à le temps de remplir le buffer avant qu'il se vide. Plus le buffer est grand, plus le
programme met du temps à le remplir.
Ainsi, si il y a un temps de latence entre une action et l'execution sonore du son correspondant, c'est
que vous devez réduire la taille du buffer audio.
Si le son est coupé et crépite, c'est que le buffer est trop petit et que le processeur est trop lent
pour remplir le buffer avant qu'il se vide. Vous devez donc agrandir la taille du buffer.
MLV_change_buffer_size vous permet d'ajuster la taille de ce buffer. par default la taille du buffer est
mis à 1024.
Si vous utilisez le programme uniquement pour jouer de la musique, nous vous vous conseillons de
configurer la taille du buffer à 4096.
Paramètresbuffer_size Taille du buffer audio ( une puissance de 2 )
Renvoie
Renvoie 0 si l'infrastructure audio a été correctement initialisé, renvoie -1 sinon.
voidMLV_change_number_of_parallel_sounds(unsignedintn)
Change le nombre d'écahantillons sonores qui peuvent être joués en même temps.
Paramètresn Le nombre d'échantillons sonores.
voidMLV_free_music(MLV_Music*music)
Ferme un morceau de musique chargé en mémoire.
Paramètresmusic Le morceau de musique à fermer
Exemplesadvanced/03_music.c.
voidMLV_free_sound(MLV_Sound*sound)
Ferme un échantillon sonore chargé en mémoire.
Paramètressound L'échantillon sonore à fermer
Exemplesadvanced/04_sound.c.
intMLV_init_audio()
Cette fonction initialise la bibliothèque MLV pour pouvoir jouer de la musique et des sons.
Renvoie
Renvoie 0 si l'infrastructure audio a été correctement initialisé, renvoie -1 sinon.
Exemplesadvanced/03_music.c, advanced/04_sound.c, advanced/09_animation.c, et advanced/11_animation_book.c.
MLV_Music*MLV_load_music(constchar*file_music)
Charge un ficher contenant de la musique en mémoire. Cette fonction prends en paramètre le chemin d'accès
du fichier contenant la musique et renvoie un pointeur vers l'espace mémoire où a été chargé la musique.
Les formats de fichier acceptés sont les suivants .ogg, .mp3, .wav, etc ...
Paramètresfile_music Chemin d'accès vers un fichier contenant de la musique codée en format .wav.
Renvoie
Un pointeur vers la musique chargée en mémoire, ou NULL si la bibliothèque n'a pas réussi à charger
la musique en mémoire.
Exemplesadvanced/03_music.c.
MLV_Sound*MLV_load_sound(constchar*file_sound)
Charge un ficher contenant un échantillon sonore en mémoire. Cette fonction prends en paramètre le chemin
d'accès du fichier contenant l'échantillon sonore et renvoie un pointeur vers l'espace mémoire où a été
chargé l'échantillon sonore.
Les formats de fichier acceptés sont les suivants : WAVE, AIFF, RIFF, OGG, and VOC.
Paramètresfile_sound Chemin d'accès vers un fichier contenant un échantillon sonore.
Renvoie
Null si le fichier n'a pas pu être chargé en mémoire. Un pointeur vers l'échantllon sonore sinon.
Exemplesadvanced/04_sound.c, et advanced/09_animation.c.
voidMLV_play_music(constMLV_Music*music,floatvolume,intloop)
Joue un morceau de musique qui est chargée en mémoire.
Paramètresmusic Le morceau de musique à jouer.
volume Le volume sonore.
loop Le nombre de fois que le morceau doit être joué. Si loop est strictement négatif, le morceau
sera joué indéfiniment.
Exemplesadvanced/03_music.c.
voidMLV_play_sound(constMLV_Sound*sound,floatvolume)
Joue un échantillon sonore chargé en mémoire.
Paramètressound L'échantillon sonore à jouer.
volume Le volume sonore.
Exemplesadvanced/04_sound.c.