al_color_lch(3)

💖 NAME 💖

hey bestie!! welcome to al_color_lch(3) from the Library Functions Manual — this is the Allegro 5 API page for al_color_lch, and she’s here to turn your CIE LCH values into a color. slay. 💅✨

---

🌈 SYNOPSIS 🌈

#include <allegro5/allegro_color.h>

ALLEGRO_COLOR al_color_lch(float l, float c, float h)

---

🎀 DESCRIPTION 🎀

okay so this function returns an ALLEGRO_COLOR(3) structure from CIE LCH values. it’s giving “color conversion but make it visually uniform.” 💖

LCH colors are very similar to HSL: L and H mean the same thing, and C corresponds to S. but!! LCH is more visually uniform — highkey iconic behavior. ✨

also, important bestie: this function expects the angle for H in radians, not in degrees. no cap, do not come in here with degrees. 😭

the CIE LCH color space is a cylindrical representation of the L*a*b* color space. the L component is the same, and C and H are computed like this:

C = sqrt(a * a + b * b)
H = atan2(b, a)

---

🦋 SINCE 🦋

5.2.3 — periodt, she’s been around. 👑

---

🌸 SEE ALSO 🌸

• al_color_lch_to_rgb(3)
• al_color_rgb_to_lch(3)

---

💖 signed, sealed, delivered by the Allegro reference manual, page al_color_lch(3) — that’s the footer flex, and there’s no extra date stamped on this one. 🫶🎀