al_create_builtin_font(3)

💖 NAME 💖

al_create_builtin_font — Allegro 5 API. This page comes from the Library Functions Manual, and it's literally about summoning a built-in font out of thin air. Slay. ✨

🎀 SYNOPSIS 🎀

#include <allegro5/allegro_font.h>

ALLEGRO_FONT *al_create_builtin_font(void)

🌸 DESCRIPTION 🌸

Okay so al_create_builtin_font creates a monochrome bitmap font where every character is 8x8 pixels. Iconic. 💅

This font is primarily intended to be used for displaying information in environments or during early runtime states where no external font data is available or loaded — like, for debugging. It's your emergency font bestie. 🫶

The builtin font contains the following unicode character ranges:

0x0020 to 0x007F (ASCII)
0x00A1 to 0x00FF (Latin 1)
0x0100 to 0x017F (Extended A)
0x20AC to 0x20AC (euro currency symbol)

It returns NULL on an error. Not the vibe, but important. 😭

The font memory must be freed the same way as for any other font, using al_destroy_font(3). Do not ghost your fonts, bestie — clean up. 🧚

🦋 SINCE 🦋

5.0.8, 5.1.3 — so it's been around for a minute. 👑

🌈 SEE ALSO 🌈

• al_load_bitmap_font(3)
• al_destroy_font(3)

---

And that's the whole page, bestie. Sourced from the Allegro reference manual — mwah 💋✨