Documentation de la bibliothèque MLV-1.2.1

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 donné en paramètre. Plus de détails...
 
void MLV_wait_seconds (int seconds)
 Le programme s'intérompt pendant un nombre de secondes. Plus de détails...
 
int MLV_get_time ()
 Renvoie le nombre de millisecondes écoulées depuis le début de l'initialisation de la bibliothèque MLV ( avec MLV_create_window ). Plus de détails...
 
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). Plus de détails...
 
void MLV_change_frame_rate (int rate)
 Configure la fréquence de rafraichissement en Hz. Plus de détails...
 
int MLV_get_frame_rate ()
 Donne la fréquence de rafraîchissement courante. Plus de détails...
 
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() entre chaque rafraîchissement de la fenêtre graphique, on obtient un rafraichissement de 100 images par secondes.

Paramètres
rateFréquence de rafraîchissement.
Exemples:
advanced/09_animation.c, et advanced/11_animation_book.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ée en paramètre de la fonction. Dans ce cas, le paramètre est ignoré par la fonction.

Paramètres
secondsLe nombre de secondes écoulées depuis le dernier changement de minute.
minutesLe nombre de minutes écoulées depuis le dernier changement d'heure
hoursLe nombre d'heures écoulées depuis minuit.
dayLe quantième du mois.
monthLe nombre de mois écoulés depuis le début de l'année.
yearLe nombre d'années depuis l'an 0.
day_of_the_weekLe jour de la semaine ( 0: Lundi, 1:Mardi, ..., 6:Dimanche).
Renvoie
Renvoie 1 si le décalage heure d'hivers et heure d'é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/07_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 bibliothèque MLV ( avec MLV_create_window ).

Renvoie
Le temps écoulé depuis l'initialisation de la bibliothèque MLV.
Exemples:
medium/05_exit.c, et medium/07_time.c.
void MLV_wait_milliseconds ( int  milliseconds)

Le programme s'intérompt pendant un nombre de milli-secondes donné en paramètre.

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