al_color_xyz(3)

💖 NAME 💖

al_color_xyz — Allegro 5 API, bestie ✨

✨ SYNOPSIS ✨

#include <allegro5/allegro_color.h>

ALLEGRO_COLOR al_color_xyz(float x, float y, float z)

🎀 DESCRIPTION 🎀

Okay so this function hands you back an ALLEGRO_COLOR structure — yes, that's the ALLEGRO_COLOR(3) situation — built from XYZ values. The CIE 1931 XYZ color space has three components in the range 0..1, and that is literally the whole vibe check here.

The Y component corresponds to luminance, while the X and Z components define the color. RGB components are always assumed to be in sRGB space, no cap.

Note: The XYZ color space can represent more colors than are visible in sRGB, and therefore conversion may result in RGB values outside of the 0..1 range. You can check for that case with al_is_color_valid(3) 🫶

🌸 SINCE 🌸

This one has been iconic since 5.2.3 ✨

🦋 SEE ALSO 🦋

• al_color_xyz_to_rgb(3)
• al_color_rgb_to_xyz(3)

---

Source: <strong>Allegro reference manual</strong> · page: al_color_xyz(3) · version: since 5.2.3 · date: not printed on this page, bestie 🫶💖