next_fli_frame(3)

💖 next_fli_frame(3) — the Allegro manual, but make it make sense 💖

okay bestie, gather round, because this one is literally from the Allegro game programming library and it's giving "flipbook but make it C" ✨

---

🌸 NAME 🌸

next_fli_frame — reads the next frame of the current animation file. 🎀

(and yes, it lives in the Allegro game programming library, that's the whole vibe 🦋)

---

✨ SYNOPSIS ✨

#include <allegro.h>

int next_fli_frame(int loop);

---

💅 DESCRIPTION 💅

So here's the tea: this function reads the next frame of the current animation file. That's it. That's the job. 🫶

Now, the loop argument? She's the main character here:

• if loop is not zero, the player will cycle when it reaches the end of the file — like a playlist on repeat, no cap 🔁
• if loop is zero, it'll just return FLI_EOF instead. bye. 🚪

And where does the frame go, you ask? It gets read into the global variables fli_bitmap and fli_palette. iconic behaviour honestly 👑

Example time, because i know you love one:

while (next_fli_frame(0) == FLI_OK) {
   /* Do stuff, like play audio stream
      or check keys to skip animation. */
   /* Rest some time until next frame... */
}

see how clean that is? the loop just keeps going until the frames run out. periodt 💅

---

🔥 RETURN VALUE 🔥

• FLI_OK — slay, it worked, success ✨
• FLI_ERROR — oops, something went wrong 😭
• FLI_NOT_OPEN — also an error, but specifically the "girl you never opened the file" kind 🙈
• FLI_EOF — you've hit the end of the file, that's all she wrote 💀

---

👀 SEE ALSO 👀

• open_fli(3)
• fli_bitmap(3)
• fli_palette(3)
• fli_timer(3)
• fli_frame(3)

go read those too, iykyk 💜

---

k that's the whole page bestie!! this was brought to you by Allegro version 4.4.3 🌈 — mwah, drink water, and don't forget to check your return values 💖✨🎀