al_get_ustr_dimensions(3)

💅 al_get_ustr_dimensions(3)

okay so this page lives in the Library Functions Manual and it's about Allegro 5 API — yes, the games-and-graphics one, hi bestie 🎀

---

✨ NAME ✨

al_get_ustr_dimensions — literally the Allegro 5 API function that tells you how big your text is gonna be when it's an ALLEGRO_USTR 💖

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_font.h>

void al_get_ustr_dimensions(const ALLEGRO_FONT *f,
   ALLEGRO_USTR const *ustr,
   int *bbx, int *bby, int *bbw, int *bbh)

like… that's the whole vibe. one font, one string, four ints. slay 🫶

---

🦋 DESCRIPTION 🦋

So bestie, picture al_get_text_dimensions(3) — iconic, love her — except the text you're passing in is an ALLEGRO_USTR instead of a NUL-terminated char array. that's it. that's the whole difference. same energy, different container 💅

no cap, if you already know how al_get_text_dimensions(3) works, you already know how this works. the way that ustr just slides in where the char array was… main character energy honestly 👑

the four int pointers are your bounding-box outs — bbx, bby, bbw, bbh — so hand it somewhere to write and it'll do its thing. (they're int *, so like, actually give it real memory, not NULL, iykyk 😭)

---

🌈 SEE ALSO 🌈

• al_get_text_dimensions(3) — the NUL-terminated-char-array sibling, the OG, go read her too 💜

---

lowkey the whole page is short but she ate and left no crumbs ✨ nothing dangerous here, no deprecated nonsense, just a very chill little function fr fr 🍓

---

and that's a wrap, bestie!! this came straight from the Allegro reference manual — al_get_ustr_dimensions(3), mwah 💋🦋 see you in the next man page, bye!! 🧚‍♀️💖