Time routines

ALLEGRO_TIMEOUT

typedef struct ALLEGRO_TIMEOUT ALLEGRO_TIMEOUT;

Represent a timeout value. The size of the structure is known so can be statically allocated. The contents are private.

al_current_time

AL_FUNC(double, al_current_time, (void));

Return the number of seconds since the Allegro library was initialised. The return value is undefined if Allegro is uninitialised. The resolution depends on the used driver, but typically can be in the order of microseconds.

al_init_timeout

AL_FUNC(void, al_init_timeout, (ALLEGRO_TIMEOUT *timeout, double seconds));

Set timeout value of some number of seconds after the function call.

al_rest

AL_FUNC(void, al_rest, (double seconds));

Waits for the specified number seconds. This tells the system to pause the current thread for the given amount of time. With some operating systems, the accuracy can be in the order of 10ms. That is, even

al_rest(0.000001)

might pause for something like 10ms. Also see the section on easier ways to time your program without using up all CPU.