gui_textout_ex(3)

💖 gui_textout_ex(3) 💖

okay so bestie, welcome to another iconic page from the Allegro manual — this one's all about gui_textout_ex, and yes it's giving very much "the little helper that makes your GUI look cute". ✨

🌸 NAME 🌸

gui_textout_ex — draws a text string onto the screen, and it handles the keyboard shortcut underbars for you. It's part of the Allegro game programming library, iykyk. 🎀

✨ SYNOPSIS ✨

#include <allegro.h>

int gui_textout_ex(BITMAP *bmp, const char *s, int x, y, color, bg,
centre);

🦋 DESCRIPTION 🦋

So this one is a helper function — like, it exists specifically for the GUI routines to use. It draws a text string onto the screen, and here's the slay part: it interprets the '&' character as an underbar, which is exactly how you show off those keyboard shortcuts in menus and buttons. 💅

It returns the width of the output string in pixels, so you can go ahead and do math with it if that's your thing. No cap. 👑

🌈 SEE ALSO 🌈

• gui_strlen(3)

and that's the whole vibe, bestie 🫶 — this page came straight out of Allegro version 4.4.3, so if you're running something else, maybe double-check. mwah, go draw some text 💖🌸✨