al_color_lab(3)

🎀 NAME 🎀

okay bestie, this is al_color_lab(3) from the Library Functions Manual — it's part of the Allegro 5 API, and it's literally the function for turning CIE L*a*b* values into an ALLEGRO_COLOR(3). slay.

✨ SYNOPSIS ✨

#include <allegro5/allegro_color.h>

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

🌸 DESCRIPTION 🌸

So here's the tea: al_color_lab returns an ALLEGRO_COLOR(3) structure from CIE L*a*b* values. The L* component corresponds to luminance from 0..1, babe. The a* and b* components are in the range -1..+1. periodt.

Note: The L*a*b* color space can represent more colors than are visible in sRGB, so conversion may result in RGB values outside of the 0..1 range. You can check for that case with al_is_color_valid(3). not me warning you ahead of time 💅

Note: In some literature the range of L* is 0 to 100 and a* and b* are from -100 to +100. In that case divide all components by 100 before passing them to this function. math girlies, this one's for you 🧮✨

⭐ SINCE ⭐

5.2.3 — yes, it's been iconic since 5.2.3, no cap.

🦋 SEE ALSO 🦋

• al_color_lab_to_rgb(3)
• al_color_rgb_to_lab(3)

---

💖 and that's the whole page, bestie — from the Allegro reference manual, page al_color_lab(3), and the footer had no date so I'm not inventing one 💀 cute sign-off complete 🫶