/**
* Concatenate integer color values to a string (for use in GUI objects)
*
* @param {Object} color
* @param {number} alpha
* @returns {string}
*/
function rgbToGuiColor(color, alpha)
{
let ret = "0 0 0";
if (color && ("r" in color) && ("g" in color) && ("b" in color))
ret = color.r + " " + color.g + " " + color.b;
if (alpha)
ret += " " + alpha;
return ret;
}
/**
* True if the colors are identical.
*
* @param {Object} color1
* @param {Object} color2
* @returns {boolean}
*/
function sameColor(color1, color2)
{
return color1.r === color2.r && color1.g === color2.g && color1.b === color2.b;
}
/**
* Computes the euclidian distance between the two colors.
* The smaller the return value, the close the colors. Zero if identical.
*
* @param {Object} color1
* @param {Object} color2
* @returns {number}
*/
function colorDistance(color1, color2)
{
return Math.sqrt(Math.pow(color2.r - color1.r, 2) + Math.pow(color2.g - color1.g, 2) + Math.pow(color2.b - color1.b, 2));
}
/**
* Ensure `value` is between 0 and 1.
*
* @param {number} value
* @returns {number}
*/
function clampColorValue(value)
{
return Math.abs(1 - Math.abs(value - 1));
}
/**
* Convert color value from RGB to HSL space.
*
* @see {@link http://stackoverflow.com/questions/2353211/hsl-to-rgb-color-conversion}
* @param {number} r - red
* @param {number} g - green
* @param {number} b - blue
* @returns {Array}
*/
function rgbToHsl(r, g, b)
{
r /= 255;
g /= 255;
b /= 255;
let max = Math.max(r, g, b), min = Math.min(r, g, b);
let h, s, l = (max + min) / 2;
if (max == min)
h = s = 0; // achromatic
else
{
let d = max - min;
s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
switch (max)
{
case r: h = (g - b) / d + (g < b ? 6 : 0); break;
case g: h = (b - r) / d + 2; break;
case b: h = (r - g) / d + 4; break;
}
h /= 6;
}
return [h, s, l];
}
/**
* Convert color value from HSL to RGB space.
*
* @see {@link http://stackoverflow.com/questions/2353211/hsl-to-rgb-color-conversion}
* @param {number} h - hueness
* @param {number} s - saturation
* @param {number} l - lightness
* @returns {Array}
*/
function hslToRgb(h, s, l)
{
function hue2rgb(p, q, t)
{
if (t < 0) t += 1;
if (t > 1) t -= 1;
if (t < 1/6) return p + (q - p) * 6 * t;
if (t < 1/2) return q;
if (t < 2/3) return p + (q - p) * (2/3 - t) * 6;
return p;
}
[h, s, l] = [h, s, l].map(clampColorValue);
let r, g, b;
if (s == 0)
r = g = b = l; // achromatic
else {
let q = l < 0.5 ? l * (1 + s) : l + s - l * s;
let p = 2 * l - q;
r = hue2rgb(p, q, h + 1/3);
g = hue2rgb(p, q, h);
b = hue2rgb(p, q, h - 1/3);
}
return [r, g, b].map(n => Math.round(n * 255));
}