al_color_lab(3alleg5)

💖 al_color_lab — the Allegro 5 API manual page, bestie edition 💖

okay so welcome to the Allegro 5 API reference manual, section 3alleg5, and today's main character is al_color_lab. she converts color spaces. she's lowkey iconic. let's get into it 🎀

---

✨ NAME ✨

al_color_lab — the Allegro 5 API function that hands you a color straight out of CIE L*a*b* land 🦋

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_color.h>

ALLEGRO_COLOR al_color_lab(float l, float a, float b)

like, that's the whole vibe. three floats in, one color out. periodt 💅

---

✨ DESCRIPTION ✨

So basically this function returns an ALLEGRO_COLOR(3alleg5) structure built from CIE L*a*b* values. 🎨

Here's the breakdown, bestie:

• The L* component is your luminance, and it goes from 0..1.
• The a* and b* components hang out in the range -1..+1.

Note: ⚠️ the L*a*b* color space can represent more colors than are actually visible in sRGB, so the conversion might give you RGB values that land outside the 0..1 range. not a bug, just the color space being extra. you can check whether that happened with al_is_color_valid(3alleg5). 🕵️♀️

Note: 📚 in some literature the range of L* is 0 to 100, and a* and b* go from -100 to +100. if that's the version of the math you're working with, just divide all the components by 100 before passing them into this function. no cap. 💯

---

✨ SINCE ✨

5.2.3 — she's been here since then, serving color conversions with zero complaints 👑

---

✨ SEE ALSO ✨

• al_color_lab_to_rgb(3alleg5)
• al_color_rgb_to_lab(3alleg5)

go read those too, they're her besties 🫶

---

and that's the whole page!! this came from the Allegro reference manual, al_color_lab(3alleg5) edition — you're welcome, go make something pretty with it 💜✨🌸