Skip to content

Latest commit

 

History

History
81 lines (51 loc) · 2.97 KB

readme.md

File metadata and controls

81 lines (51 loc) · 2.97 KB

color-spectrum stable

Convert spectrum or wavelength to color.

color-spectrum

Usage

npm install color-spectrum

const toColor = require('color-spectrum');
const fft = require('fourier-transform');

let magnitudes = fft(myData);
document.body.style.background = toColor(magnitudes);

API

**`const spectrumColor = require('color-spectrum');`**

Get spectrum to color converter.

require('color-spectrum/table') to get a table of wavelength to XYZ values.

require('color-spectrum/approx') to get approximator of wavelength to XYZ values.

**`let color = spectrumColor(list|number, options?);`**

Calculate color based off spectrum or a single wavelength value. Spectrum is a list of float values, like magnitudes or intensities, for example, a direct output from fourier-transform with real numbers. The visible range 380..780nm will be stretched to cover the passed list of intensities.

Possible options:

// Use approximation formulas or matching table interpolation
approximate: false,

// Normalize spectrum
normalize: true,

// Reference whitepoint with x,y,z values
white: xyz.whitepoint[2].D65

You can also use technical methods:

//get xyz values array for a given wavelength from 380..780 range. Use 1/λ to calc frequency.
[x, y, z] = spectrumColor.wavelength(λ, opts?);

//get xyz values for a list of magnitudes
[x, y, z] = spectrumColor.spectrum(list, opts);

//you would like to transform to rgb
let xyz = require('color-space/xyz');
let [r, g, b] = xyz.rgb(x, y, z);

References

Credits

Thanks to all the color scientists, who devoted their lives to color research and delivered their knowledge to us, for we can trust them and use their formulas and their code. Seriously, this package is just a complement to their work in js/npm format, no new scientific knowledge, just science a bit closer to practice.

In the wild

gl-waveform — color-spectrum used to paint waveform color based of spectral contents.

Related

color-space — color space conversions.
color-interpolate — interpolate color between values.