👁 Image
Wacton.Unicolour.Experimental 2.0.0

Unicolour.Experimental

Experimental additions to 🌈 Wacton.Unicolour

🥽 Experimental

There are additional useful features that are considered too ambiguous, indeterminate, or opinionated to be included as part of the core Unicolour library. These have been assembled in the Unicolour.Experimental project.

1. Install the package from NuGet

dotnet add package Wacton.Unicolour.Experimental

2. Import the package

using Wacton.Unicolour.Experimental;

Generate colour harmonies

Traditionally, harmonious colour combinations are based on their relationship within a colour wheel. A colour wheel can be generated using pigments or a hued colour space.

/* populate pigment k and s with measurement data */
var quinaRed = new Pigment(380, 1, k: [], s: []);
var bismuthYellow = new Pigment(380, 1, k: [], s: []);
var ceruleanBlue = new Pigment(380, 1, k: [], s: []);
var titaniumWhite = new Pigment(380, 1, k: [], s: []);
var boneBlack = new Pigment(380, 1, k: [], s: []);

var colourWheel = usePigments 
 ? ColourWheel.From(quinaRed, bismuthYellow, ceruleanBlue, titaniumWhite, boneBlack)
 : ColourWheel.From(ColourSpace.Oklch, reference: new Unicolour("ff0000"));

var orange = colourWheel.Pure(hue: 60);
var lightGreen = colourWheel.Tint(hue: 180, weight: 1);
var darkPurple = colourWheel.Shade(hue: 300, weight: 1);
var greyRed = colourWheel.Tone(hue: 0, weight: 1);

var orangePalette = colourWheel.Harmony(hue: 60, Harmony.Analogous);

Approximate pigments

A reflectance curve can be generated for any colour, approximating a single-constant pigment. This enables Kubelka-Munk pigment mixing without taking reflectance measurements. Note that, similar to metamerism, there are infinitely many reflectance curves that can generate a single colour; this will find just one. A reflectance curve can be generated for any colour, approximating a single-constant pigment. This enables Kubelka-Munk pigment mixing without taking reflectance measurements. Note that, similar to metamerism, there are infinitely many reflectance curves that can generate a single colour; this will find just one.

var redPigment = PigmentGenerator.From(new Unicolour("#FF0000"));
var bluePigment = PigmentGenerator.From(new Unicolour("#0000FF"));
var magenta = new Unicolour([redPigment, bluePigment], [0.5, 0.5]);

Emulate Spectral.js

Spectral.js uses artificial reflectance curves to perform single-constant pigment mixing. However, input concentrations are adjusted according to luminance and a custom weighting curve that the author found to give aesthetically pleasing results. This behaviour has been replicated here except 1) reflectance curves are more accurately generated at a performance cost and 2) it has been extended to be able to mix more than two colours.

var blue = new Unicolour("#0000FF");
var yellow = new Unicolour("#FFFF00");
var green = SpectralJs.Mix([blue, yellow], [0.5, 0.5]);
var palette = SpectralJs.Palette(blue, yellow, 9);

Wacton.Unicolour is licensed under the MIT License, copyright © 2022-2026 William Acton.

👁 Not by AI