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      (GtkContainer    *container,
 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_CONTAINER, &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   GtkContainerClass *container_class;
 155   GtkHSVClass    *hsv_class;
 156   GtkBindingSet *binding_set;
 157
 158   object_class = (GtkObjectClass *) class;
 159   widget_class = (GtkWidgetClass *) class;
 160   container_class = GTK_CONTAINER_CLASS (class);
 161   hsv_class = GTK_HSV_CLASS (class);
 162
 163   parent_class = gtk_type_class (GTK_TYPE_WIDGET);
 164
 165   object_class->destroy = gtk_hsv_destroy;
 166
 167   widget_class->map = gtk_hsv_map;
 168   widget_class->unmap = gtk_hsv_unmap;
 169   widget_class->realize = gtk_hsv_realize;
 170   widget_class->unrealize = gtk_hsv_unrealize;
 171   widget_class->size_request = gtk_hsv_size_request;
 172   widget_class->size_allocate = gtk_hsv_size_allocate;
 173   widget_class->button_press_event = gtk_hsv_button_press;
 174   widget_class->button_release_event = gtk_hsv_button_release;
 175   widget_class->motion_notify_event = gtk_hsv_motion;
 176   widget_class->expose_event = gtk_hsv_expose;
 177
 178   container_class->focus = gtk_hsv_focus;
 179
 180   hsv_class->move = gtk_hsv_move;
 181
 182   hsv_signals[CHANGED] =
 183     gtk_signal_new ("changed",
 184                     GTK_RUN_FIRST,
 185                     GTK_CLASS_TYPE (object_class),
 186                     GTK_SIGNAL_OFFSET (GtkHSVClass, changed),
 187                     gtk_marshal_VOID__VOID,
 188                     GTK_TYPE_NONE, 0);
 189
 190   hsv_signals[MOVE] =
 191     gtk_signal_new ("move",
 192                     GTK_RUN_LAST | GTK_RUN_ACTION,
 193                     GTK_CLASS_TYPE (object_class),
 194                     GTK_SIGNAL_OFFSET (GtkHSVClass, move),
 195                     gtk_marshal_VOID__ENUM,
 196                     GTK_TYPE_NONE, 1, GTK_TYPE_DIRECTION_TYPE);
 197
 198   binding_set = gtk_binding_set_by_class (class);
 199
 200   gtk_binding_entry_add_signal (binding_set, GDK_Up, 0,
 201                                 "move", 1,
 202                                 GTK_TYPE_ENUM, GTK_DIR_UP);
 203   gtk_binding_entry_add_signal (binding_set, GDK_KP_Up, 0,
 204                                 "move", 1,
 205                                 GTK_TYPE_ENUM, GTK_DIR_UP);
 206
 207   gtk_binding_entry_add_signal (binding_set, GDK_Down, 0,
 208                                 "move", 1,
 209                                 GTK_TYPE_ENUM, GTK_DIR_DOWN);
 210   gtk_binding_entry_add_signal (binding_set, GDK_KP_Down, 0,
 211                                 "move", 1,
 212                                 GTK_TYPE_ENUM, GTK_DIR_DOWN);
 213
 214
 215   gtk_binding_entry_add_signal (binding_set, GDK_Right, 0,
 216                                 "move", 1,
 217                                 GTK_TYPE_ENUM, GTK_DIR_RIGHT);
 218   gtk_binding_entry_add_signal (binding_set, GDK_KP_Right, 0,
 219                                 "move", 1,
 220                                 GTK_TYPE_ENUM, GTK_DIR_RIGHT);
 221
 222   gtk_binding_entry_add_signal (binding_set, GDK_Left, 0,
 223                                 "move", 1,
 224                                 GTK_TYPE_ENUM, GTK_DIR_LEFT);
 225   gtk_binding_entry_add_signal (binding_set, GDK_KP_Left, 0,
 226                                 "move", 1,
 227                                 GTK_TYPE_ENUM, GTK_DIR_LEFT);
 228 }
 229
 230 /* Object initialization function for the HSV color selector */
 231 static void
 232 gtk_hsv_init (GtkHSV *hsv)
 233 {
 234   HSVPrivate *priv;
 235
 236   priv = g_new0 (HSVPrivate, 1);
 237   hsv->priv = priv;
 238
 239   GTK_WIDGET_SET_FLAGS (hsv, GTK_NO_WINDOW);
 240   GTK_WIDGET_SET_FLAGS (hsv, GTK_CAN_FOCUS);
 241
 242   priv->h = 0.0;
 243   priv->s = 0.0;
 244   priv->v = 0.0;
 245
 246   priv->size = DEFAULT_SIZE;
 247   priv->ring_width = DEFAULT_RING_WIDTH;
 248 }
 249
 250 /* Destroy handler for the HSV color selector */
 251 static void
 252 gtk_hsv_destroy (GtkObject *object)
 253 {
 254   GtkHSV *hsv;
 255
 256   g_return_if_fail (GTK_IS_HSV (object));
 257
 258   hsv = GTK_HSV (object);
 259
 260   if (hsv->priv)
 261     {
 262       g_free (hsv->priv);
 263       hsv->priv = NULL;
 264     }
 265
 266   GTK_OBJECT_CLASS (parent_class)->destroy (object);
 267 }
 268
 269 /* Default signal handlers */
 270
 271 /* Map handler for the HSV color selector */
 272 static void
 273 gtk_hsv_map (GtkWidget *widget)
 274 {
 275   GtkHSV *hsv;
 276   HSVPrivate *priv;
 277
 278   hsv = GTK_HSV (widget);
 279   priv = hsv->priv;
 280
 281   if (GTK_WIDGET_MAPPED (widget))
 282     return;
 283
 284   GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
 285
 286   gdk_window_show (priv->window);
 287 }
 288
 289 /* Unmap handler for the HSV color selector */
 290 static void
 291 gtk_hsv_unmap (GtkWidget *widget)
 292 {
 293   GtkHSV *hsv;
 294   HSVPrivate *priv;
 295
 296   hsv = GTK_HSV (widget);
 297   priv = hsv->priv;
 298
 299   if (!GTK_WIDGET_MAPPED (widget))
 300     return;
 301
 302   GTK_WIDGET_UNSET_FLAGS (widget, GTK_MAPPED);
 303
 304   gdk_window_hide (priv->window);
 305 }
 306
 307 /* Realize handler for the HSV color selector */
 308 static void
 309 gtk_hsv_realize (GtkWidget *widget)
 310 {
 311   GtkHSV *hsv;
 312   HSVPrivate *priv;
 313   GdkWindowAttr attr;
 314   int attr_mask;
 315   GdkWindow *parent_window;
 316
 317   hsv = GTK_HSV (widget);
 318   priv = hsv->priv;
 319
 320   GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
 321
 322   /* Create window */
 323
 324   attr.window_type = GDK_WINDOW_CHILD;
 325   attr.x = widget->allocation.x;
 326   attr.y = widget->allocation.y;
 327   attr.width = widget->allocation.width;
 328   attr.height = widget->allocation.height;
 329   attr.wclass = GDK_INPUT_ONLY;
 330   attr.event_mask = gtk_widget_get_events (widget);
 331   attr.event_mask |= (GDK_KEY_PRESS_MASK
 332                       | GDK_BUTTON_PRESS_MASK
 333                       | GDK_BUTTON_RELEASE_MASK
 334                       | GDK_POINTER_MOTION_MASK);
 335
 336   attr_mask = GDK_WA_X | GDK_WA_Y;
 337
 338   parent_window = gtk_widget_get_parent_window (widget);
 339
 340   widget->window = parent_window;
 341   gdk_window_ref (widget->window);
 342
 343   priv->window = gdk_window_new (parent_window, &attr, attr_mask);
 344   gdk_window_set_user_data (priv->window, hsv);
 345
 346   widget->style = gtk_style_attach (widget->style, widget->window);
 347
 348   /* Create GC */
 349
 350   priv->gc = gdk_gc_new (parent_window);
 351 }
 352
 353 /* Unrealize handler for the HSV color selector */
 354 static void
 355 gtk_hsv_unrealize (GtkWidget *widget)
 356 {
 357   GtkHSV *hsv;
 358   HSVPrivate *priv;
 359
 360   hsv = GTK_HSV (widget);
 361   priv = hsv->priv;
 362
 363   gdk_window_set_user_data (priv->window, NULL);
 364   gdk_window_destroy (priv->window);
 365   priv->window = NULL;
 366
 367   gdk_gc_unref (priv->gc);
 368   priv->gc = NULL;
 369
 370   if (GTK_WIDGET_CLASS (parent_class)->unrealize)
 371     GTK_WIDGET_CLASS (parent_class)->unrealize (widget);
 372 }
 373
 374 /* Size_request handler for the HSV color selector */
 375 static void
 376 gtk_hsv_size_request (GtkWidget      *widget,
 377                       GtkRequisition *requisition)
 378 {
 379   GtkHSV *hsv;
 380   HSVPrivate *priv;
 381
 382   hsv = GTK_HSV (widget);
 383   priv = hsv->priv;
 384
 385   requisition->width = priv->size;
 386   requisition->height = priv->size;
 387 }
 388
 389 /* Size_allocate handler for the HSV color selector */
 390 static void
 391 gtk_hsv_size_allocate (GtkWidget     *widget,
 392                        GtkAllocation *allocation)
 393 {
 394   GtkHSV *hsv;
 395   HSVPrivate *priv;
 396
 397   hsv = GTK_HSV (widget);
 398   priv = hsv->priv;
 399
 400   widget->allocation = *allocation;
 401
 402   if (GTK_WIDGET_REALIZED (widget))
 403     gdk_window_move_resize (priv->window,
 404                             allocation->x,
 405                             allocation->y,
 406                             allocation->width,
 407                             allocation->height);
 408 }
 409
 410
 411 /* Utility functions */
 412
 413 #define INTENSITY(r, g, b) ((r) * 0.30 + (g) * 0.59 + (b) * 0.11)
 414
 415 /* Converts from HSV to RGB */
 416 static void
 417 hsv_to_rgb (gdouble *h,
 418             gdouble *s,
 419             gdouble *v)
 420 {
 421   gdouble hue, saturation, value;
 422   gdouble f, p, q, t;
 423
 424   if (*s == 0.0)
 425     {
 426       *h = *v;
 427       *s = *v;
 428       *v = *v; /* heh */
 429     }
 430   else
 431     {
 432       hue = *h * 6.0;
 433       saturation = *s;
 434       value = *v;
 435
 436       if (hue == 6.0)
 437         hue = 0.0;
 438
 439       f = hue - (int) hue;
 440       p = value * (1.0 - saturation);
 441       q = value * (1.0 - saturation * f);
 442       t = value * (1.0 - saturation * (1.0 - f));
 443
 444       switch ((int) hue)
 445         {
 446         case 0:
 447           *h = value;
 448           *s = t;
 449           *v = p;
 450           break;
 451
 452         case 1:
 453           *h = q;
 454           *s = value;
 455           *v = p;
 456           break;
 457
 458         case 2:
 459           *h = p;
 460           *s = value;
 461           *v = t;
 462           break;
 463
 464         case 3:
 465           *h = p;
 466           *s = q;
 467           *v = value;
 468           break;
 469
 470         case 4:
 471           *h = t;
 472           *s = p;
 473           *v = value;
 474           break;
 475
 476         case 5:
 477           *h = value;
 478           *s = p;
 479           *v = q;
 480           break;
 481
 482         default:
 483           g_assert_not_reached ();
 484         }
 485     }
 486 }
 487
 488 /* Converts from RGB to HSV */
 489 static void
 490 rgb_to_hsv (gdouble *r,
 491             gdouble *g,
 492             gdouble *b)
 493 {
 494   gdouble red, green, blue;
 495   gdouble h, s, v;
 496   gdouble min, max;
 497   gdouble delta;
 498
 499   red = *r;
 500   green = *g;
 501   blue = *b;
 502
 503   h = 0.0;
 504
 505   if (red > green)
 506     {
 507       if (red > blue)
 508         max = red;
 509       else
 510         max = blue;
 511
 512       if (green < blue)
 513         min = green;
 514       else
 515         min = blue;
 516     }
 517   else
 518     {
 519       if (green > blue)
 520         max = green;
 521       else
 522         max = blue;
 523
 524       if (red < blue)
 525         min = red;
 526       else
 527         min = blue;
 528     }
 529
 530   v = max;
 531
 532   if (max != 0.0)
 533     s = (max - min) / max;
 534   else
 535     s = 0.0;
 536
 537   if (s == 0.0)
 538     h = 0.0;
 539   else
 540     {
 541       delta = max - min;
 542
 543       if (red == max)
 544         h = (green - blue) / delta;
 545       else if (green == max)
 546         h = 2 + (blue - red) / delta;
 547       else if (blue == max)
 548         h = 4 + (red - green) / delta;
 549
 550       h /= 6.0;
 551
 552       if (h < 0.0)
 553         h += 1.0;
 554       else if (h > 1.0)
 555         h -= 1.0;
 556     }
 557
 558   *r = h;
 559   *g = s;
 560   *b = v;
 561 }
 562
 563 /* Computes the vertices of the saturation/value triangle */
 564 static void
 565 compute_triangle (GtkHSV *hsv,
 566                   gint   *hx,
 567                   gint   *hy,
 568                   gint   *sx,
 569                   gint   *sy,
 570                   gint   *vx,
 571                   gint   *vy)
 572 {
 573   HSVPrivate *priv;
 574   gdouble center;
 575   gdouble inner, outer;
 576   gdouble angle;
 577
 578   priv = hsv->priv;
 579
 580   center = priv->size / 2.0;
 581   outer = priv->size / 2.0;
 582   inner = outer - priv->ring_width;
 583   angle = priv->h * 2.0 * G_PI;
 584
 585   *hx = floor (center + cos (angle) * inner + 0.5);
 586   *hy = floor (center - sin (angle) * inner + 0.5);
 587   *sx = floor (center + cos (angle + 2.0 * G_PI / 3.0) * inner + 0.5);
 588   *sy = floor (center - sin (angle + 2.0 * G_PI / 3.0) * inner + 0.5);
 589   *vx = floor (center + cos (angle + 4.0 * G_PI / 3.0) * inner + 0.5);
 590   *vy = floor (center - sin (angle + 4.0 * G_PI / 3.0) * inner + 0.5);
 591 }
 592
 593 /* Computes whether a point is inside the hue ring */
 594 static gboolean
 595 is_in_ring (GtkHSV *hsv,
 596             gdouble x,
 597             gdouble y)
 598 {
 599   HSVPrivate *priv;
 600   gdouble dx, dy, dist;
 601   gdouble center, inner, outer;
 602
 603   priv = hsv->priv;
 604
 605   center = priv->size / 2.0;
 606   outer = priv->size / 2.0;
 607   inner = outer - priv->ring_width;
 608
 609   dx = x - center;
 610   dy = center - y;
 611   dist = dx * dx + dy * dy;
 612
 613   return (dist >= inner * inner && dist <= outer * outer);
 614 }
 615
 616 /* Computes a saturation/value pair based on the mouse coordinates */
 617 static void
 618 compute_sv (GtkHSV  *hsv,
 619             gdouble  x,
 620             gdouble  y,
 621             gdouble *s,
 622             gdouble *v)
 623 {
 624   HSVPrivate *priv;
 625   int ihx, ihy, isx, isy, ivx, ivy;
 626   double hx, hy, sx, sy, vx, vy;
 627   double center;
 628
 629   priv = hsv->priv;
 630
 631   compute_triangle (hsv, &ihx, &ihy, &isx, &isy, &ivx, &ivy);
 632   center = priv->size / 2.0;
 633   hx = ihx - center;
 634   hy = center - ihy;
 635   sx = isx - center;
 636   sy = center - isy;
 637   vx = ivx - center;
 638   vy = center - ivy;
 639   x -= center;
 640   y = center - y;
 641
 642   if (vx * (x - sx) + vy * (y - sy) < 0.0)
 643     {
 644       *s = 1.0;
 645       *v = (((x - sx) * (hx - sx) + (y - sy) * (hy-sy))
 646             / ((hx - sx) * (hx - sx) + (hy - sy) * (hy - sy)));
 647
 648       if (*v < 0.0)
 649         *v = 0.0;
 650       else if (*v > 1.0)
 651         *v = 1.0;
 652     }
 653   else if (hx * (x - sx) + hy * (y - sy) < 0.0)
 654     {
 655       *s = 0.0;
 656       *v = (((x - sx) * (vx - sx) + (y - sy) * (vy - sy))
 657             / ((vx - sx) * (vx - sx) + (vy - sy) * (vy - sy)));
 658
 659       if (*v < 0.0)
 660         *v = 0.0;
 661       else if (*v > 1.0)
 662         *v = 1.0;
 663     }
 664   else if (sx * (x - hx) + sy * (y - hy) < 0.0)
 665     {
 666       *v = 1.0;
 667       *s = (((x - vx) * (hx - vx) + (y - vy) * (hy - vy)) /
 668             ((hx - vx) * (hx - vx) + (hy - vy) * (hy - vy)));
 669
 670       if (*s < 0.0)
 671         *s = 0.0;
 672       else if (*s > 1.0)
 673         *s = 1.0;
 674     }
 675   else
 676     {
 677       *v = (((x - sx) * (hy - vy) - (y - sy) * (hx - vx))
 678             / ((vx - sx) * (hy - vy) - (vy - sy) * (hx - vx)));
 679
 680       if (*v<= 0.0)
 681         {
 682           *v = 0.0;
 683           *s = 0.0;
 684         }
 685       else
 686         {
 687           if (*v > 1.0)
 688             *v = 1.0;
 689
 690           *s = (y - sy - *v * (vy - sy)) / (*v * (hy - vy));
 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 * inner) || dist > (outer * outer))
 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);
1263   yy = floor (sy + (vy - sy) * priv->v + (hy - vy) * priv->s * priv->v + 0.5);
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   gdk_draw_arc (drawable, priv->gc, FALSE,
1276                 xx - 3, yy - 3,
1277                 6, 6,
1278                 0, 360 * 64);
1279   gdk_draw_arc (drawable, priv->gc, FALSE,
1280                 xx - 2, yy - 2,
1281                 4, 4,
1282                 0, 360 * 64);
1283 }
1284
1285 /* Paints the contents of the HSV color selector */
1286 static void
1287 paint (GtkHSV      *hsv,
1288        GdkDrawable *drawable,
1289        gint         x,
1290        gint         y,
1291        gint         width,
1292        gint         height)
1293 {
1294   paint_ring (hsv, drawable, x, y, width, height);
1295   paint_triangle (hsv, drawable, x, y, width, height);
1296 }
1297
1298 /* Expose_event handler for the HSV color selector */
1299 static gint
1300 gtk_hsv_expose (GtkWidget      *widget,
1301                 GdkEventExpose *event)
1302 {
1303   GtkHSV *hsv;
1304   HSVPrivate *priv;
1305   GdkRectangle rect, dest;
1306   GdkPixmap *pixmap;
1307
1308   hsv = GTK_HSV (widget);
1309   priv = hsv->priv;
1310
1311   if (!(GTK_WIDGET_DRAWABLE (widget) && event->window == widget->window))
1312     return FALSE;
1313
1314   rect.x = widget->allocation.x;
1315   rect.y = widget->allocation.y;
1316   rect.width = widget->allocation.width;
1317   rect.height = widget->allocation.height;
1318
1319   if (!gdk_rectangle_intersect (&event->area, &rect, &dest))
1320     return FALSE;
1321
1322   pixmap = gdk_pixmap_new (widget->window, dest.width, dest.height,
1323                            gtk_widget_get_visual (widget)->depth);
1324
1325   rect = dest;
1326   rect.x = 0;
1327   rect.y = 0;
1328
1329   gdk_draw_rectangle (pixmap,
1330                       widget->style->bg_gc[GTK_WIDGET_STATE (widget)],
1331                       TRUE,
1332                       0, 0, dest.width, dest.height);
1333   paint (hsv, pixmap,
1334          dest.x - widget->allocation.x, dest.y - widget->allocation.y,
1335          dest.width, dest.height);
1336
1337   gdk_draw_pixmap (widget->window,
1338                    priv->gc,
1339                    pixmap,
1340                    0, 0,
1341                    dest.x,
1342                    dest.y,
1343                    event->area.width, event->area.height);
1344
1345   gdk_pixmap_unref (pixmap);
1346
1347   return FALSE;
1348 }
1349
1350 static gboolean
1351 gtk_hsv_focus (GtkContainer    *container,
1352                GtkDirectionType dir)
1353 {
1354   GtkHSV *hsv;
1355   HSVPrivate *priv;
1356
1357   hsv = GTK_HSV (container);
1358   priv = hsv->priv;
1359
1360   if (!GTK_WIDGET_DRAWABLE (container) ||
1361       !GTK_WIDGET_IS_SENSITIVE (container))
1362     return FALSE;
1363
1364   if (!GTK_WIDGET_HAS_FOCUS (hsv))
1365     {
1366       if (dir == GTK_DIR_TAB_BACKWARD)
1367         priv->focus_on_ring = FALSE;
1368       else
1369         priv->focus_on_ring = TRUE;
1370
1371       gtk_widget_grab_focus (GTK_WIDGET (hsv));
1372       return TRUE;
1373     }
1374
1375   switch (dir)
1376     {
1377     case GTK_DIR_UP:
1378       if (priv->focus_on_ring)
1379         return FALSE;
1380       else
1381         priv->focus_on_ring = TRUE;
1382       break;
1383
1384     case GTK_DIR_DOWN:
1385       if (priv->focus_on_ring)
1386         priv->focus_on_ring = FALSE;
1387       else
1388         return FALSE;
1389       break;
1390
1391     case GTK_DIR_LEFT:
1392     case GTK_DIR_TAB_BACKWARD:
1393       if (priv->focus_on_ring)
1394         return FALSE;
1395       else
1396         priv->focus_on_ring = TRUE;
1397       break;
1398
1399     case GTK_DIR_RIGHT:
1400     case GTK_DIR_TAB_FORWARD:
1401       if (priv->focus_on_ring)
1402         priv->focus_on_ring = FALSE;
1403       else
1404         return FALSE;
1405       break;
1406     }
1407
1408   gtk_widget_queue_draw (GTK_WIDGET (hsv));
1409
1410   return TRUE;
1411 }
1412
1413 /**
1414  * gtk_hsv_new:
1415  * @void:
1416  *
1417  * Creates a new HSV color selector.
1418  *
1419  * Return value: A newly-created HSV color selector.
1420  **/
1421 GtkWidget*
1422 gtk_hsv_new (void)
1423 {
1424   return GTK_WIDGET (gtk_type_new (GTK_TYPE_HSV));
1425 }
1426
1427 /**
1428  * gtk_hsv_set_color:
1429  * @hsv: An HSV color selector.
1430  * @h: Hue.
1431  * @s: Saturation.
1432  * @v: Value.
1433  *
1434  * Sets the current color in an HSV color selector.  Color component values must
1435  * be in the [0.0, 1.0] range.
1436  **/
1437 void
1438 gtk_hsv_set_color (GtkHSV *hsv,
1439                    gdouble h,
1440                    gdouble s,
1441                    gdouble v)
1442 {
1443   HSVPrivate *priv;
1444
1445   g_return_if_fail (hsv != NULL);
1446   g_return_if_fail (GTK_IS_HSV (hsv));
1447   g_return_if_fail (h >= 0.0 && h <= 1.0);
1448   g_return_if_fail (s >= 0.0 && s <= 1.0);
1449   g_return_if_fail (v >= 0.0 && v <= 1.0);
1450
1451   priv = hsv->priv;
1452
1453   priv->h = h;
1454   priv->s = s;
1455   priv->v = v;
1456
1457   gtk_signal_emit (GTK_OBJECT (hsv), hsv_signals[CHANGED]);
1458
1459   gtk_widget_queue_draw (GTK_WIDGET (hsv));
1460 }
1461
1462 /**
1463  * gtk_hsv_get_color:
1464  * @hsv: An HSV color selector.
1465  * @h: Return value for the hue.
1466  * @s: Return value for the saturation.
1467  * @v: Return value for the value.
1468  *
1469  * Queries the current color in an HSV color selector.  Returned values will be
1470  * in the [0.0, 1.0] range.
1471  **/
1472 void
1473 gtk_hsv_get_color (GtkHSV *hsv, double *h, double *s, double *v)
1474 {
1475   HSVPrivate *priv;
1476
1477   g_return_if_fail (hsv != NULL);
1478   g_return_if_fail (GTK_IS_HSV (hsv));
1479
1480   priv = hsv->priv;
1481
1482   if (h)
1483     *h = priv->h;
1484
1485   if (s)
1486     *s = priv->s;
1487
1488   if (v)
1489     *v = priv->v;
1490 }
1491
1492 /**
1493  * gtk_hsv_set_metrics:
1494  * @hsv: An HSV color selector.
1495  * @size: Diameter for the hue ring.
1496  * @ring_width: Width of the hue ring.
1497  *
1498  * Sets the size and ring width of an HSV color selector.
1499  **/
1500 void
1501 gtk_hsv_set_metrics (GtkHSV *hsv,
1502                      gint    size,
1503                      gint    ring_width)
1504 {
1505   HSVPrivate *priv;
1506   int same_size;
1507
1508   g_return_if_fail (hsv != NULL);
1509   g_return_if_fail (GTK_IS_HSV (hsv));
1510   g_return_if_fail (size > 0);
1511   g_return_if_fail (ring_width > 0);
1512   g_return_if_fail (2 * ring_width + 1 <= size);
1513
1514   priv = hsv->priv;
1515
1516   same_size = (priv->size == size);
1517
1518   priv->size = size;
1519   priv->ring_width = ring_width;
1520
1521   if (same_size)
1522     gtk_widget_queue_draw (GTK_WIDGET (hsv));
1523   else
1524     gtk_widget_queue_resize (GTK_WIDGET (hsv));
1525 }
1526
1527 /**
1528  * gtk_hsv_get_metrics:
1529  * @hsv: An HSV color selector.
1530  * @size: Return value for the diameter of the hue ring.
1531  * @ring_width: Return value for the width of the hue ring.
1532  *
1533  * Queries the size and ring width of an HSV color selector.
1534  **/
1535 void
1536 gtk_hsv_get_metrics (GtkHSV *hsv,
1537                      gint   *size,
1538                      gint   *ring_width)
1539 {
1540   HSVPrivate *priv;
1541
1542   g_return_if_fail (hsv != NULL);
1543   g_return_if_fail (GTK_IS_HSV (hsv));
1544
1545   priv = hsv->priv;
1546
1547   if (size)
1548     *size = priv->size;
1549
1550   if (ring_width)
1551     *ring_width = priv->ring_width;
1552 }
1553
1554 /**
1555  * gtk_hsv_is_adjusting:
1556  * @hsv:
1557  *
1558  * An HSV color selector can be said to be adjusting if multiple rapid changes
1559  * are being made to its value, for example, when the user is adjusting the
1560  * value with the mouse.  This function queries whether the HSV color selector
1561  * is being adjusted or not.
1562  *
1563  * Return value: TRUE if clients can ignore changes to the color value, since
1564  * they may be transitory, or FALSE if they should consider the color value
1565  * status to be final.
1566  **/
1567 gboolean
1568 gtk_hsv_is_adjusting (GtkHSV *hsv)
1569 {
1570   HSVPrivate *priv;
1571
1572   g_return_val_if_fail (hsv != NULL, FALSE);
1573   g_return_val_if_fail (GTK_IS_HSV (hsv), FALSE);
1574
1575   priv = hsv->priv;
1576
1577   return priv->mode != DRAG_NONE;
1578 }
1579
1580 /**
1581  * gtk_hsv_to_rgb:
1582  * @h: Hue.
1583  * @s: Saturation.
1584  * @v: Value.
1585  * @r: Return value for the red component.
1586  * @g: Return value for the green component.
1587  * @b: Return value for the blue component.
1588  *
1589  * Converts a color from HSV space to RGB.  Input values must be in the
1590  * [0.0, 1.0] range; output values will be in the same range.
1591  **/
1592 void
1593 gtk_hsv_to_rgb (gdouble  h,
1594                 gdouble  s,
1595                 gdouble  v,
1596                 gdouble *r,
1597                 gdouble *g,
1598                 gdouble *b)
1599 {
1600   g_return_if_fail (h >= 0.0 && h <= 1.0);
1601   g_return_if_fail (s >= 0.0 && s <= 1.0);
1602   g_return_if_fail (v >= 0.0 && v <= 1.0);
1603
1604   hsv_to_rgb (&h, &s, &v);
1605
1606   if (r)
1607     *r = h;
1608
1609   if (g)
1610     *g = s;
1611
1612   if (b)
1613     *b = v;
1614 }
1615
1616 /**
1617  * gtk_hsv_to_rgb:
1618  * @r: Red.
1619  * @g: Green.
1620  * @b: Blue.
1621  * @h: Return value for the hue component.
1622  * @s: Return value for the saturation component.
1623  * @v: Return value for the value component.
1624  *
1625  * Converts a color from RGB space to HSV.  Input values must be in the
1626  * [0.0, 1.0] range; output values will be in the same range.
1627  **/
1628 void
1629 gtk_rgb_to_hsv (gdouble  r,
1630                 gdouble  g,
1631                 gdouble  b,
1632                 gdouble *h,
1633                 gdouble *s,
1634                 gdouble *v)
1635 {
1636   g_return_if_fail (r >= 0.0 && r <= 1.0);
1637   g_return_if_fail (g >= 0.0 && g <= 1.0);
1638   g_return_if_fail (b >= 0.0 && b <= 1.0);
1639
1640   rgb_to_hsv (&r, &g, &b);
1641
1642   if (h)
1643     *h = r;
1644
1645   if (s)
1646     *s = g;
1647
1648   if (v)
1649     *v = b;
1650 }
1651
1652 static void
1653 gtk_hsv_move (GtkHSV          *hsv,
1654               GtkDirectionType dir)
1655 {
1656   HSVPrivate *priv;
1657   gdouble hue, sat, val;
1658   gint hx, hy, sx, sy, vx, vy; /* HSV vertices */
1659   gint x, y; /* position in triangle */
1660
1661   priv = hsv->priv;
1662
1663   hue = priv->h;
1664   sat = priv->s;
1665   val = priv->v;
1666
1667   compute_triangle (hsv, &hx, &hy, &sx, &sy, &vx, &vy);
1668
1669   x = floor (sx + (vx - sx) * priv->v + (hx - vx) * priv->s * priv->v + 0.5);
1670   y = floor (sy + (vy - sy) * priv->v + (hy - vy) * priv->s * priv->v + 0.5);
1671
1672 #define HUE_DELTA 0.002
1673   switch (dir)
1674     {
1675     case GTK_DIR_UP:
1676       if (priv->focus_on_ring)
1677         hue += HUE_DELTA;
1678       else
1679         {
1680           y -= 1;
1681           compute_sv (hsv, x, y, &sat, &val);
1682         }
1683       break;
1684
1685     case GTK_DIR_DOWN:
1686       if (priv->focus_on_ring)
1687         hue -= HUE_DELTA;
1688       else
1689         {
1690           y += 1;
1691           compute_sv (hsv, x, y, &sat, &val);
1692         }
1693       break;
1694
1695     case GTK_DIR_LEFT:
1696       if (priv->focus_on_ring)
1697         hue += HUE_DELTA;
1698       else
1699         {
1700           x -= 1;
1701           compute_sv (hsv, x, y, &sat, &val);
1702         }
1703       break;
1704
1705     case GTK_DIR_RIGHT:
1706       if (priv->focus_on_ring)
1707         hue -= HUE_DELTA
1708           ;
1709       else
1710         {
1711           x += 1;
1712           compute_sv (hsv, x, y, &sat, &val);
1713         }
1714       break;
1715
1716     default:
1717       /* we don't care about the tab directions */
1718       break;
1719     }
1720
1721   /* Wrap */
1722   if (hue < 0.0)
1723     hue = 1.0;
1724   else if (hue > 1.0)
1725     hue = 0.0;
1726
1727   gtk_hsv_set_color (hsv, hue, sat, val);
1728 }
1729