al_color_html(3alleg5)

💖 al_color_html — Allegro 5 API 💖

okay bestie, so this one is literally a whole page from the Allegro reference manual and it's about turning cute little hex color strings into actual colors. we love a glow-up. ✨

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_color.h>

ALLEGRO_COLOR al_color_html(char const *string)

---

🎀 DESCRIPTION 🎀

so what this does is it takes an HTML-style hex number — like #00faff, you know the vibe, very cutesy, very web-1.0 — and it interprets it as a color. that's it. that's the function. 🦋

the format it accepts? literally the exact same one that al_color_html_to_rgb(3alleg5) accepts. no cap. if you know that one you already know this one, iykyk. 💅

and then it gives you back the interpreted color. so fun. so aesthetic. 🎀

but bestie... listen. if the string could not be parsed? it returns al_map_rgba(0, 0, 0, 0). that's fully transparent black, the void, the nothingness, the no color at all. so like, if you get a see-through ghost back, that's why. 😭

⚠️ Note: the behaviour on invalid strings is different from Allegro 5.0.x. so if you're porting old code and something looks off — this is probably it. not me finding out the hard way 🙈

---

🌈 SEE ALSO 🌈

• al_color_html_to_rgb(3alleg5) — the sibling that goes html ➡️ rgb
• al_color_rgb_to_html(3alleg5) — and this one goes the other way, rgb ➡️ html, a full circle moment 👑

---

okay that's the whole page, you're literally an expert now, main character energy fr fr 💜✨

this was brought to you by the Allegro reference manual, page al_color_html(3alleg5) — go slay some hex codes bestie, ily 🫶💖