al_itofix(3)

💅 al_itofix — the Allegro 5 API glow-up

okay so bestie, we're in al_itofix(3) territory, straight out of the Allegro 5 API ✨ this one's a tiny little function but she has OPINIONS and you will hear them.

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

al_fixed al_itofix(int x);

that's it. that's the whole vibe. 🎀

---

🦋 DESCRIPTION 🦋

So what she does: she converts an integer to fixed point. That's the whole job. And it's literally the same thing as x<<16 — like, that's not a metaphor, that's the actual operation, no cap. 💅

⚠️ okay this is the part where you pay attention bestie ⚠️

Overflows are not detected. Like at all. Not even in debug builds. And underflows? Also not detected. Not even in debug builds. 😭 So:

• overflow = you're trying to convert an integer greater than 32767
• underflow = you're trying to convert an integer lesser than -32768

and instead of yelling at you, the values simply “wrap around”. iconic behaviour honestly, but also lowkey terrifying. 🙈

🌸 Example 🌸

al_fixed number;

/* This conversion is OK. */
number = al_itofix(100);
assert(al_fixtoi(number) == 100);

number = al_itofix(64000);

/* This check will fail in debug builds. */
assert(al_fixtoi(number) == 64000);

see how the first one slays and the second one is a mess? yeah. that's the wrap-around lore fr fr. the assert does NOT save you, and it will fail in debug builds — the comment literally says so. 💀

---

👑 RETURN VALUE 👑

Returns the value of the integer converted to fixed point, ignoring overflows. ignoring. overflows. she's not checking, she's not warning you, she's just handing you the number and walking away. main character energy. ⭐

---

🧚 SEE ALSO 🧚

• al_fixtoi(3)
• al_ftofix(3)
• al_fixtof(3)

the whole fixed-point friend group 🫶 go say hi.

---

🍓 also quick vibe check: this is a wrapper-level "trust me bro" situation — the over/underflow thing is real and it's documented, so don't come for me, come for the docs. 💖

---

and that's the page!! 🦋✨ brought to you by the Allegro reference manual, filed under al_itofix(3) — mwah, go convert some integers responsibly, ily 💜🎀