AL_COLOR_DISTANCE_CIEDE2000(3)

💅 al_color_distance_ciede2000(3) — Library Functions Manual 💅

✨ NAME ✨

okay so the main character of this page is:

• al_color_distance_ciede2000 — Allegro 5 API

🌈 SYNOPSIS 🌈

bestie, the synopsis is literally this:

              #include <allegro5/allegro_color.h>

              double al_color_distance_ciede2000(ALLEGRO_COLOR color1,
                    ALLEGRO_COLOR color2) {

yes, that opening brace is just sitting there. we respect it. 🫶

💖 DESCRIPTION 💖

okay so al_color_distance_ciede2000 computes the CIEDE2000 color difference between two RGB colors. It’s giving visually uniform color difference, unlike for example the RGB distance. ✨

When you use the RGB distance (Euklidean distance between two RGB triplets), there can be color pairs with the same distance, where the colors of one pair appear to be almost the same color, while the colors of the other pair look quite different. not iconic. 😭

This is improved by using the L*a*b* color space, which was designed with perceptual uniformity in mind. But lowkey it still is not completely uniform. The CIEDE2000 formula contains some additional transformations to fix that. slay.

The returned color distance is roughly in the range 0 (identical color) to 1 (completely different color) — but values greater than one are possible. highkey important.

Note: This function uses al_color_lab(3) internally, which defines the L component to be in the range 0..1 (and not 0..100 as is sometimes seen). 💅

🎀 SINCE 🎀

5.2.3 — periodt. 💖

---

mwah 💋 — footer source/version: Allegro reference manual; page: al_color_d...e_ciede2000(3); date: none listed in this footer, bestie. 🎀