Open source CapCut alternative.
TypeScript
/**
* Perceptual color difference: 8-bit sRGB / Rec.709 display values into
* CIELAB (D65), and the CIEDE2000 difference between two Lab colors. A ΔE00
* near 1 is the smallest difference an observer sees side by side; 2–3 reads
* as the same color across a cut.
*/
import { bt1886Decode } from "./colorSpace";
export type Lab = [number, number, number];
const XN = 0.95047;
const ZN = 1.08883;
const f = (t: number) => (t > 216 / 24389 ? Math.cbrt(t) : (24389 / 27 * t + 16) / 116);
/** Display values 0..255 (Rec.709 primaries, BT.1886) → CIELAB under D65. */
export function displayToLab(r: number, g: number, b: number): Lab {
const lr = bt1886Decode(r / 255);
const lg = bt1886Decode(g / 255);
const lb = bt1886Decode(b / 255);
const x = (0.4124 * lr + 0.3576 * lg + 0.1805 * lb) / XN;
const y = 0.2126 * lr + 0.7152 * lg + 0.0722 * lb;
const z = (0.0193 * lr + 0.1192 * lg + 0.9505 * lb) / ZN;
const fy = f(y);
return [116 * fy - 16, 500 * (f(x) - fy), 200 * (fy - f(z))];
}
/** Chroma and hue angle (degrees, 0..360) of a Lab color. */
export function labChromaHue(lab: Lab): { c: number; h: number } {
const h = (Math.atan2(lab[2], lab[1]) * 180) / Math.PI;
return { c: Math.hypot(lab[1], lab[2]), h: h < 0 ? h + 360 : h };
}
const rad = (d: number) => (d * Math.PI) / 180;
const deg = (r: number) => (r * 180) / Math.PI;
/** CIEDE2000 (Sharma, Wu and Dalal's statement of the formula). */
export function deltaE2000(p: Lab, q: Lab): number {
const [L1, a1, b1] = p;
const [L2, a2, b2] = q;
const C1 = Math.hypot(a1, b1);
const C2 = Math.hypot(a2, b2);
const Cm = (C1 + C2) / 2;
const G = 0.5 * (1 - Math.sqrt(Cm ** 7 / (Cm ** 7 + 25 ** 7)));
const a1p = (1 + G) * a1;
const a2p = (1 + G) * a2;
const C1p = Math.hypot(a1p, b1);
const C2p = Math.hypot(a2p, b2);
const hue = (b: number, a: number) => {
if (!a && !b) return 0;
const h = deg(Math.atan2(b, a));
return h < 0 ? h + 360 : h;
};
const h1p = hue(b1, a1p);
const h2p = hue(b2, a2p);
const dLp = L2 - L1;
const dCp = C2p - C1p;
let dhp = 0;
if (C1p * C2p) {
dhp = h2p - h1p;
if (dhp > 180) dhp -= 360;
else if (dhp < -180) dhp += 360;
}
const dHp = 2 * Math.sqrt(C1p * C2p) * Math.sin(rad(dhp / 2));
const Lpm = (L1 + L2) / 2;
const Cpm = (C1p + C2p) / 2;
let hpm = h1p + h2p;
if (C1p * C2p) {
if (Math.abs(h1p - h2p) <= 180) hpm = (h1p + h2p) / 2;
else hpm = h1p + h2p < 360 ? (h1p + h2p + 360) / 2 : (h1p + h2p - 360) / 2;
}
const T =
1 -
0.17 * Math.cos(rad(hpm - 30)) +
0.24 * Math.cos(rad(2 * hpm)) +
0.32 * Math.cos(rad(3 * hpm + 6)) -
0.2 * Math.cos(rad(4 * hpm - 63));
const dTheta = 30 * Math.exp(-(((hpm - 275) / 25) ** 2));
const Rc = 2 * Math.sqrt(Cpm ** 7 / (Cpm ** 7 + 25 ** 7));
const Sl = 1 + (0.015 * (Lpm - 50) ** 2) / Math.sqrt(20 + (Lpm - 50) ** 2);
const Sc = 1 + 0.045 * Cpm;
const Sh = 1 + 0.015 * Cpm * T;
const Rt = -Math.sin(rad(2 * dTheta)) * Rc;
return Math.sqrt(
(dLp / Sl) ** 2 + (dCp / Sc) ** 2 + (dHp / Sh) ** 2 + Rt * (dCp / Sc) * (dHp / Sh)
);
}