summaryrefslogtreecommitdiff
path: root/libs/gtkmm2ext/colors.cc
diff options
context:
space:
mode:
Diffstat (limited to 'libs/gtkmm2ext/colors.cc')
-rw-r--r--libs/gtkmm2ext/colors.cc700
1 files changed, 700 insertions, 0 deletions
diff --git a/libs/gtkmm2ext/colors.cc b/libs/gtkmm2ext/colors.cc
new file mode 100644
index 0000000000..73cf061899
--- /dev/null
+++ b/libs/gtkmm2ext/colors.cc
@@ -0,0 +1,700 @@
+/*
+ Copyright (C) 2014 Paul Davis
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+*/
+
+#include <algorithm>
+#include <sstream>
+#include <cmath>
+#include <stdint.h>
+#include <cfloat>
+
+#include "pbd/failed_constructor.h"
+#include "pbd/string_convert.h"
+
+#include "gtkmm2ext/colors.h"
+#include "gtkmm2ext/colorspace.h"
+
+using namespace std;
+using namespace Gtkmm2ext;
+
+using std::max;
+using std::min;
+
+Gtkmm2ext::Color
+Gtkmm2ext::change_alpha (Color c, double a)
+{
+ return ((c & ~0xff) | (lrintf (a*255.0) & 0xff));
+}
+
+void
+Gtkmm2ext::color_to_hsv (Color color, double& h, double& s, double& v)
+{
+ double a;
+ color_to_hsva (color, h, s, v, a);
+}
+
+void
+Gtkmm2ext::color_to_hsva (Color color, double& h, double& s, double& v, double& a)
+{
+ double r, g, b;
+ double cmax;
+ double cmin;
+ double delta;
+
+ color_to_rgba (color, r, g, b, a);
+
+ if (r > g) {
+ cmax = max (r, b);
+ } else {
+ cmax = max (g, b);
+ }
+
+ if (r < g) {
+ cmin = min (r, b);
+ } else {
+ cmin = min (g, b);
+ }
+
+ v = cmax;
+
+ delta = cmax - cmin;
+
+ if (cmax == 0) {
+ // r = g = b == 0 ... v is undefined, s = 0
+ s = 0.0;
+ h = 0.0;
+ return;
+ }
+
+ if (delta != 0.0) {
+ if (cmax == r) {
+ h = fmod ((g - b)/delta, 6.0);
+ } else if (cmax == g) {
+ h = ((b - r)/delta) + 2;
+ } else {
+ h = ((r - g)/delta) + 4;
+ }
+
+ h *= 60.0;
+
+ if (h < 0.0) {
+ /* negative values are legal but confusing, because
+ they alias positive values.
+ */
+ h = 360 + h;
+ }
+ }
+
+ if (delta == 0 || cmax == 0) {
+ s = 0;
+ } else {
+ s = delta / cmax;
+ }
+}
+
+Gtkmm2ext::Color
+Gtkmm2ext::hsva_to_color (double h, double s, double v, double a)
+{
+ s = min (1.0, max (0.0, s));
+ v = min (1.0, max (0.0, v));
+
+ if (s == 0) {
+ return rgba_to_color (v, v, v, a);
+ }
+
+ h = fmod (h + 360.0, 360.0);
+
+ double c = v * s;
+ double x = c * (1.0 - fabs(fmod(h / 60.0, 2) - 1.0));
+ double m = v - c;
+
+ if (h >= 0.0 && h < 60.0) {
+ return rgba_to_color (c + m, x + m, m, a);
+ } else if (h >= 60.0 && h < 120.0) {
+ return rgba_to_color (x + m, c + m, m, a);
+ } else if (h >= 120.0 && h < 180.0) {
+ return rgba_to_color (m, c + m, x + m, a);
+ } else if (h >= 180.0 && h < 240.0) {
+ return rgba_to_color (m, x + m, c + m, a);
+ } else if (h >= 240.0 && h < 300.0) {
+ return rgba_to_color (x + m, m, c + m, a);
+ } else if (h >= 300.0 && h < 360.0) {
+ return rgba_to_color (c + m, m, x + m, a);
+ }
+ return rgba_to_color (m, m, m, a);
+}
+
+void
+Gtkmm2ext::color_to_rgba (Color color, double& r, double& g, double& b, double& a)
+{
+ r = ((color >> 24) & 0xff) / 255.0;
+ g = ((color >> 16) & 0xff) / 255.0;
+ b = ((color >> 8) & 0xff) / 255.0;
+ a = ((color >> 0) & 0xff) / 255.0;
+}
+
+Gtkmm2ext::Color
+Gtkmm2ext::rgba_to_color (double r, double g, double b, double a)
+{
+ /* clamp to [0 .. 1] range */
+
+ r = min (1.0, max (0.0, r));
+ g = min (1.0, max (0.0, g));
+ b = min (1.0, max (0.0, b));
+ a = min (1.0, max (0.0, a));
+
+ /* convert to [0..255] range */
+
+ unsigned int rc, gc, bc, ac;
+ rc = rint (r * 255.0);
+ gc = rint (g * 255.0);
+ bc = rint (b * 255.0);
+ ac = rint (a * 255.0);
+
+ /* build-an-integer */
+
+ return (rc << 24) | (gc << 16) | (bc << 8) | ac;
+}
+
+// Inverse of sRGB "gamma" function.
+static inline double
+inv_gam_sRGB (double c)
+{
+ if (c <= 0.04045) {
+ return c/12.92;
+ } else {
+ return pow(((c+0.055)/(1.055)),2.4);
+ }
+}
+
+// sRGB "gamma" function
+static inline int
+gam_sRGB(double v)
+{
+ if (v <= 0.0031308) {
+ v *= 12.92;
+ } else {
+ v = 1.055 * pow (v, 1.0 / 2.4) - 0.055;
+ }
+ return int (v*255+.5);
+}
+
+static double
+luminance (uint32_t c)
+{
+ // sRGB luminance(Y) values
+ const double rY = 0.212655;
+ const double gY = 0.715158;
+ const double bY = 0.072187;
+
+ double r, g, b, a;
+
+ Gtkmm2ext::color_to_rgba (c, r, g, b, a);
+
+ return (gam_sRGB (rY*inv_gam_sRGB(r) + gY*inv_gam_sRGB(g) + bY*inv_gam_sRGB(b))) / 255.0;
+}
+
+uint32_t
+Gtkmm2ext::contrasting_text_color (uint32_t c)
+{
+ /* use a slightly off-white... XXX should really look this up */
+
+ static const uint32_t white = Gtkmm2ext::rgba_to_color (0.98, 0.98, 0.98, 1.0);
+ static const uint32_t black = Gtkmm2ext::rgba_to_color (0.0, 0.0, 0.0, 1.0);
+
+ return (luminance (c) < 0.50) ? white : black;
+}
+
+
+
+HSV::HSV ()
+ : h (0.0)
+ , s (1.0)
+ , v (1.0)
+ , a (1.0)
+{
+}
+
+HSV::HSV (double hh, double ss, double vv, double aa)
+ : h (hh)
+ , s (ss)
+ , v (vv)
+ , a (aa)
+{
+ if (h < 0.0) {
+ /* normalize negative hue values into positive range */
+ h = 360.0 + h;
+ }
+}
+
+HSV::HSV (Color c)
+{
+ color_to_hsva (c, h, s, v, a);
+}
+
+string
+HSV::to_string () const
+{
+ stringstream ss;
+ ss << PBD::to_string(h) << ' ';
+ ss << PBD::to_string(s) << ' ';
+ ss << PBD::to_string(v) << ' ';
+ ss << PBD::to_string(a);
+ return ss.str();
+}
+
+bool
+HSV::is_gray () const
+{
+ return s == 0;
+}
+
+void
+HSV::clamp ()
+{
+ h = fmod (h, 360.0);
+ if (h < 0.0) {
+ /* normalize negative hue values into positive range */
+ h = 360.0 + h;
+ }
+ s = min (1.0, s);
+ v = min (1.0, v);
+ a = min (1.0, a);
+}
+
+HSV
+HSV::operator+ (const HSV& operand) const
+{
+ HSV hsv;
+ hsv.h = h + operand.h;
+ hsv.s = s + operand.s;
+ hsv.v = v + operand.v;
+ hsv.a = a + operand.a;
+ hsv.clamp ();
+ return hsv;
+}
+
+HSV
+HSV::operator- (const HSV& operand) const
+{
+ HSV hsv;
+ hsv.h = h - operand.h;
+ hsv.s = s - operand.s;
+ hsv.v = s - operand.v;
+ hsv.a = a - operand.a;
+ hsv.clamp ();
+ return hsv;
+}
+
+HSV&
+HSV::operator=(Color c)
+{
+ color_to_hsva (c, h, s, v, a);
+ clamp ();
+ return *this;
+}
+
+HSV&
+HSV::operator=(const std::string& str)
+{
+ uint32_t c;
+ c = strtol (str.c_str(), 0, 16);
+ color_to_hsva (c, h, s, v, a);
+ clamp ();
+ return *this;
+}
+
+bool
+HSV::operator== (const HSV& other)
+{
+ return h == other.h &&
+ s == other.s &&
+ v == other.v &&
+ a == other.a;
+}
+
+HSV
+HSV::shade (double factor) const
+{
+ HSV hsv (*this);
+
+ /* algorithm derived from a google palette website
+ and analysis of their color palettes.
+
+ basic rule: to make a color darker, increase its saturation
+ until it reaches 88%, but then additionally reduce value/lightness
+ by a larger amount.
+
+ invert rule to make a color lighter.
+ */
+
+ if (factor > 1.0) {
+ if (s < 88) {
+ hsv.v += (hsv.v * (factor * 10.0));
+ }
+ hsv.s *= factor;
+ } else {
+ if (s < 88) {
+ hsv.v -= (hsv.v * (factor * 10.0));
+ }
+ hsv.s *= factor;
+ }
+
+ hsv.clamp();
+
+ return hsv;
+}
+
+HSV
+HSV::outline () const
+{
+ if (luminance (color()) < 0.50) {
+ /* light color, darker outline: black with 15% opacity */
+ return HSV (0.0, 0.0, 0.0, 0.15);
+ } else {
+ /* dark color, lighter outline: white with 15% opacity */
+ return HSV (0.0, 0.0, 1.0, 0.15);
+ }
+}
+
+HSV
+HSV::mix (const HSV& other, double amount) const
+{
+ HSV hsv;
+
+ hsv.h = h + (amount * (other.h - h));
+ hsv.v = v + (amount * (other.s - s));
+ hsv.s = s + (amount * (other.v - v));
+
+ hsv.clamp();
+
+ return hsv;
+}
+
+HSV
+HSV::delta (const HSV& other) const
+{
+ HSV d;
+
+ if (is_gray() && other.is_gray()) {
+ d.h = 0.0;
+ d.s = 0.0;
+ d.v = v - other.v;
+ } else {
+ d.h = h - other.h;
+ d.s = s - other.s;
+ d.v = v - other.v;
+ }
+ d.a = a - other.a;
+ /* do not clamp - we are returning a delta */
+ return d;
+}
+
+double
+HSV::distance (const HSV& other) const
+{
+ if (is_gray() && other.is_gray()) {
+ /* human color perception of achromatics generates about 450
+ distinct colors. By contrast, CIE94 could give a maximal
+ perceptual distance of sqrt ((360^2) + 1 + 1) = 360. The 450
+ are not evenly spread (Webers Law), so lets use 360 as an
+ approximation of the number of distinct achromatics.
+
+ So, scale up the achromatic difference to give about
+ a maximal distance between v = 1.0 and v = 0.0 of 360.
+
+ A difference of about 0.0055 will generate a return value of
+ 2, which is roughly the limit of human perceptual
+ discrimination for chromatics.
+ */
+ return fabs (360.0 * (v - other.v));
+ }
+
+ if (is_gray() != other.is_gray()) {
+ /* no comparison possible */
+ return DBL_MAX;
+ }
+
+ /* Use CIE94 definition for now */
+
+ double sL, sA, sB;
+ double oL, oA, oB;
+ double r, g, b, alpha; // Careful, "a" is a field of this
+ Color c;
+
+ c = hsva_to_color (h, s, v, a);
+ color_to_rgba (c, r, g, b, alpha);
+ Rgb2Lab (&sL, &sA, &sB, r, g, b);
+
+ c = hsva_to_color (other.h, other.s, other.v, other.a);
+ color_to_rgba (c, r, g, b, alpha);
+ Rgb2Lab (&oL, &oA, &oB, r, g, b);
+
+ // Weighting factors depending on the application (1 = default)
+
+ const double whtL = 1.0;
+ const double whtC = 1.0;
+ const double whtH = 1.0;
+
+ const double xC1 = sqrt ((sA * sA) + (sB * oB));
+ const double xC2 = sqrt ((oA * oA) + (oB * oB));
+ double xDL = oL - sL;
+ double xDC = xC2 - xC1;
+ const double xDE = sqrt (((sL - oL) * (sL - oL))
+ + ((sA - oA) * (sA - oA))
+ + ((sB - oB) * (sB - oB)));
+
+ double xDH;
+
+ if (sqrt (xDE) > (sqrt (abs (xDL)) + sqrt (abs (xDC)))) {
+ xDH = sqrt ((xDE * xDE) - (xDL * xDL) - (xDC * xDC));
+ } else {
+ xDH = 0;
+ }
+
+ const double xSC = 1 + (0.045 * xC1);
+ const double xSH = 1 + (0.015 * xC1);
+
+ xDL /= whtL;
+ xDC /= whtC * xSC;
+ xDH /= whtH * xSH;
+
+ return sqrt ((xDL * xDL) + (xDC * xDC) + (xDH * xDH));
+}
+
+HSV
+HSV::opposite () const
+{
+ HSV hsv (*this);
+ hsv.h = fmod (h + 180.0, 360.0);
+ return hsv;
+}
+
+HSV
+HSV::bw_text () const
+{
+ return HSV (contrasting_text_color (color()));
+}
+
+HSV
+HSV::text () const
+{
+ return opposite ();
+}
+
+HSV
+HSV::selected () const
+{
+ /* XXX hack */
+ return HSV (Color (0xff0000));
+}
+
+
+void
+HSV::print (std::ostream& o) const
+{
+ if (!is_gray()) {
+ o << '(' << h << ',' << s << ',' << v << ',' << a << ')';
+ } else {
+ o << "gray(" << v << ')';
+ }
+}
+
+
+std::ostream& operator<<(std::ostream& o, const Gtkmm2ext::HSV& hsv) { hsv.print (o); return o; }
+
+HSV
+HSV::mod (SVAModifier const & svam)
+{
+ return svam (*this);
+}
+
+SVAModifier::SVAModifier (string const &str)
+ : type (Add)
+ , _s (0)
+ , _v (0)
+ , _a (0)
+{
+ from_string (str);
+}
+
+void
+SVAModifier::from_string (string const & str)
+{
+ char op;
+ stringstream ss (str);
+ string mod;
+
+ ss >> op;
+
+ switch (op) {
+ case '*':
+ type = Multiply;
+ /* no-op values for multiply */
+ _s = 1.0;
+ _v = 1.0;
+ _a = 1.0;
+ break;
+ case '+':
+ type = Add;
+ /* no-op values for add */
+ _s = 0.0;
+ _v = 0.0;
+ _a = 0.0;
+ break;
+ case '=':
+ type = Assign;
+ /* this will avoid assignment in operator() (see below) */
+ _s = -1.0;
+ _v = -1.0;
+ _a = -1.0;
+ break;
+ default:
+ throw failed_constructor ();
+ }
+
+ string::size_type pos;
+
+ while (ss) {
+ ss >> mod;
+ if ((pos = mod.find ("alpha:")) != string::npos) {
+ _a = PBD::string_to<double>(mod.substr (pos+6));
+ } else if ((pos = mod.find ("saturate:")) != string::npos) {
+ _s = PBD::string_to<double>(mod.substr (pos+9));
+ } else if ((pos = mod.find ("darkness:")) != string::npos) {
+ _v = PBD::string_to<double>(mod.substr (pos+9));
+ } else {
+ throw failed_constructor ();
+ }
+ }
+}
+
+string
+SVAModifier::to_string () const
+{
+ stringstream ss;
+
+ switch (type) {
+ case Add:
+ ss << '+';
+ break;
+ case Multiply:
+ ss << '*';
+ break;
+ case Assign:
+ ss << '=';
+ break;
+ }
+
+ if (_s >= 0.0) {
+ ss << " saturate:" << PBD::to_string(_s);
+ }
+
+ if (_v >= 0.0) {
+ ss << " darker:" << PBD::to_string(_v);
+ }
+
+ if (_a >= 0.0) {
+ ss << " alpha:" << PBD::to_string(_a);
+ }
+
+ return ss.str();
+}
+
+HSV
+SVAModifier::operator () (HSV& hsv) const
+{
+ HSV r (hsv);
+
+ switch (type) {
+ case Add:
+ r.s += _s;
+ r.v += _v;
+ r.a += _a;
+ break;
+ case Multiply:
+ r.s *= _s;
+ r.v *= _v;
+ r.a *= _a;
+ break;
+ case Assign:
+ if (_s >= 0.0) {
+ r.s = _s;
+ }
+ if (_v >= 0.) {
+ r.v = _v;
+ }
+ if (_a >= 0.0) {
+ r.a = _a;
+ }
+ break;
+ }
+
+ return r;
+}
+
+Color
+Gtkmm2ext::color_at_alpha (Gtkmm2ext::Color c, double a)
+{
+ double r, g, b, unused;
+ color_to_rgba (c, r, g, b, unused);
+ return rgba_to_color( r,g,b, a );
+}
+
+void
+Gtkmm2ext::set_source_rgba (Cairo::RefPtr<Cairo::Context> context, Color color)
+{
+ context->set_source_rgba (
+ ((color >> 24) & 0xff) / 255.0,
+ ((color >> 16) & 0xff) / 255.0,
+ ((color >> 8) & 0xff) / 255.0,
+ ((color >> 0) & 0xff) / 255.0
+ );
+}
+
+void
+Gtkmm2ext::set_source_rgb_a (Cairo::RefPtr<Cairo::Context> context, Color color, float alpha)
+{
+ context->set_source_rgba (
+ ((color >> 24) & 0xff) / 255.0,
+ ((color >> 16) & 0xff) / 255.0,
+ ((color >> 8) & 0xff) / 255.0,
+ alpha
+ );
+}
+
+void
+Gtkmm2ext::set_source_rgba (cairo_t *cr, Color color)
+{
+ cairo_set_source_rgba ( cr,
+ ((color >> 24) & 0xff) / 255.0,
+ ((color >> 16) & 0xff) / 255.0,
+ ((color >> 8) & 0xff) / 255.0,
+ ((color >> 0) & 0xff) / 255.0
+ );
+}
+
+void
+Gtkmm2ext::set_source_rgb_a (cairo_t *cr, Color color, float alpha)
+{
+ cairo_set_source_rgba ( cr,
+ ((color >> 24) & 0xff) / 255.0,
+ ((color >> 16) & 0xff) / 255.0,
+ ((color >> 8) & 0xff) / 255.0,
+ alpha
+ );
+}