Ce fichier définit les prototypes des fonctions permettant de faire jouer de la musique et des échantillon sonore à l'aide de la librairie MLV. Plus de détails...
Aller au code source de ce fichier.
Définition de type | |
typedef struct _MLV_Music | MLV_Music |
Type codant une partion de musique provenant d'un fichier. | |
typedef struct _MLV_Sound | MLV_Sound |
Type codant une partion de musique provenant d'un fichier. | |
Fonctions | |
int | MLV_init_audio () |
Cette fonction initialise la libraire MLV pour pouvoir jouer de la musique et des sons. | |
void | MLV_free_audio () |
Ferme proprement les différents périphériques audios. | |
int | MLV_change_audio_buffer_size (int buffer_size) |
Change la taille du buffer audio. La taille doit être une puissance de 2. | |
void | MLV_change_number_of_parallel_sounds (unsigned int n) |
Change le nombre d'écahantillons sonores qui peuvent être joués en même temps. | |
MLV_Music * | MLV_load_music (const char *file_music) |
Charge un ficher contenant de la musique en mémoire. | |
void | MLV_free_music (MLV_Music *music) |
Ferme un morceau de musique chargé en mémoire. | |
void | MLV_play_music (MLV_Music *music, float volume, int loop) |
Joue une musique qui est chargée en mémoire. | |
void | MLV_stop_music () |
Arrête toutes les musiques. | |
MLV_Sound * | MLV_load_sound (const char *file_sound) |
Charge un ficher contenant un échantillon sonote en mémoire. | |
void | MLV_free_sound (MLV_Sound *sound) |
Ferme un échantillon sonore chargé en mémoire. | |
void | MLV_play_sound (MLV_Sound *sound, float volume) |
Joue un échantillon sonore chargée en mémoire. | |
void | MLV_stop_all_sounds () |
Arrête tous les échantillons sonores. |
Ce fichier définit les prototypes des fonctions permettant de faire jouer de la musique et des échantillon sonore à l'aide de la librairie MLV.
int MLV_change_audio_buffer_size | ( | int | buffer_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 compé 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 n'utilisez le programme que pour jouer de la musique, nous vous vous conseillons de configurer la taille du buffer à 4096.
buffer_size | Taille du buffer audio ( une puissance de 2 ) |
void MLV_free_music | ( | MLV_Music * | music | ) |
Ferme un morceau de musique chargé en mémoire.
music | Le morceau de musique à fermer |
void MLV_free_sound | ( | MLV_Sound * | sound | ) |
Ferme un échantillon sonore chargé en mémoire.
sound | L'échantillon sonore à fermer |
int MLV_init_audio | ( | ) |
Cette fonction initialise la libraire MLV pour pouvoir jouer de la musique et des sons.
MLV_Music* MLV_load_music | ( | const char * | file_music | ) |
Charge un ficher contenant de la musique en mémoire.
Cette fonction prends en paramètre le chemin d'acces 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 le .ogg, .mp3, .wav, etc ...
file_music | Chemin d'accès vers un fichier contenant de la musique codée en format .wav. |
MLV_Sound* MLV_load_sound | ( | const char * | file_sound | ) |
Charge un ficher contenant un échantillon sonote en mémoire.
Cette fonction prends en paramètre le chemin d'acces du fichier contenant l'échantillon sonnore et renvoie un pointeur vers l'espace mémoire où a été chargé l'échantillon sonore.
Les formats de fichier accepté sont les suivants : WAVE, AIFF, RIFF, OGG, and VOC.
file_sound | Chemin d'accès vers un fichier contenant d'échantillon sonore. |
void MLV_play_music | ( | MLV_Music * | music, | |
float | volume, | |||
int | loop | |||
) |
Joue une musique qui est chargée en mémoire.
music | Le morceau de musique à jouer. | |
volume | Le volume sonore. | |
loop | Le nombre de fois que le morceau doit être joué. Si loop est strivtement négatif, le morceau sera joué indéfiniment. |
void MLV_play_sound | ( | MLV_Sound * | sound, | |
float | volume | |||
) |
Joue un échantillon sonore chargée en mémoire.
sound | L'échantillon sonore à jouer. | |
volume | Le volume sonore. |
void MLV_stop_all_sounds | ( | ) |
Arrête tous les échantillons sonores.
i
void MLV_stop_music | ( | ) |