al_get_text_dimensions(3)

al_get_text_dimensions(3) 💅✨

okay bestie, welcome to the Allegro reference manual page for al_get_text_dimensions — she’s giving “I know exactly where your text bounding box lives” energy 🎀

---

🌸 NAME 🌸

al_get_text_dimensions — Allegro 5 API, and yes she’s here to spill the dimensions 💅

---

✨ SYNOPSIS ✨

              #include <allegro5/allegro_font.h>

              void al_get_text_dimensions(const ALLEGRO_FONT *f,
                 char const *text,
                 int *bbx, int *bby, int *bbw, int *bbh)

---

💖 DESCRIPTION 💖

Sometimes, al_get_text_width(3) and al_get_font_line_height(3) are literally not enough for exact text placement, so this function returns some additional information. That’s the whole gig, no cap 🫶

Returned variables (all in pixels):

• x, y — offset to upper left corner of bounding box.
• w, h — dimensions of bounding box.

⚠️ Note that glyphs may go to the left and upwards of the X, in which case x and y will have negative values. So yeah, negative numbers can absolutely show up — she’s not bugging, that’s just the bounding box being real 😭

---

🦋 SEE ALSO 🦋

• al_get_text_width(3)
• al_get_font_line_height(3)
• al_get_ustr_dimensions(3)

---

source/version: Allegro reference manual; date: not listed on this page, so no fake timestamp energy here — that’s all she wrote, bestie 💖🎀✨