transpose_font(3alleg4)

💖 transpose_font 💖

ok so real talk — this is transpose_font from the Allegro manual, aka the Allegro game programming library. and bestie, it's giving font-glow-up energy ✨

🎀 SYNOPSIS 🎀

#include <allegro.h>

int transpose_font(FONT *f, int drange)

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — transpose_font takes every single character in a font and transposes them all, which basically remaps the whole font. like a whole personality transplant for your glyphs, no cap 💅

example time, because iykyk:

FONT *myfont;
FONT *capitals;
...
/* Create a font of only capital letters */
capitals = extract_font_range(myfont, 'A', 'Z');

/* Now transpose the characters in the font so that they will be used */
/*  for the lower case letters a-z */
transpose_font(capitals, 'a'-'A');
textout_ex(screen, capitals, "allcaps",
           100, 100, makecol(255,255,255), 0);

see how that works? you pull out just the capitals with extract_font_range(myfont, 'A', 'Z'), then transpose_font(capitals, 'a'-'A') shifts everything over so those capital glyphs get used for the lowercase letters a-z instead. iconic behaviour honestly 👑

⭐ RETURN VALUE ⭐

• returns 0 when it ate 💅 (success)
• returns -1 when it did not eat 😭 (failure)

🌈 SEE ALSO 🌈

• get_font_range_begin(3alleg4)
• get_font_range_end(3alleg4)
• merge_fonts(3alleg4)
• extract_font_range(3alleg4)

k bye bestie, go transpose some fonts 💜 this was transpose_font(3alleg4) from the Allegro manual, version 4.4.3 — mwah, drink water, and remember that even fonts deserve a fresh start 🫶✨