al_draw_glyph(3)

Hiii bestie 💖 this is al_draw_glyph(3), living its best life in the Library Functions Manual. She’s an Allegro 5 API girlie and she draws exactly one glyph at a time, no cap.

🌸 NAME 🌸

al_draw_glyph — Allegro 5 API. One glyph. One vibe. Periodt. ✨

✨ SYNOPSIS ✨

#include <allegro5/allegro_font.h>

void al_draw_glyph(const ALLEGRO_FONT *f, ALLEGRO_COLOR color, float x, float y,
   int codepoint)

💅 DESCRIPTION 💅

Okay so al_draw_glyph draws the glyph that corresponds with codepoint, in the given color, using the given font f. If the font does not have such a glyph, nothing will be drawn — literally nothing, not even a little sparkle. 💀

To draw a string as left to right horizontal text, you will need to use al_get_glyph_advance(3) to determine the position of each glyph. For drawing strings in other directions, such as top to down, use al_get_glyph_dimensions(3) to determine the size and position of each glyph. 🦋

If you have to draw many glyphs at the same time, use al_hold_bitmap_drawing(3) with true as the parameter, before drawing the glyphs, and then call al_hold_bitmap_drawing(3) again with false as the parameter when done drawing the glyphs to further enhance performance. It’s giving “batch my glyphs, bestie” energy, and I’m obsessed. 🔥

⭐ SINCE ⭐

5.1.12 — iconic since then, fr fr. 💖

🎀 SEE ALSO 🎀

• al_get_glyph_width(3) — go read her too.
• al_get_glyph_dimensions(3) — also essential.
• al_get_glyph_advance(3) — and this queen.

Byeee 💜 from the Allegro reference manual — al_draw_glyph(3), since 5.1.12, and the footer has no date line to report, so that’s the whole tea. 🫶