Documentation de la bibliothèque MLV-0.5

Fonctions

Référence du fichier MLV_time.h

Ce fichier définit tous les prototypes des fonctions concernant la gestion du temps. Plus de détails...

Aller au code source de ce fichier.

Fonctions

void MLV_wait_milliseconds (int milliseconds)
 Le programme s'intérompt pendant un nombre de milli-secondes.
void MLV_wait_seconds (int seconds)
 Le programme s'intérompt pendant un nombre de secondes.
int MLV_get_time ()
 Renvoie le nombre de millisecondes écoulées depuis le début de l'initialisation de la librairie MLV ( avec MLV_create_window ).
int MLV_get_date (int *seconds, int *minutes, int *hours, int *day, int *month, int *year, int *day_of_the_week)
 Donne la date du jour (seconde/heure/jour/mois/annee).
void MLV_change_frame_rate (int rate)
 Configure la fréquence de rafraichissement en Hz.
int MLV_get_frame_rate ()
 Donne la fréquence de rafraîchissement courante.
void MLV_delay_according_to_frame_rate ()
 Suspend l'exécution du programme de façon à ce que le temps écoulé depuis le drenier appel à cette fonction, soit égale à la période de la fréquence de rafraîchissement configuré par MLV_change_frame_rate.

Description détaillée

Ce fichier définit tous les prototypes des fonctions concernant la gestion du temps.

Auteur:
Adrien Boussicault
Marc Zipstein

Documentation des fonctions

void MLV_change_frame_rate ( int  rate  ) 

Configure la fréquence de rafraichissement en Hz.

La fréquence de rafraîchissement par defaut est de 100 Hz. Cela signifie que si l'on utilise MLV_delay_according_to_frame_rate() dans la boocle graphique, on obtient un rafraichissement de 100 images par secondes.

Paramètres:
rate Fréquence de rafraîchissement.
Exemples:
advanced/11_animation_book.c, et advanced/9_animation.c.
int MLV_get_date ( int *  seconds,
int *  minutes,
int *  hours,
int *  day,
int *  month,
int *  year,
int *  day_of_the_week 
)

Donne la date du jour (seconde/heure/jour/mois/annee).

L'année est donnée depuis l'an 0.

Une valeur nulle peut être passé en paramètre de la fonction. Dans ce cas, le paramètre est ignorée par la fonction.

Cette fonction utilise la fonction ctime présent dane time.h. Vous pouvez utilisez cette fonction directement à la place de MLV_get_date() Faites man time.h ou man ctime pour plus d'informations.

Paramètres:
seconds Le nombre de secondes écoulées depuis le dernier changement de minute.
minutes Le nombre de minutes écoulées depuis le dernier changement d'heure
hours Le nombre d'heures écoulées depuis minuit.
day Le quantième du mois
month Le nombre de mois écoulés depuis le début de l'année.
year Le nombre d'année depuis l'an 0.
day_of_the_week Le jour de la semaine ( 0: Lundi, 1:Mardi, ..., 6:Dimanche).
Renvoie:
Renvoie 1 si le decalage heure d'hivers-été a été pris en compte, 0 si il ne l'a pas été et -1 si l'information n'est pas disponible.
Exemples:
medium/7_time.c.
int MLV_get_frame_rate (  ) 

Donne la fréquence de rafraîchissement courante.

Renvoie:
La fréquence de rafraîchissement courante.
int MLV_get_time (  ) 

Renvoie le nombre de millisecondes écoulées depuis le début de l'initialisation de la librairie MLV ( avec MLV_create_window ).

Renvoie:
Le temps écoulé depuis l'initiaslisation de la librairies MLV.
Exemples:
medium/5_exit.c, et medium/7_time.c.
void MLV_wait_milliseconds ( int  milliseconds  ) 

Le programme s'intérompt pendant un nombre de milli-secondes.

Paramètres:
milliseconds Le nombre de milli-secondes à attendre.
void MLV_wait_seconds ( int  seconds  )