al_ftofix(3)

🎀 NAME 🎀

al_ftofix — Allegro 5 API. This page is from the Library Functions Manual, bestie, and it’s giving “float goes fixed-point” energy 💅✨

🦋 SYNOPSIS 🦋

#include <allegro5/allegro.h>

al_fixed al_ftofix(double x);

🌸 DESCRIPTION 🌸

Okay so al_ftofix converts a floating point value to fixed point. Unlike al_itofix(3), this function clamps values which could overflow the type conversion, setting Allegro’s errno to ERANGE in the process if this happens. No cap, that clamp is the whole personality 🫶

Example, copied exactly because we do not mess with code:

al_fixed number;

number = al_itofix(-40000);
assert(al_fixfloor(number) == -32768);

number = al_itofix(64000);
assert(al_fixfloor(number) == 32767);
assert(!al_get_errno()); /* This will fail. */

🌈 RETURN VALUE 🌈

Returns the value of the floating point value converted to fixed point clamping overflows (and setting Allegro’s errno). So you get the converted value back, plus the errno side-eye when overflow clamping kicks in 😭✨

👑 SEE ALSO 👑

• al_fixtof(3)
• al_itofix(3)
• al_fixtoi(3)
• al_get_errno(3)

---

Source/version cutie: Allegro reference manual; page tag: al_ftofix(3); date: not listed in the footer, bestie 🫶💖