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