AL_LOAD_TTF_FONT_STRETCH(3)

✨ al_load_ttf_font_stretch(3) ✨

ok so bestie, this one lives in the Library Functions Manual and it's literally the glow-up version of loading a font 💅

---

🌸 NAME 🌸

al_load_ttf_font_stretch — the Allegro 5 API girlie who loads your TTF fonts and lets you stretch them 🎀

---

🦋 SYNOPSIS 🦋

#include <allegro5/allegro_ttf.h>

ALLEGRO_FONT *al_load_ttf_font_stretch(char const *filename, int w, int h,
   int flags)

---

💖 DESCRIPTION 💖

okay so picture al_load_ttf_font(3)… but make it give you more 🫶 It's exactly like that function, except instead of one single size parameter it takes separate w and h parameters. Two of them. Iconic, honestly.

Here's the vibe check on how the numbers work 👑

• if h (the height) is a positive value, and w (the width) is zero or positive, then the font gets stretched according to those parameters. slay 🎀
• the width must not be negative if the height is positive. fr fr, that's a hard no 🙈
• and same energy as al_load_ttf_font(3): the height may be a negative value, which means "specify the total height in pixels" — and in that case the width must also be negative, or zero. no mixing and matching 💀

and if you get it wrong? it returns NULL 😭 specifically: if the height is positive while the width is negative, or if the height is negative while the width is positive. Those combos are not the moment, bestie.

---

⭐ SINCE ⭐

5.0.6, 5.1.0 — she's been around a minute 👑

---

🌈 SEE ALSO 🌈

• al_load_ttf_font(3) — the original, no stretch
• al_load_ttf_font_stretch_f(3) — the _f sibling ✨

---

and that's the whole page, no cap 💜 this was the Allegro reference manual dropping al_load_ttf_font_stretch(3) knowledge — go stretch something cute 🧚