al_create_timer(3)

💅 al_create_timer(3) 💅

okay bestie, this page is from the Library Functions Manual, and it's giving tiny time-baby energy. 🕰️✨

✨ NAME ✨

al_create_timer — the Allegro 5 API call that makes a timer for you, no cap. 🫶

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

ALLEGRO_TIMER *al_create_timer(double speed_secs)

🎀 DESCRIPTION 🎀

So this function allocates and initializes a timer. If it's successful, you get back a pointer to a new timer object; otherwise it returns NULL. 😭

speed_secs is in seconds per “tick”, and it must be positive. No zero, no negative, bestie — positive only. 💅

The new timer is initially stopped, and it needs to be started with al_start_timer(3) before ALLEGRO_EVENT_TIMER(3) events are sent. Like, it's literally asleep until you wake it up. ⏰✨

Usage note, iykyk: typical granularity is on the order of microseconds, but with some drivers it might only be milliseconds. So don't come for the timer if it's not pixel-perfect on every driver. 🦋

💖 SEE ALSO 💖

• al_start_timer(3)
• al_destroy_timer(3)

---

Signed with sparkle: source/version tag is Allegro reference manual, page tag is al_create_timer(3), and there's no extra date listed on this one — fr fr. 🌈👑