'use strict'; /** * This code is mostly from the old Etherpad. Please help us to comment this code. * This helps other people to understand this code better and helps them to improve it. * TL;DR COMMENTS ON THIS FILE ARE HIGHLY APPRECIATED */ // DO NOT EDIT THIS FILE, edit infrastructure/ace/www/colorutils.js // THIS FILE IS ALSO SERVED AS CLIENT-SIDE JS /** * Copyright 2009 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS-IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ const colorutils = {}; // Check that a given value is a css hex color value, e.g. // "#ffffff" or "#fff" colorutils.isCssHex = (cssColor) => /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.test(cssColor); // "#ffffff" or "#fff" or "ffffff" or "fff" to [1.0, 1.0, 1.0] colorutils.css2triple = (cssColor) => { const sixHex = colorutils.css2sixhex(cssColor); const hexToFloat = (hh) => Number(`0x${hh}`) / 255; return [ hexToFloat(sixHex.substr(0, 2)), hexToFloat(sixHex.substr(2, 2)), hexToFloat(sixHex.substr(4, 2)), ]; }; // "#ffffff" or "#fff" or "ffffff" or "fff" to "ffffff" colorutils.css2sixhex = (cssColor) => { let h = /[0-9a-fA-F]+/.exec(cssColor)[0]; if (h.length !== 6) { const a = h.charAt(0); const b = h.charAt(1); const c = h.charAt(2); h = a + a + b + b + c + c; } return h; }; // [1.0, 1.0, 1.0] -> "#ffffff" colorutils.triple2css = (triple) => { const floatToHex = (n) => { const n2 = colorutils.clamp(Math.round(n * 255), 0, 255); return (`0${n2.toString(16)}`).slice(-2); }; return `#${floatToHex(triple[0])}${floatToHex(triple[1])}${floatToHex(triple[2])}`; }; colorutils.clamp = (v, bot, top) => v < bot ? bot : (v > top ? top : v); colorutils.min3 = (a, b, c) => (a < b) ? (a < c ? a : c) : (b < c ? b : c); colorutils.max3 = (a, b, c) => (a > b) ? (a > c ? a : c) : (b > c ? b : c); colorutils.colorMin = (c) => colorutils.min3(c[0], c[1], c[2]); colorutils.colorMax = (c) => colorutils.max3(c[0], c[1], c[2]); colorutils.scale = (v, bot, top) => colorutils.clamp(bot + v * (top - bot), 0, 1); colorutils.unscale = (v, bot, top) => colorutils.clamp((v - bot) / (top - bot), 0, 1); colorutils.scaleColor = (c, bot, top) => [ colorutils.scale(c[0], bot, top), colorutils.scale(c[1], bot, top), colorutils.scale(c[2], bot, top), ]; colorutils.unscaleColor = (c, bot, top) => [ colorutils.unscale(c[0], bot, top), colorutils.unscale(c[1], bot, top), colorutils.unscale(c[2], bot, top), ]; // rule of thumb for RGB brightness; 1.0 is white colorutils.luminosity = (c) => c[0] * 0.30 + c[1] * 0.59 + c[2] * 0.11; colorutils.saturate = (c) => { const min = colorutils.colorMin(c); const max = colorutils.colorMax(c); if (max - min <= 0) return [1.0, 1.0, 1.0]; return colorutils.unscaleColor(c, min, max); }; colorutils.blend = (c1, c2, t) => [ colorutils.scale(t, c1[0], c2[0]), colorutils.scale(t, c1[1], c2[1]), colorutils.scale(t, c1[2], c2[2]), ]; colorutils.invert = (c) => [1 - c[0], 1 - c[1], 1 - c[2]]; colorutils.complementary = (c) => { const inv = colorutils.invert(c); return [ (inv[0] >= c[0]) ? Math.min(inv[0] * 1.30, 1) : (c[0] * 0.30), (inv[1] >= c[1]) ? Math.min(inv[1] * 1.59, 1) : (c[1] * 0.59), (inv[2] >= c[2]) ? Math.min(inv[2] * 1.11, 1) : (c[2] * 0.11), ]; }; colorutils.textColorFromBackgroundColor = (bgcolor, skinName) => { const white = skinName === 'colibris' ? 'var(--super-light-color)' : '#fff'; const black = skinName === 'colibris' ? 'var(--super-dark-color)' : '#222'; return colorutils.luminosity(colorutils.css2triple(bgcolor)) < 0.5 ? white : black; }; exports.colorutils = colorutils;