itofix(3alleg4)

💖 itofix 💖

okay bestie, welcome to the Allegro manual, page itofix(3alleg4) 🎀 — yeah it's a whole section-3 library function, not a command, we're doing C today, slay.

✨ NAME ✨

itofix — converts an integer to fixed point. it's part of the Allegro game programming library, iykyk 🦋

🌸 SYNOPSIS 🌸

#include <allegro.h>

fixed itofix(int x);

that's it. one include, one function, no drama 💅

🧚 DESCRIPTION 🧚

so like, itofix takes your regular boring integer and turns it into a fixed point value. literally the exact same thing as writing x<<16. that's the whole vibe, no cap ✨

⚠️ but bestie, listen, this is the important part: overflows (aka trying to convert an integer greater than 32767) and underflows (aka trying to convert an integer lesser than -32768) are NOT detected, not even in debug builds!! 😭 the values just simply "wrap around". no warning, no error, no nothing. she just does it and moves on, main character energy fr fr.

here's the example so you can see it with your own eyes 👀:

fixed number;
/* This conversion is OK. */
number = itofix(100);
ASSERT(fixtoi(number) == 100);
number = itofix(64000);
/* This check will fail in debug builds. */
ASSERT(fixtoi(number) == 64000);

see how the second one is giving chaos? 64000 is way over 32767 so that ASSERT goes down in flames even in debug builds 💀 wrap-around moment.

🫶 RETURN VALUE 🫶

returns the value of the integer converted to fixed point, ignoring overflows. she said "i'm not checking that" and honestly? respect 💅

🌈 SEE ALSO 🌈

the whole friend group, go say hi:

• fixtoi(3alleg4)
• ftofix(3alleg4)
• fixtof(3alleg4)
• ex12bit(3alleg4)
• ex3buf(3alleg4)
• ex3d(3alleg4)
• exblend(3alleg4)
• excustom(3alleg4)
• exfixed(3alleg4)
• exlights(3alleg4)
• exspline(3alleg4)
• exsprite(3alleg4)
• exstars(3alleg4)

and that's the page, bestie!! 🎀 this was Allegro, version 4.4.3, page itofix(3alleg4) — go forth and convert your integers, but please, for the love of everything, keep them between -32768 and 32767 🙈💖 mwah, bye!! ✨🦋👑