Wide-gamut & gamut mapping
v3 preserves wide-gamut inputs losslessly. A P3 red stays in P3 until you explicitly convert or gamut-map it.
const p3 = swatch("color(display-p3 1 0 0)");
p3.space; // "display-p3"
p3.coords; // [1, 0, 0]
p3.srgb; // { r: 1.093, g: -0.227, b: -0.150 } — out of range!Wide-gamut spaces
| Space | Getter | Primaries |
|---|---|---|
| Display P3 | c.displayP3 |
DCI-P3 with D65 white |
| Rec. 2020 | c.rec2020 |
ITU-R BT.2020 |
| Adobe RGB 1998 | c.a98 |
Adobe RGB (1998) |
| ProPhoto RGB | c.prophoto |
ROMM RGB, D50 white (Bradford CAT to D65) |
Gamut checking
c.inGamut("srgb"); // true/false
c.inGamut("display-p3");Gamut mapping
c.toGamut(); // default: CSS4 chroma reduction in sRGB
c.toGamut({ space: "srgb" }); // explicit target
c.toGamut({ space: "srgb", method: "clip" });
c.toGamut({ space: "srgb", method: "css4" });
c.toGamut({ space: "display-p3", method: "css4" });Methods
| Method | Description |
|---|---|
css4 |
CSS Color 4 binary chroma reduction in OKLCh (default) |
oklch-chroma |
Alias for css4 |
clip |
Hard clamp to [0, 1] per channel |
Always use .toGamut() before converting wide-gamut colors to hex or sRGB CSS
for display.