Pileus Git - ~andy/gtk/blob - gtk/gtkhsv.c

   1 /* HSV color selector for GTK+
   2  *
   3  * Copyright (C) 1999 The Free Software Foundation
   4  *
   5  * Authors: Simon Budig <Simon.Budig@unix-ag.org> (original code)
   6  *          Federico Mena-Quintero <federico@gimp.org> (cleanup for GTK+)
   7  *          Jonathan Blandford <jrb@redhat.com> (cleanup for GTK+)
   8  *
   9  * This library is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU Lesser General Public
  11  * License as published by the Free Software Foundation; either
  12  * version 2 of the License, or (at your option) any later version.
  13  *
  14  * This library is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17  * Lesser General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Lesser General Public
  20  * License along with this library; if not, write to the
  21  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  22  * Boston, MA 02111-1307, USA.
  23  */
  24
  25 #include <config.h>
  26 #include <math.h>
  27 #include <string.h>
  28 #include "gtkalias.h"
  29 #include "gtkhsv.h"
  30 #include "gdk/gdkkeysyms.h"
  31 #include "gtkbindings.h"
  32 #include "gtkcontainer.h"
  33 #include "gtkmarshalers.h"
  34
  35 /*
  36  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
  37  * file for a list of people on the GTK+ Team.  See the ChangeLog
  38  * files for a list of changes.  These files are distributed with
  39  * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  40  */
  41
  42 /* Default width/height */
  43 #define DEFAULT_SIZE 100
  44
  45 /* Default ring width */
  46 #define DEFAULT_RING_WIDTH 10
  47
  48
  49 /* Dragging modes */
  50 typedef enum {
  51   DRAG_NONE,
  52   DRAG_H,
  53   DRAG_SV
  54 } DragMode;
  55
  56 /* Private part of the GtkHSV structure */
  57 typedef struct {
  58   /* Color value */
  59   double h;
  60   double s;
  61   double v;
  62
  63   /* Size and ring width */
  64   int size;
  65   int ring_width;
  66
  67   /* Window for capturing events */
  68   GdkWindow *window;
  69
  70   /* GC for drawing */
  71   GdkGC *gc;
  72
  73   /* Dragging mode */
  74   DragMode mode;
  75
  76   guint focus_on_ring : 1;
  77
  78 } HSVPrivate;
  79
  80 \f
  81
  82 /* Signal IDs */
  83
  84 enum {
  85   CHANGED,
  86   MOVE,
  87   LAST_SIGNAL
  88 };
  89
  90 static void     gtk_hsv_class_init     (GtkHSVClass      *class);
  91 static void     gtk_hsv_init           (GtkHSV           *hsv);
  92 static void     gtk_hsv_destroy        (GtkObject        *object);
  93 static void     gtk_hsv_map            (GtkWidget        *widget);
  94 static void     gtk_hsv_unmap          (GtkWidget        *widget);
  95 static void     gtk_hsv_realize        (GtkWidget        *widget);
  96 static void     gtk_hsv_unrealize      (GtkWidget        *widget);
  97 static void     gtk_hsv_size_request   (GtkWidget        *widget,
  98                                         GtkRequisition   *requisition);
  99 static void     gtk_hsv_size_allocate  (GtkWidget        *widget,
 100                                         GtkAllocation    *allocation);
 101 static gint     gtk_hsv_button_press   (GtkWidget        *widget,
 102                                         GdkEventButton   *event);
 103 static gint     gtk_hsv_button_release (GtkWidget        *widget,
 104                                         GdkEventButton   *event);
 105 static gint     gtk_hsv_motion         (GtkWidget        *widget,
 106                                         GdkEventMotion   *event);
 107 static gint     gtk_hsv_expose         (GtkWidget        *widget,
 108                                         GdkEventExpose   *event);
 109 static gboolean gtk_hsv_focus          (GtkWidget        *widget,
 110                                         GtkDirectionType  direction);
 111 static void     gtk_hsv_move           (GtkHSV           *hsv,
 112                                         GtkDirectionType  dir);
 113
 114 static guint hsv_signals[LAST_SIGNAL];
 115 static GtkWidgetClass *parent_class;
 116
 117
 118 /**
 119  * gtk_hsv_get_type:
 120  * @void:
 121  *
 122  * Registers the &GtkHSV class if necessary, and returns the type ID associated
 123  * to it.
 124  *
 125  * Return value: The type ID of the &GtkHSV class.
 126  **/
 127 GType
 128 gtk_hsv_get_type (void)
 129 {
 130   static GType hsv_type = 0;
 131
 132   if (!hsv_type) {
 133     static const GTypeInfo hsv_info = {
 134       sizeof (GtkHSVClass),
 135       NULL,             /* base_init */
 136       NULL,             /* base_finalize */
 137       (GClassInitFunc) gtk_hsv_class_init,
 138       NULL,             /* class_finalize */
 139       NULL,             /* class_data */
 140       sizeof (GtkHSV),
 141       0,                /* n_preallocs */
 142       (GInstanceInitFunc) gtk_hsv_init,
 143     };
 144
 145     hsv_type = g_type_register_static (GTK_TYPE_WIDGET, "GtkHSV",
 146                                        &hsv_info, 0);
 147   }
 148
 149   return hsv_type;
 150 }
 151
 152 /* Class initialization function for the HSV color selector */
 153 static void
 154 gtk_hsv_class_init (GtkHSVClass *class)
 155 {
 156   GtkObjectClass *object_class;
 157   GtkWidgetClass *widget_class;
 158   GtkHSVClass    *hsv_class;
 159   GtkBindingSet  *binding_set;
 160
 161   object_class = (GtkObjectClass *) class;
 162   widget_class = (GtkWidgetClass *) class;
 163   hsv_class = GTK_HSV_CLASS (class);
 164
 165   parent_class = g_type_class_peek_parent (class);
 166
 167   object_class->destroy = gtk_hsv_destroy;
 168
 169   widget_class->map = gtk_hsv_map;
 170   widget_class->unmap = gtk_hsv_unmap;
 171   widget_class->realize = gtk_hsv_realize;
 172   widget_class->unrealize = gtk_hsv_unrealize;
 173   widget_class->size_request = gtk_hsv_size_request;
 174   widget_class->size_allocate = gtk_hsv_size_allocate;
 175   widget_class->button_press_event = gtk_hsv_button_press;
 176   widget_class->button_release_event = gtk_hsv_button_release;
 177   widget_class->motion_notify_event = gtk_hsv_motion;
 178   widget_class->expose_event = gtk_hsv_expose;
 179   widget_class->focus = gtk_hsv_focus;
 180
 181   hsv_class->move = gtk_hsv_move;
 182
 183   hsv_signals[CHANGED] =
 184     g_signal_new ("changed",
 185                   G_OBJECT_CLASS_TYPE (object_class),
 186                   G_SIGNAL_RUN_FIRST,
 187                   G_STRUCT_OFFSET (GtkHSVClass, changed),
 188                   NULL, NULL,
 189                   _gtk_marshal_VOID__VOID,
 190                   G_TYPE_NONE, 0);
 191
 192   hsv_signals[MOVE] =
 193     g_signal_new ("move",
 194                   G_OBJECT_CLASS_TYPE (object_class),
 195                   G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
 196                   G_STRUCT_OFFSET (GtkHSVClass, move),
 197                   NULL, NULL,
 198                   _gtk_marshal_VOID__ENUM,
 199                   G_TYPE_NONE, 1,
 200                   GTK_TYPE_DIRECTION_TYPE);
 201
 202   binding_set = gtk_binding_set_by_class (class);
 203
 204   gtk_binding_entry_add_signal (binding_set, GDK_Up, 0,
 205                                 "move", 1,
 206                                 G_TYPE_ENUM, GTK_DIR_UP);
 207   gtk_binding_entry_add_signal (binding_set, GDK_KP_Up, 0,
 208                                 "move", 1,
 209                                 G_TYPE_ENUM, GTK_DIR_UP);
 210
 211   gtk_binding_entry_add_signal (binding_set, GDK_Down, 0,
 212                                 "move", 1,
 213                                 G_TYPE_ENUM, GTK_DIR_DOWN);
 214   gtk_binding_entry_add_signal (binding_set, GDK_KP_Down, 0,
 215                                 "move", 1,
 216                                 G_TYPE_ENUM, GTK_DIR_DOWN);
 217
 218
 219   gtk_binding_entry_add_signal (binding_set, GDK_Right, 0,
 220                                 "move", 1,
 221                                 G_TYPE_ENUM, GTK_DIR_RIGHT);
 222   gtk_binding_entry_add_signal (binding_set, GDK_KP_Right, 0,
 223                                 "move", 1,
 224                                 G_TYPE_ENUM, GTK_DIR_RIGHT);
 225
 226   gtk_binding_entry_add_signal (binding_set, GDK_Left, 0,
 227                                 "move", 1,
 228                                 G_TYPE_ENUM, GTK_DIR_LEFT);
 229   gtk_binding_entry_add_signal (binding_set, GDK_KP_Left, 0,
 230                                 "move", 1,
 231                                 G_TYPE_ENUM, GTK_DIR_LEFT);
 232 }
 233
 234 /* Object initialization function for the HSV color selector */
 235 static void
 236 gtk_hsv_init (GtkHSV *hsv)
 237 {
 238   HSVPrivate *priv;
 239
 240   priv = g_new0 (HSVPrivate, 1);
 241   hsv->priv = priv;
 242
 243   GTK_WIDGET_SET_FLAGS (hsv, GTK_NO_WINDOW);
 244   GTK_WIDGET_SET_FLAGS (hsv, GTK_CAN_FOCUS);
 245
 246   priv->h = 0.0;
 247   priv->s = 0.0;
 248   priv->v = 0.0;
 249
 250   priv->size = DEFAULT_SIZE;
 251   priv->ring_width = DEFAULT_RING_WIDTH;
 252 }
 253
 254 /* Destroy handler for the HSV color selector */
 255 static void
 256 gtk_hsv_destroy (GtkObject *object)
 257 {
 258   GtkHSV *hsv;
 259
 260   g_return_if_fail (GTK_IS_HSV (object));
 261
 262   hsv = GTK_HSV (object);
 263
 264   if (hsv->priv)
 265     {
 266       g_free (hsv->priv);
 267       hsv->priv = NULL;
 268     }
 269
 270   GTK_OBJECT_CLASS (parent_class)->destroy (object);
 271 }
 272
 273 /* Default signal handlers */
 274
 275
 276 /* Map handler for the HSV color selector */
 277
 278 static void
 279 gtk_hsv_map (GtkWidget *widget)
 280 {
 281   GtkHSV *hsv;
 282   HSVPrivate *priv;
 283
 284   hsv = GTK_HSV (widget);
 285   priv = hsv->priv;
 286
 287   GTK_WIDGET_CLASS (parent_class)->map (widget);
 288
 289   gdk_window_show (priv->window);
 290 }
 291
 292 /* Unmap handler for the HSV color selector */
 293
 294 static void
 295 gtk_hsv_unmap (GtkWidget *widget)
 296 {
 297   GtkHSV *hsv;
 298   HSVPrivate *priv;
 299
 300   hsv = GTK_HSV (widget);
 301   priv = hsv->priv;
 302
 303   gdk_window_hide (priv->window);
 304
 305   GTK_WIDGET_CLASS (parent_class)->unmap (widget);
 306 }
 307
 308 /* Realize handler for the HSV color selector */
 309 static void
 310 gtk_hsv_realize (GtkWidget *widget)
 311 {
 312   GtkHSV *hsv;
 313   HSVPrivate *priv;
 314   GdkWindowAttr attr;
 315   int attr_mask;
 316   GdkWindow *parent_window;
 317
 318   hsv = GTK_HSV (widget);
 319   priv = hsv->priv;
 320
 321   GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
 322
 323   /* Create window */
 324
 325   attr.window_type = GDK_WINDOW_CHILD;
 326   attr.x = widget->allocation.x;
 327   attr.y = widget->allocation.y;
 328   attr.width = widget->allocation.width;
 329   attr.height = widget->allocation.height;
 330   attr.wclass = GDK_INPUT_ONLY;
 331   attr.event_mask = gtk_widget_get_events (widget);
 332   attr.event_mask |= (GDK_KEY_PRESS_MASK
 333                       | GDK_BUTTON_PRESS_MASK
 334                       | GDK_BUTTON_RELEASE_MASK
 335                       | GDK_POINTER_MOTION_MASK
 336                       | GDK_ENTER_NOTIFY_MASK
 337                       | GDK_LEAVE_NOTIFY_MASK);
 338
 339   attr_mask = GDK_WA_X | GDK_WA_Y;
 340
 341   parent_window = gtk_widget_get_parent_window (widget);
 342
 343   widget->window = parent_window;
 344   g_object_ref (widget->window);
 345
 346   priv->window = gdk_window_new (parent_window, &attr, attr_mask);
 347   gdk_window_set_user_data (priv->window, hsv);
 348
 349   widget->style = gtk_style_attach (widget->style, widget->window);
 350
 351   /* Create GC */
 352
 353   priv->gc = gdk_gc_new (parent_window);
 354 }
 355
 356 /* Unrealize handler for the HSV color selector */
 357 static void
 358 gtk_hsv_unrealize (GtkWidget *widget)
 359 {
 360   GtkHSV *hsv;
 361   HSVPrivate *priv;
 362
 363   hsv = GTK_HSV (widget);
 364   priv = hsv->priv;
 365
 366   gdk_window_set_user_data (priv->window, NULL);
 367   gdk_window_destroy (priv->window);
 368   priv->window = NULL;
 369
 370   g_object_unref (priv->gc);
 371   priv->gc = NULL;
 372
 373   if (GTK_WIDGET_CLASS (parent_class)->unrealize)
 374     GTK_WIDGET_CLASS (parent_class)->unrealize (widget);
 375 }
 376
 377 /* Size_request handler for the HSV color selector */
 378 static void
 379 gtk_hsv_size_request (GtkWidget      *widget,
 380                       GtkRequisition *requisition)
 381 {
 382   GtkHSV *hsv = GTK_HSV (widget);
 383   HSVPrivate *priv = hsv->priv;
 384   gint focus_width;
 385   gint focus_pad;
 386
 387   gtk_widget_style_get (widget,
 388                         "focus-line-width", &focus_width,
 389                         "focus-padding", &focus_pad,
 390                         NULL);
 391
 392   requisition->width = priv->size + 2 * (focus_width + focus_pad);
 393   requisition->height = priv->size + 2 * (focus_width + focus_pad);
 394 }
 395
 396 /* Size_allocate handler for the HSV color selector */
 397 static void
 398 gtk_hsv_size_allocate (GtkWidget     *widget,
 399                        GtkAllocation *allocation)
 400 {
 401   GtkHSV *hsv;
 402   HSVPrivate *priv;
 403
 404   hsv = GTK_HSV (widget);
 405   priv = hsv->priv;
 406
 407   widget->allocation = *allocation;
 408
 409   if (GTK_WIDGET_REALIZED (widget))
 410     gdk_window_move_resize (priv->window,
 411                             allocation->x,
 412                             allocation->y,
 413                             allocation->width,
 414                             allocation->height);
 415 }
 416
 417
 418 /* Utility functions */
 419
 420 #define INTENSITY(r, g, b) ((r) * 0.30 + (g) * 0.59 + (b) * 0.11)
 421
 422 /* Converts from HSV to RGB */
 423 static void
 424 hsv_to_rgb (gdouble *h,
 425             gdouble *s,
 426             gdouble *v)
 427 {
 428   gdouble hue, saturation, value;
 429   gdouble f, p, q, t;
 430
 431   if (*s == 0.0)
 432     {
 433       *h = *v;
 434       *s = *v;
 435       *v = *v; /* heh */
 436     }
 437   else
 438     {
 439       hue = *h * 6.0;
 440       saturation = *s;
 441       value = *v;
 442
 443       if (hue == 6.0)
 444         hue = 0.0;
 445
 446       f = hue - (int) hue;
 447       p = value * (1.0 - saturation);
 448       q = value * (1.0 - saturation * f);
 449       t = value * (1.0 - saturation * (1.0 - f));
 450
 451       switch ((int) hue)
 452         {
 453         case 0:
 454           *h = value;
 455           *s = t;
 456           *v = p;
 457           break;
 458
 459         case 1:
 460           *h = q;
 461           *s = value;
 462           *v = p;
 463           break;
 464
 465         case 2:
 466           *h = p;
 467           *s = value;
 468           *v = t;
 469           break;
 470
 471         case 3:
 472           *h = p;
 473           *s = q;
 474           *v = value;
 475           break;
 476
 477         case 4:
 478           *h = t;
 479           *s = p;
 480           *v = value;
 481           break;
 482
 483         case 5:
 484           *h = value;
 485           *s = p;
 486           *v = q;
 487           break;
 488
 489         default:
 490           g_assert_not_reached ();
 491         }
 492     }
 493 }
 494
 495 /* Converts from RGB to HSV */
 496 static void
 497 rgb_to_hsv (gdouble *r,
 498             gdouble *g,
 499             gdouble *b)
 500 {
 501   gdouble red, green, blue;
 502   gdouble h, s, v;
 503   gdouble min, max;
 504   gdouble delta;
 505
 506   red = *r;
 507   green = *g;
 508   blue = *b;
 509
 510   h = 0.0;
 511
 512   if (red > green)
 513     {
 514       if (red > blue)
 515         max = red;
 516       else
 517         max = blue;
 518
 519       if (green < blue)
 520         min = green;
 521       else
 522         min = blue;
 523     }
 524   else
 525     {
 526       if (green > blue)
 527         max = green;
 528       else
 529         max = blue;
 530
 531       if (red < blue)
 532         min = red;
 533       else
 534         min = blue;
 535     }
 536
 537   v = max;
 538
 539   if (max != 0.0)
 540     s = (max - min) / max;
 541   else
 542     s = 0.0;
 543
 544   if (s == 0.0)
 545     h = 0.0;
 546   else
 547     {
 548       delta = max - min;
 549
 550       if (red == max)
 551         h = (green - blue) / delta;
 552       else if (green == max)
 553         h = 2 + (blue - red) / delta;
 554       else if (blue == max)
 555         h = 4 + (red - green) / delta;
 556
 557       h /= 6.0;
 558
 559       if (h < 0.0)
 560         h += 1.0;
 561       else if (h > 1.0)
 562         h -= 1.0;
 563     }
 564
 565   *r = h;
 566   *g = s;
 567   *b = v;
 568 }
 569
 570 /* Computes the vertices of the saturation/value triangle */
 571 static void
 572 compute_triangle (GtkHSV *hsv,
 573                   gint   *hx,
 574                   gint   *hy,
 575                   gint   *sx,
 576                   gint   *sy,
 577                   gint   *vx,
 578                   gint   *vy)
 579 {
 580   HSVPrivate *priv;
 581   gdouble center;
 582   gdouble inner, outer;
 583   gdouble angle;
 584
 585   priv = hsv->priv;
 586
 587   center = GTK_WIDGET (hsv)->requisition.width / 2.0;
 588   outer = priv->size / 2.0;
 589   inner = outer - priv->ring_width;
 590   angle = priv->h * 2.0 * G_PI;
 591
 592   *hx = floor (center + cos (angle) * inner + 0.5);
 593   *hy = floor (center - sin (angle) * inner + 0.5);
 594   *sx = floor (center + cos (angle + 2.0 * G_PI / 3.0) * inner + 0.5);
 595   *sy = floor (center - sin (angle + 2.0 * G_PI / 3.0) * inner + 0.5);
 596   *vx = floor (center + cos (angle + 4.0 * G_PI / 3.0) * inner + 0.5);
 597   *vy = floor (center - sin (angle + 4.0 * G_PI / 3.0) * inner + 0.5);
 598 }
 599
 600 /* Computes whether a point is inside the hue ring */
 601 static gboolean
 602 is_in_ring (GtkHSV *hsv,
 603             gdouble x,
 604             gdouble y)
 605 {
 606   HSVPrivate *priv;
 607   gdouble dx, dy, dist;
 608   gdouble center, inner, outer;
 609
 610   priv = hsv->priv;
 611
 612   center = priv->size / 2.0;
 613   outer = priv->size / 2.0;
 614   inner = outer - priv->ring_width;
 615
 616   dx = x - center;
 617   dy = center - y;
 618   dist = dx * dx + dy * dy;
 619
 620   return (dist >= inner * inner && dist <= outer * outer);
 621 }
 622
 623 /* Computes a saturation/value pair based on the mouse coordinates */
 624 static void
 625 compute_sv (GtkHSV  *hsv,
 626             gdouble  x,
 627             gdouble  y,
 628             gdouble *s,
 629             gdouble *v)
 630 {
 631   HSVPrivate *priv;
 632   int ihx, ihy, isx, isy, ivx, ivy;
 633   double hx, hy, sx, sy, vx, vy;
 634   double center;
 635
 636   priv = hsv->priv;
 637
 638   compute_triangle (hsv, &ihx, &ihy, &isx, &isy, &ivx, &ivy);
 639   center = GTK_WIDGET (hsv)->requisition.width / 2.0;
 640   hx = ihx - center;
 641   hy = center - ihy;
 642   sx = isx - center;
 643   sy = center - isy;
 644   vx = ivx - center;
 645   vy = center - ivy;
 646   x -= center;
 647   y = center - y;
 648
 649   if (vx * (x - sx) + vy * (y - sy) < 0.0)
 650     {
 651       *s = 1.0;
 652       *v = (((x - sx) * (hx - sx) + (y - sy) * (hy-sy))
 653             / ((hx - sx) * (hx - sx) + (hy - sy) * (hy - sy)));
 654
 655       if (*v < 0.0)
 656         *v = 0.0;
 657       else if (*v > 1.0)
 658         *v = 1.0;
 659     }
 660   else if (hx * (x - sx) + hy * (y - sy) < 0.0)
 661     {
 662       *s = 0.0;
 663       *v = (((x - sx) * (vx - sx) + (y - sy) * (vy - sy))
 664             / ((vx - sx) * (vx - sx) + (vy - sy) * (vy - sy)));
 665
 666       if (*v < 0.0)
 667         *v = 0.0;
 668       else if (*v > 1.0)
 669         *v = 1.0;
 670     }
 671   else if (sx * (x - hx) + sy * (y - hy) < 0.0)
 672     {
 673       *v = 1.0;
 674       *s = (((x - vx) * (hx - vx) + (y - vy) * (hy - vy)) /
 675             ((hx - vx) * (hx - vx) + (hy - vy) * (hy - vy)));
 676
 677       if (*s < 0.0)
 678         *s = 0.0;
 679       else if (*s > 1.0)
 680         *s = 1.0;
 681     }
 682   else
 683     {
 684       *v = (((x - sx) * (hy - vy) - (y - sy) * (hx - vx))
 685             / ((vx - sx) * (hy - vy) - (vy - sy) * (hx - vx)));
 686
 687       if (*v<= 0.0)
 688         {
 689           *v = 0.0;
 690           *s = 0.0;
 691         }
 692       else
 693         {
 694           if (*v > 1.0)
 695             *v = 1.0;
 696
 697           if (fabs (hy - vy) < fabs (hx - vx))
 698             *s = (x - sx - *v * (vx - sx)) / (*v * (hx - vx));
 699           else
 700             *s = (y - sy - *v * (vy - sy)) / (*v * (hy - vy));
 701
 702           if (*s < 0.0)
 703             *s = 0.0;
 704           else if (*s > 1.0)
 705             *s = 1.0;
 706         }
 707     }
 708 }
 709
 710 /* Computes whether a point is inside the saturation/value triangle */
 711 static gboolean
 712 is_in_triangle (GtkHSV *hsv,
 713                 gdouble x,
 714                 gdouble y)
 715 {
 716   int hx, hy, sx, sy, vx, vy;
 717   double det, s, v;
 718
 719   compute_triangle (hsv, &hx, &hy, &sx, &sy, &vx, &vy);
 720
 721   det = (vx - sx) * (hy - sy) - (vy - sy) * (hx - sx);
 722
 723   s = ((x - sx) * (hy - sy) - (y - sy) * (hx - sx)) / det;
 724   v = ((vx - sx) * (y - sy) - (vy - sy) * (x - sx)) / det;
 725
 726   return (s >= 0.0 && v >= 0.0 && s + v <= 1.0);
 727 }
 728
 729 /* Computes a value based on the mouse coordinates */
 730 static double
 731 compute_v (GtkHSV *hsv,
 732            gdouble x,
 733            gdouble y)
 734 {
 735   HSVPrivate *priv;
 736   double center;
 737   double dx, dy;
 738   double angle;
 739
 740   priv = hsv->priv;
 741
 742   center = GTK_WIDGET (hsv)->requisition.width / 2.0;
 743   dx = x - center;
 744   dy = center - y;
 745
 746   angle = atan2 (dy, dx);
 747   if (angle < 0.0)
 748     angle += 2.0 * G_PI;
 749
 750   return angle / (2.0 * G_PI);
 751 }
 752
 753 /* Event handlers */
 754
 755 static void
 756 set_cross_grab (GtkHSV *hsv,
 757                 guint32 time)
 758 {
 759   HSVPrivate *priv;
 760   GdkCursor *cursor;
 761
 762   priv = hsv->priv;
 763
 764   cursor = gdk_cursor_new_for_display (gtk_widget_get_display (GTK_WIDGET (hsv)),
 765                                        GDK_CROSSHAIR);
 766   gdk_pointer_grab (priv->window, FALSE,
 767                     (GDK_POINTER_MOTION_MASK
 768                      | GDK_POINTER_MOTION_HINT_MASK
 769                      | GDK_BUTTON_RELEASE_MASK),
 770                     NULL,
 771                     cursor,
 772                     time);
 773   gdk_cursor_unref (cursor);
 774 }
 775
 776 /* Button_press_event handler for the HSV color selector */
 777 static gint
 778 gtk_hsv_button_press (GtkWidget      *widget,
 779                       GdkEventButton *event)
 780 {
 781   GtkHSV *hsv;
 782   HSVPrivate *priv;
 783   double x, y;
 784
 785   hsv = GTK_HSV (widget);
 786   priv = hsv->priv;
 787
 788   if (priv->mode != DRAG_NONE || event->button != 1)
 789     return FALSE;
 790
 791   x = event->x;
 792   y = event->y;
 793
 794   if (is_in_ring (hsv, x, y))
 795     {
 796       priv->mode = DRAG_H;
 797       set_cross_grab (hsv, event->time);
 798
 799       gtk_hsv_set_color (hsv,
 800                          compute_v (hsv, x, y),
 801                          priv->s,
 802                          priv->v);
 803
 804       gtk_widget_grab_focus (widget);
 805       priv->focus_on_ring = TRUE;
 806
 807       return TRUE;
 808     }
 809
 810   if (is_in_triangle (hsv, x, y))
 811     {
 812       gdouble s, v;
 813
 814       priv->mode = DRAG_SV;
 815       set_cross_grab (hsv, event->time);
 816
 817       compute_sv (hsv, x, y, &s, &v);
 818       gtk_hsv_set_color (hsv, priv->h, s, v);
 819
 820       gtk_widget_grab_focus (widget);
 821       priv->focus_on_ring = FALSE;
 822
 823       return TRUE;
 824     }
 825
 826   return FALSE;
 827 }
 828
 829 /* Button_release_event handler for the HSV color selector */
 830 static gint
 831 gtk_hsv_button_release (GtkWidget      *widget,
 832                         GdkEventButton *event)
 833 {
 834   GtkHSV *hsv;
 835   HSVPrivate *priv;
 836   DragMode mode;
 837   gdouble x, y;
 838
 839   hsv = GTK_HSV (widget);
 840   priv = hsv->priv;
 841
 842   if (priv->mode == DRAG_NONE || event->button != 1)
 843     return FALSE;
 844
 845   /* Set the drag mode to DRAG_NONE so that signal handlers for "catched"
 846    * can see that this is the final color state.
 847    */
 848
 849   mode = priv->mode;
 850   priv->mode = DRAG_NONE;
 851
 852   x = event->x;
 853   y = event->y;
 854
 855   if (mode == DRAG_H)
 856     gtk_hsv_set_color (hsv, compute_v (hsv, x, y), priv->s, priv->v);
 857   else if (mode == DRAG_SV) {
 858     double s, v;
 859
 860     compute_sv (hsv, x, y, &s, &v);
 861     gtk_hsv_set_color (hsv, priv->h, s, v);
 862   } else
 863     g_assert_not_reached ();
 864
 865   gdk_display_pointer_ungrab (gdk_drawable_get_display (event->window),
 866                               event->time);
 867   return TRUE;
 868 }
 869
 870 /* Motion_notify_event handler for the HSV color selector */
 871 static gint
 872 gtk_hsv_motion (GtkWidget      *widget,
 873                 GdkEventMotion *event)
 874 {
 875   GtkHSV *hsv;
 876   HSVPrivate *priv;
 877   double x, y;
 878   gint ix, iy;
 879   GdkModifierType mods;
 880
 881   hsv = GTK_HSV (widget);
 882   priv = hsv->priv;
 883
 884   if (priv->mode == DRAG_NONE)
 885     return FALSE;
 886
 887   if (event->is_hint)
 888     {
 889       gdk_window_get_pointer (priv->window, &ix, &iy, &mods);
 890       x = ix;
 891       y = iy;
 892     }
 893   else
 894     {
 895       x = event->x;
 896       y = event->y;
 897     }
 898
 899   if (priv->mode == DRAG_H)
 900     {
 901       gtk_hsv_set_color (hsv, compute_v (hsv, x, y), priv->s, priv->v);
 902       return TRUE;
 903     }
 904   else if (priv->mode == DRAG_SV)
 905     {
 906       double s, v;
 907
 908       compute_sv (hsv, x, y, &s, &v);
 909       gtk_hsv_set_color (hsv, priv->h, s, v);
 910       return TRUE;
 911     }
 912
 913   g_assert_not_reached ();
 914   return FALSE;
 915 }
 916
 917
 918 /* Redrawing */
 919
 920 void
 921 set_source_surface (cairo_t         *cr,
 922                     cairo_surface_t *surface)
 923 {
 924   cairo_pattern_t *pattern;
 925   cairo_matrix_t *matrix;
 926   double x, y;
 927
 928   pattern = cairo_pattern_create_for_surface (surface);
 929
 930   cairo_current_point (cr, &x, &y);
 931   matrix = cairo_matrix_create ();
 932   cairo_matrix_translate (matrix, -x, -y);
 933   cairo_pattern_set_matrix (pattern, matrix);
 934   cairo_matrix_destroy (matrix);
 935
 936   cairo_set_pattern (cr, pattern);
 937   cairo_pattern_destroy (pattern);
 938 }
 939
 940 /* Paints the hue ring */
 941 static void
 942 paint_ring (GtkHSV      *hsv,
 943             cairo_t     *cr,
 944             gint         x,
 945             gint         y,
 946             gint         width,
 947             gint         height)
 948 {
 949   GtkWidget *widget = GTK_WIDGET (hsv);
 950   HSVPrivate *priv;
 951   int xx, yy;
 952   gdouble dx, dy, dist;
 953   gdouble center;
 954   gdouble inner, outer;
 955   guint32 *buf, *p;
 956   gdouble angle;
 957   gdouble hue;
 958   gdouble r, g, b;
 959   cairo_surface_t *source;
 960   cairo_t *source_cr;
 961   gint focus_width;
 962   gint focus_pad;
 963
 964   gtk_widget_style_get (widget,
 965                         "focus-line-width", &focus_width,
 966                         "focus-padding", &focus_pad,
 967                         NULL);
 968
 969   priv = hsv->priv;
 970
 971   center = widget->requisition.width / 2.0;
 972
 973   outer = priv->size / 2.0;
 974   inner = outer - priv->ring_width;
 975
 976   /* Create an image initialized with the ring colors */
 977
 978   buf = g_new (guint32, width * height);
 979
 980   for (yy = 0; yy < height; yy++)
 981     {
 982       p = buf + yy * width;
 983
 984       dy = -(yy + y - center);
 985
 986       for (xx = 0; xx < width; xx++)
 987         {
 988           dx = xx + x - center;
 989
 990           dist = dx * dx + dy * dy;
 991           if (dist < ((inner-1) * (inner-1)) || dist > ((outer+1) * (outer+1)))
 992             {
 993               *p++ = 0;
 994               continue;
 995             }
 996
 997           angle = atan2 (dy, dx);
 998           if (angle < 0.0)
 999             angle += 2.0 * G_PI;
1000
1001           hue = angle / (2.0 * G_PI);
1002
1003           r = hue;
1004           g = 1.0;
1005           b = 1.0;
1006           hsv_to_rgb (&r, &g, &b);
1007
1008           *p++ = (((int)floor (r * 255 + 0.5) << 16) |
1009                   ((int)floor (g * 255 + 0.5) << 8) |
1010                   (int)floor (b * 255 + 0.5));
1011         }
1012     }
1013
1014   source = cairo_image_surface_create_for_data ((char *)buf,
1015                                                 CAIRO_FORMAT_RGB24,
1016                                                 width, height, 4 * width);
1017
1018   /* Now draw the value marker onto the source image, so that it
1019    * will get properly clipped at the edges of the ring
1020    */
1021   source_cr = cairo_create ();
1022   cairo_set_target_surface (source_cr, source);
1023
1024   r = priv->h;
1025   g = 1.0;
1026   b = 1.0;
1027   hsv_to_rgb (&r, &g, &b);
1028
1029   if (INTENSITY (r, g, b) > 0.5)
1030     cairo_set_rgb_color (source_cr, 0., 0., 0.);
1031   else
1032     cairo_set_rgb_color (source_cr, 1., 1., 1.);
1033
1034   cairo_move_to (source_cr, -x + center, - y + center);
1035   cairo_line_to (source_cr,
1036                  -x + center + cos (priv->h * 2.0 * G_PI) * center,
1037                  -y + center - sin (priv->h * 2.0 * G_PI) * center);
1038   cairo_stroke (source_cr);
1039   cairo_destroy (source_cr);
1040
1041   /* Draw the ring using the source image */
1042
1043   cairo_save (cr);
1044
1045   cairo_move_to (cr, x, y);
1046   set_source_surface (cr, source);
1047   cairo_surface_destroy (source);
1048
1049   cairo_set_line_width (cr, priv->ring_width);
1050   cairo_new_path (cr);
1051   cairo_arc (cr,
1052              center, center,
1053              priv->size / 2. - priv->ring_width / 2.,
1054              0, 2 * M_PI);
1055   cairo_stroke (cr);
1056
1057   cairo_restore (cr);
1058
1059   g_free (buf);
1060 }
1061
1062 /* Converts an HSV triplet to an integer RGB triplet */
1063 static void
1064 get_color (gdouble h,
1065            gdouble s,
1066            gdouble v,
1067            gint   *r,
1068            gint   *g,
1069            gint   *b)
1070 {
1071   hsv_to_rgb (&h, &s, &v);
1072
1073   *r = floor (h * 255 + 0.5);
1074   *g = floor (s * 255 + 0.5);
1075   *b = floor (v * 255 + 0.5);
1076 }
1077
1078 #define SWAP(a, b, t) ((t) = (a), (a) = (b), (b) = (t))
1079
1080 #define LERP(a, b, v1, v2, i) (((v2) - (v1) != 0)                                       \
1081                                ? ((a) + ((b) - (a)) * ((i) - (v1)) / ((v2) - (v1)))     \
1082                                : (a))
1083
1084 /* Number of pixels we extend out from the edges when creating
1085  * color source to avoid artifacts
1086  */
1087 #define PAD 3
1088
1089 /* Paints the HSV triangle */
1090 static void
1091 paint_triangle (GtkHSV      *hsv,
1092                 cairo_t     *cr,
1093                 gint         x,
1094                 gint         y,
1095                 gint         width,
1096                 gint         height)
1097 {
1098   GtkWidget *widget = GTK_WIDGET (hsv);
1099   HSVPrivate *priv;
1100   gint hx, hy, sx, sy, vx, vy; /* HSV vertices */
1101   gint x1, y1, r1, g1, b1; /* First vertex in scanline order */
1102   gint x2, y2, r2, g2, b2; /* Second vertex */
1103   gint x3, y3, r3, g3, b3; /* Third vertex */
1104   gint t;
1105   guint32 *buf, *p;
1106   gint xl, xr, rl, rr, gl, gr, bl, br; /* Scanline data */
1107   gint xx, yy;
1108   gint x_interp, y_interp;
1109   gint x_start, x_end;
1110   cairo_surface_t *source;
1111   gdouble r, g, b;
1112   gchar *detail;
1113
1114   priv = hsv->priv;
1115
1116   /* Compute triangle's vertices */
1117
1118   compute_triangle (hsv, &hx, &hy, &sx, &sy, &vx, &vy);
1119
1120   x1 = hx;
1121   y1 = hy;
1122   get_color (priv->h, 1.0, 1.0, &r1, &g1, &b1);
1123
1124   x2 = sx;
1125   y2 = sy;
1126   get_color (priv->h, 1.0, 0.0, &r2, &g2, &b2);
1127
1128   x3 = vx;
1129   y3 = vy;
1130   get_color (priv->h, 0.0, 1.0, &r3, &g3, &b3);
1131
1132   if (y2 > y3)
1133     {
1134       SWAP (x2, x3, t);
1135       SWAP (y2, y3, t);
1136       SWAP (r2, r3, t);
1137       SWAP (g2, g3, t);
1138       SWAP (b2, b3, t);
1139     }
1140
1141   if (y1 > y3)
1142     {
1143       SWAP (x1, x3, t);
1144       SWAP (y1, y3, t);
1145       SWAP (r1, r3, t);
1146       SWAP (g1, g3, t);
1147       SWAP (b1, b3, t);
1148     }
1149
1150   if (y1 > y2)
1151     {
1152       SWAP (x1, x2, t);
1153       SWAP (y1, y2, t);
1154       SWAP (r1, r2, t);
1155       SWAP (g1, g2, t);
1156       SWAP (b1, b2, t);
1157     }
1158
1159   /* Shade the triangle */
1160
1161   buf = g_new (guint32, width * height);
1162
1163   for (yy = 0; yy < height; yy++)
1164     {
1165       p = buf + yy * width;
1166
1167       if (yy + y >= y1 - PAD && yy + y < y3 + PAD) {
1168         y_interp = CLAMP (yy + y, y1, y3);
1169
1170         if (y_interp < y2)
1171           {
1172             xl = LERP (x1, x2, y1, y2, y_interp);
1173
1174             rl = LERP (r1, r2, y1, y2, y_interp);
1175             gl = LERP (g1, g2, y1, y2, y_interp);
1176             bl = LERP (b1, b2, y1, y2, y_interp);
1177           }
1178         else
1179           {
1180             xl = LERP (x2, x3, y2, y3, y_interp);
1181
1182             rl = LERP (r2, r3, y2, y3, y_interp);
1183             gl = LERP (g2, g3, y2, y3, y_interp);
1184             bl = LERP (b2, b3, y2, y3, y_interp);
1185           }
1186
1187         xr = LERP (x1, x3, y1, y3, y_interp);
1188
1189         rr = LERP (r1, r3, y1, y3, y_interp);
1190         gr = LERP (g1, g3, y1, y3, y_interp);
1191         br = LERP (b1, b3, y1, y3, y_interp);
1192
1193         if (xl > xr)
1194           {
1195             SWAP (xl, xr, t);
1196             SWAP (rl, rr, t);
1197             SWAP (gl, gr, t);
1198             SWAP (bl, br, t);
1199           }
1200
1201         x_start = MAX (xl - PAD, x);
1202         x_end = MIN (xr + PAD, x + width);
1203
1204         p += (x_start - x);
1205
1206         for (xx = x_start; xx < x_end; xx++)
1207           {
1208             x_interp = CLAMP (xx, xl, xr);
1209
1210             *p++ = ((LERP (rl, rr, xl, xr, x_interp) << 16) |
1211                     (LERP (gl, gr, xl, xr, x_interp) << 8) |
1212                     LERP (bl, br, xl, xr, x_interp));
1213           }
1214       }
1215     }
1216
1217   source = cairo_image_surface_create_for_data ((char *)buf,
1218                                                 CAIRO_FORMAT_RGB24,
1219                                                 width, height, 4 * width);
1220
1221   /* Draw a triangle with the image as a source */
1222
1223   cairo_move_to (cr, x, y);
1224   set_source_surface (cr, source);
1225   cairo_surface_destroy (source);
1226
1227   cairo_move_to (cr, x1, y1);
1228   cairo_line_to (cr, x2, y2);
1229   cairo_line_to (cr, x3, y3);
1230   cairo_close_path (cr);
1231   cairo_fill (cr);
1232
1233   g_free (buf);
1234
1235   /* Draw value marker */
1236
1237   xx = floor (sx + (vx - sx) * priv->v + (hx - vx) * priv->s * priv->v + 0.5);
1238   yy = floor (sy + (vy - sy) * priv->v + (hy - vy) * priv->s * priv->v + 0.5);
1239
1240   r = priv->h;
1241   g = priv->s;
1242   b = priv->v;
1243   hsv_to_rgb (&r, &g, &b);
1244
1245   if (INTENSITY (r, g, b) > 0.5)
1246     {
1247       detail = "colorwheel_light";
1248       cairo_set_rgb_color (cr, 0., 0., 0.);
1249     }
1250   else
1251     {
1252       detail = "colorwheel_dark";
1253       cairo_set_rgb_color (cr, 1., 1., 1.);
1254     }
1255
1256 #define RADIUS 4
1257 #define FOCUS_RADIUS 6
1258
1259   cairo_new_path (cr);
1260   cairo_arc (cr, xx, yy, RADIUS, 0, 2 * M_PI);
1261   cairo_stroke (cr);
1262
1263   /* Draw focus outline */
1264
1265   if (GTK_WIDGET_HAS_FOCUS (hsv) &&
1266       !priv->focus_on_ring)
1267     {
1268       gint focus_width;
1269       gint focus_pad;
1270
1271       gtk_widget_style_get (widget,
1272                             "focus-line-width", &focus_width,
1273                             "focus-padding", &focus_pad,
1274                             NULL);
1275
1276       gtk_paint_focus (widget->style, widget->window,
1277                        GTK_WIDGET_STATE (widget),
1278                        NULL, widget, detail,
1279                        widget->allocation.x + xx - FOCUS_RADIUS - focus_width - focus_pad,
1280                        widget->allocation.y + yy - FOCUS_RADIUS - focus_width - focus_pad,
1281                        2 * (FOCUS_RADIUS + focus_width + focus_pad),
1282                        2 * (FOCUS_RADIUS + focus_width + focus_pad));
1283     }
1284
1285 }
1286
1287 /* Paints the contents of the HSV color selector */
1288 static void
1289 paint (GtkHSV      *hsv,
1290        cairo_t     *cr,
1291        gint         x,
1292        gint         y,
1293        gint         width,
1294        gint         height)
1295 {
1296   paint_ring (hsv, cr, x, y, width, height);
1297   paint_triangle (hsv, cr, x, y, width, height);
1298 }
1299
1300 /* Expose_event handler for the HSV color selector */
1301 static gint
1302 gtk_hsv_expose (GtkWidget      *widget,
1303                 GdkEventExpose *event)
1304 {
1305   GtkHSV *hsv;
1306   HSVPrivate *priv;
1307   GdkRectangle rect, dest;
1308   cairo_t *cr;
1309
1310   hsv = GTK_HSV (widget);
1311   priv = hsv->priv;
1312
1313   if (!(GTK_WIDGET_DRAWABLE (widget) && event->window == widget->window))
1314     return FALSE;
1315
1316   rect.x = widget->allocation.x;
1317   rect.y = widget->allocation.y;
1318   rect.width = widget->allocation.width;
1319   rect.height = widget->allocation.height;
1320
1321   if (!gdk_rectangle_intersect (&event->area, &rect, &dest))
1322     return FALSE;
1323
1324   cr = gdk_drawable_create_cairo_context (widget->window);
1325
1326   cairo_translate (cr, widget->allocation.x, widget->allocation.y);
1327   paint (hsv, cr,
1328          dest.x - widget->allocation.x,
1329          dest.y - widget->allocation.y,
1330          dest.width, dest.height);
1331
1332   if (GTK_WIDGET_HAS_FOCUS (hsv) && priv->focus_on_ring)
1333     gtk_paint_focus (widget->style, widget->window,
1334                      GTK_WIDGET_STATE (widget),
1335                      &event->area, widget, NULL,
1336                      widget->allocation.x,
1337                      widget->allocation.y,
1338                      widget->allocation.width,
1339                      widget->allocation.height);
1340
1341   return FALSE;
1342 }
1343
1344 static gboolean
1345 gtk_hsv_focus (GtkWidget       *widget,
1346                GtkDirectionType dir)
1347 {
1348   GtkHSV *hsv;
1349   HSVPrivate *priv;
1350
1351   hsv = GTK_HSV (widget);
1352   priv = hsv->priv;
1353
1354   if (!GTK_WIDGET_HAS_FOCUS (hsv))
1355     {
1356       if (dir == GTK_DIR_TAB_BACKWARD)
1357         priv->focus_on_ring = FALSE;
1358       else
1359         priv->focus_on_ring = TRUE;
1360
1361       gtk_widget_grab_focus (GTK_WIDGET (hsv));
1362       return TRUE;
1363     }
1364
1365   switch (dir)
1366     {
1367     case GTK_DIR_UP:
1368       if (priv->focus_on_ring)
1369         return FALSE;
1370       else
1371         priv->focus_on_ring = TRUE;
1372       break;
1373
1374     case GTK_DIR_DOWN:
1375       if (priv->focus_on_ring)
1376         priv->focus_on_ring = FALSE;
1377       else
1378         return FALSE;
1379       break;
1380
1381     case GTK_DIR_LEFT:
1382     case GTK_DIR_TAB_BACKWARD:
1383       if (priv->focus_on_ring)
1384         return FALSE;
1385       else
1386         priv->focus_on_ring = TRUE;
1387       break;
1388
1389     case GTK_DIR_RIGHT:
1390     case GTK_DIR_TAB_FORWARD:
1391       if (priv->focus_on_ring)
1392         priv->focus_on_ring = FALSE;
1393       else
1394         return FALSE;
1395       break;
1396     }
1397
1398   gtk_widget_queue_draw (GTK_WIDGET (hsv));
1399
1400   return TRUE;
1401 }
1402
1403 /**
1404  * gtk_hsv_new:
1405  * @void:
1406  *
1407  * Creates a new HSV color selector.
1408  *
1409  * Return value: A newly-created HSV color selector.
1410  **/
1411 GtkWidget*
1412 gtk_hsv_new (void)
1413 {
1414   return g_object_new (GTK_TYPE_HSV, NULL);
1415 }
1416
1417 /**
1418  * gtk_hsv_set_color:
1419  * @hsv: An HSV color selector.
1420  * @h: Hue.
1421  * @s: Saturation.
1422  * @v: Value.
1423  *
1424  * Sets the current color in an HSV color selector.  Color component values must
1425  * be in the [0.0, 1.0] range.
1426  **/
1427 void
1428 gtk_hsv_set_color (GtkHSV *hsv,
1429                    gdouble h,
1430                    gdouble s,
1431                    gdouble v)
1432 {
1433   HSVPrivate *priv;
1434
1435   g_return_if_fail (hsv != NULL);
1436   g_return_if_fail (GTK_IS_HSV (hsv));
1437   g_return_if_fail (h >= 0.0 && h <= 1.0);
1438   g_return_if_fail (s >= 0.0 && s <= 1.0);
1439   g_return_if_fail (v >= 0.0 && v <= 1.0);
1440
1441   priv = hsv->priv;
1442
1443   priv->h = h;
1444   priv->s = s;
1445   priv->v = v;
1446
1447   g_signal_emit (hsv, hsv_signals[CHANGED], 0);
1448
1449   gtk_widget_queue_draw (GTK_WIDGET (hsv));
1450 }
1451
1452 /**
1453  * gtk_hsv_get_color:
1454  * @hsv: An HSV color selector.
1455  * @h: Return value for the hue.
1456  * @s: Return value for the saturation.
1457  * @v: Return value for the value.
1458  *
1459  * Queries the current color in an HSV color selector.  Returned values will be
1460  * in the [0.0, 1.0] range.
1461  **/
1462 void
1463 gtk_hsv_get_color (GtkHSV *hsv, double *h, double *s, double *v)
1464 {
1465   HSVPrivate *priv;
1466
1467   g_return_if_fail (GTK_IS_HSV (hsv));
1468
1469   priv = hsv->priv;
1470
1471   if (h)
1472     *h = priv->h;
1473
1474   if (s)
1475     *s = priv->s;
1476
1477   if (v)
1478     *v = priv->v;
1479 }
1480
1481 /**
1482  * gtk_hsv_set_metrics:
1483  * @hsv: An HSV color selector.
1484  * @size: Diameter for the hue ring.
1485  * @ring_width: Width of the hue ring.
1486  *
1487  * Sets the size and ring width of an HSV color selector.
1488  **/
1489 void
1490 gtk_hsv_set_metrics (GtkHSV *hsv,
1491                      gint    size,
1492                      gint    ring_width)
1493 {
1494   HSVPrivate *priv;
1495   int same_size;
1496
1497   g_return_if_fail (GTK_IS_HSV (hsv));
1498   g_return_if_fail (size > 0);
1499   g_return_if_fail (ring_width > 0);
1500   g_return_if_fail (2 * ring_width + 1 <= size);
1501
1502   priv = hsv->priv;
1503
1504   same_size = (priv->size == size);
1505
1506   priv->size = size;
1507   priv->ring_width = ring_width;
1508
1509   if (same_size)
1510     gtk_widget_queue_draw (GTK_WIDGET (hsv));
1511   else
1512     gtk_widget_queue_resize (GTK_WIDGET (hsv));
1513 }
1514
1515 /**
1516  * gtk_hsv_get_metrics:
1517  * @hsv: An HSV color selector.
1518  * @size: Return value for the diameter of the hue ring.
1519  * @ring_width: Return value for the width of the hue ring.
1520  *
1521  * Queries the size and ring width of an HSV color selector.
1522  **/
1523 void
1524 gtk_hsv_get_metrics (GtkHSV *hsv,
1525                      gint   *size,
1526                      gint   *ring_width)
1527 {
1528   HSVPrivate *priv;
1529
1530   g_return_if_fail (GTK_IS_HSV (hsv));
1531
1532   priv = hsv->priv;
1533
1534   if (size)
1535     *size = priv->size;
1536
1537   if (ring_width)
1538     *ring_width = priv->ring_width;
1539 }
1540
1541 /**
1542  * gtk_hsv_is_adjusting:
1543  * @hsv:
1544  *
1545  * An HSV color selector can be said to be adjusting if multiple rapid changes
1546  * are being made to its value, for example, when the user is adjusting the
1547  * value with the mouse.  This function queries whether the HSV color selector
1548  * is being adjusted or not.
1549  *
1550  * Return value: TRUE if clients can ignore changes to the color value, since
1551  * they may be transitory, or FALSE if they should consider the color value
1552  * status to be final.
1553  **/
1554 gboolean
1555 gtk_hsv_is_adjusting (GtkHSV *hsv)
1556 {
1557   HSVPrivate *priv;
1558
1559   g_return_val_if_fail (GTK_IS_HSV (hsv), FALSE);
1560
1561   priv = hsv->priv;
1562
1563   return priv->mode != DRAG_NONE;
1564 }
1565
1566 /**
1567  * gtk_hsv_to_rgb:
1568  * @h: Hue.
1569  * @s: Saturation.
1570  * @v: Value.
1571  * @r: Return value for the red component.
1572  * @g: Return value for the green component.
1573  * @b: Return value for the blue component.
1574  *
1575  * Converts a color from HSV space to RGB.  Input values must be in the
1576  * [0.0, 1.0] range; output values will be in the same range.
1577  **/
1578 void
1579 gtk_hsv_to_rgb (gdouble  h,
1580                 gdouble  s,
1581                 gdouble  v,
1582                 gdouble *r,
1583                 gdouble *g,
1584                 gdouble *b)
1585 {
1586   g_return_if_fail (h >= 0.0 && h <= 1.0);
1587   g_return_if_fail (s >= 0.0 && s <= 1.0);
1588   g_return_if_fail (v >= 0.0 && v <= 1.0);
1589
1590   hsv_to_rgb (&h, &s, &v);
1591
1592   if (r)
1593     *r = h;
1594
1595   if (g)
1596     *g = s;
1597
1598   if (b)
1599     *b = v;
1600 }
1601
1602 /**
1603  * gtk_hsv_to_rgb:
1604  * @r: Red.
1605  * @g: Green.
1606  * @b: Blue.
1607  * @h: Return value for the hue component.
1608  * @s: Return value for the saturation component.
1609  * @v: Return value for the value component.
1610  *
1611  * Converts a color from RGB space to HSV.  Input values must be in the
1612  * [0.0, 1.0] range; output values will be in the same range.
1613  **/
1614 void
1615 gtk_rgb_to_hsv (gdouble  r,
1616                 gdouble  g,
1617                 gdouble  b,
1618                 gdouble *h,
1619                 gdouble *s,
1620                 gdouble *v)
1621 {
1622   g_return_if_fail (r >= 0.0 && r <= 1.0);
1623   g_return_if_fail (g >= 0.0 && g <= 1.0);
1624   g_return_if_fail (b >= 0.0 && b <= 1.0);
1625
1626   rgb_to_hsv (&r, &g, &b);
1627
1628   if (h)
1629     *h = r;
1630
1631   if (s)
1632     *s = g;
1633
1634   if (v)
1635     *v = b;
1636 }
1637
1638 static void
1639 gtk_hsv_move (GtkHSV          *hsv,
1640               GtkDirectionType dir)
1641 {
1642   HSVPrivate *priv;
1643   gdouble hue, sat, val;
1644   gint hx, hy, sx, sy, vx, vy; /* HSV vertices */
1645   gint x, y; /* position in triangle */
1646
1647   priv = hsv->priv;
1648
1649   hue = priv->h;
1650   sat = priv->s;
1651   val = priv->v;
1652
1653   compute_triangle (hsv, &hx, &hy, &sx, &sy, &vx, &vy);
1654
1655   x = floor (sx + (vx - sx) * priv->v + (hx - vx) * priv->s * priv->v + 0.5);
1656   y = floor (sy + (vy - sy) * priv->v + (hy - vy) * priv->s * priv->v + 0.5);
1657
1658 #define HUE_DELTA 0.002
1659   switch (dir)
1660     {
1661     case GTK_DIR_UP:
1662       if (priv->focus_on_ring)
1663         hue += HUE_DELTA;
1664       else
1665         {
1666           y -= 1;
1667           compute_sv (hsv, x, y, &sat, &val);
1668         }
1669       break;
1670
1671     case GTK_DIR_DOWN:
1672       if (priv->focus_on_ring)
1673         hue -= HUE_DELTA;
1674       else
1675         {
1676           y += 1;
1677           compute_sv (hsv, x, y, &sat, &val);
1678         }
1679       break;
1680
1681     case GTK_DIR_LEFT:
1682       if (priv->focus_on_ring)
1683         hue += HUE_DELTA;
1684       else
1685         {
1686           x -= 1;
1687           compute_sv (hsv, x, y, &sat, &val);
1688         }
1689       break;
1690
1691     case GTK_DIR_RIGHT:
1692       if (priv->focus_on_ring)
1693         hue -= HUE_DELTA
1694           ;
1695       else
1696         {
1697           x += 1;
1698           compute_sv (hsv, x, y, &sat, &val);
1699         }
1700       break;
1701
1702     default:
1703       /* we don't care about the tab directions */
1704       break;
1705     }
1706
1707   /* Wrap */
1708   if (hue < 0.0)
1709     hue = 1.0;
1710   else if (hue > 1.0)
1711     hue = 0.0;
1712
1713   gtk_hsv_set_color (hsv, hue, sat, val);
1714 }