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                       | GDK_ENTER_NOTIFY_MASK
 336                       | GDK_LEAVE_NOTIFY_MASK);
 337
 338   attr_mask = GDK_WA_X | GDK_WA_Y;
 339
 340   parent_window = gtk_widget_get_parent_window (widget);
 341
 342   widget->window = parent_window;
 343   gdk_window_ref (widget->window);
 344
 345   priv->window = gdk_window_new (parent_window, &attr, attr_mask);
 346   gdk_window_set_user_data (priv->window, hsv);
 347
 348   widget->style = gtk_style_attach (widget->style, widget->window);
 349
 350   /* Create GC */
 351
 352   priv->gc = gdk_gc_new (parent_window);
 353 }
 354
 355 /* Unrealize handler for the HSV color selector */
 356 static void
 357 gtk_hsv_unrealize (GtkWidget *widget)
 358 {
 359   GtkHSV *hsv;
 360   HSVPrivate *priv;
 361
 362   hsv = GTK_HSV (widget);
 363   priv = hsv->priv;
 364
 365   gdk_window_set_user_data (priv->window, NULL);
 366   gdk_window_destroy (priv->window);
 367   priv->window = NULL;
 368
 369   gdk_gc_unref (priv->gc);
 370   priv->gc = NULL;
 371
 372   if (GTK_WIDGET_CLASS (parent_class)->unrealize)
 373     GTK_WIDGET_CLASS (parent_class)->unrealize (widget);
 374 }
 375
 376 /* Size_request handler for the HSV color selector */
 377 static void
 378 gtk_hsv_size_request (GtkWidget      *widget,
 379                       GtkRequisition *requisition)
 380 {
 381   GtkHSV *hsv;
 382   HSVPrivate *priv;
 383
 384   hsv = GTK_HSV (widget);
 385   priv = hsv->priv;
 386
 387   requisition->width = priv->size;
 388   requisition->height = priv->size;
 389 }
 390
 391 /* Size_allocate handler for the HSV color selector */
 392 static void
 393 gtk_hsv_size_allocate (GtkWidget     *widget,
 394                        GtkAllocation *allocation)
 395 {
 396   GtkHSV *hsv;
 397   HSVPrivate *priv;
 398
 399   hsv = GTK_HSV (widget);
 400   priv = hsv->priv;
 401
 402   widget->allocation = *allocation;
 403
 404   if (GTK_WIDGET_REALIZED (widget))
 405     gdk_window_move_resize (priv->window,
 406                             allocation->x,
 407                             allocation->y,
 408                             allocation->width,
 409                             allocation->height);
 410 }
 411
 412
 413 /* Utility functions */
 414
 415 #define INTENSITY(r, g, b) ((r) * 0.30 + (g) * 0.59 + (b) * 0.11)
 416
 417 /* Converts from HSV to RGB */
 418 static void
 419 hsv_to_rgb (gdouble *h,
 420             gdouble *s,
 421             gdouble *v)
 422 {
 423   gdouble hue, saturation, value;
 424   gdouble f, p, q, t;
 425
 426   if (*s == 0.0)
 427     {
 428       *h = *v;
 429       *s = *v;
 430       *v = *v; /* heh */
 431     }
 432   else
 433     {
 434       hue = *h * 6.0;
 435       saturation = *s;
 436       value = *v;
 437
 438       if (hue == 6.0)
 439         hue = 0.0;
 440
 441       f = hue - (int) hue;
 442       p = value * (1.0 - saturation);
 443       q = value * (1.0 - saturation * f);
 444       t = value * (1.0 - saturation * (1.0 - f));
 445
 446       switch ((int) hue)
 447         {
 448         case 0:
 449           *h = value;
 450           *s = t;
 451           *v = p;
 452           break;
 453
 454         case 1:
 455           *h = q;
 456           *s = value;
 457           *v = p;
 458           break;
 459
 460         case 2:
 461           *h = p;
 462           *s = value;
 463           *v = t;
 464           break;
 465
 466         case 3:
 467           *h = p;
 468           *s = q;
 469           *v = value;
 470           break;
 471
 472         case 4:
 473           *h = t;
 474           *s = p;
 475           *v = value;
 476           break;
 477
 478         case 5:
 479           *h = value;
 480           *s = p;
 481           *v = q;
 482           break;
 483
 484         default:
 485           g_assert_not_reached ();
 486         }
 487     }
 488 }
 489
 490 /* Converts from RGB to HSV */
 491 static void
 492 rgb_to_hsv (gdouble *r,
 493             gdouble *g,
 494             gdouble *b)
 495 {
 496   gdouble red, green, blue;
 497   gdouble h, s, v;
 498   gdouble min, max;
 499   gdouble delta;
 500
 501   red = *r;
 502   green = *g;
 503   blue = *b;
 504
 505   h = 0.0;
 506
 507   if (red > green)
 508     {
 509       if (red > blue)
 510         max = red;
 511       else
 512         max = blue;
 513
 514       if (green < blue)
 515         min = green;
 516       else
 517         min = blue;
 518     }
 519   else
 520     {
 521       if (green > blue)
 522         max = green;
 523       else
 524         max = blue;
 525
 526       if (red < blue)
 527         min = red;
 528       else
 529         min = blue;
 530     }
 531
 532   v = max;
 533
 534   if (max != 0.0)
 535     s = (max - min) / max;
 536   else
 537     s = 0.0;
 538
 539   if (s == 0.0)
 540     h = 0.0;
 541   else
 542     {
 543       delta = max - min;
 544
 545       if (red == max)
 546         h = (green - blue) / delta;
 547       else if (green == max)
 548         h = 2 + (blue - red) / delta;
 549       else if (blue == max)
 550         h = 4 + (red - green) / delta;
 551
 552       h /= 6.0;
 553
 554       if (h < 0.0)
 555         h += 1.0;
 556       else if (h > 1.0)
 557         h -= 1.0;
 558     }
 559
 560   *r = h;
 561   *g = s;
 562   *b = v;
 563 }
 564
 565 /* Computes the vertices of the saturation/value triangle */
 566 static void
 567 compute_triangle (GtkHSV *hsv,
 568                   gint   *hx,
 569                   gint   *hy,
 570                   gint   *sx,
 571                   gint   *sy,
 572                   gint   *vx,
 573                   gint   *vy)
 574 {
 575   HSVPrivate *priv;
 576   gdouble center;
 577   gdouble inner, outer;
 578   gdouble angle;
 579
 580   priv = hsv->priv;
 581
 582   center = priv->size / 2.0;
 583   outer = priv->size / 2.0;
 584   inner = outer - priv->ring_width;
 585   angle = priv->h * 2.0 * G_PI;
 586
 587   *hx = floor (center + cos (angle) * inner + 0.5);
 588   *hy = floor (center - sin (angle) * inner + 0.5);
 589   *sx = floor (center + cos (angle + 2.0 * G_PI / 3.0) * inner + 0.5);
 590   *sy = floor (center - sin (angle + 2.0 * G_PI / 3.0) * inner + 0.5);
 591   *vx = floor (center + cos (angle + 4.0 * G_PI / 3.0) * inner + 0.5);
 592   *vy = floor (center - sin (angle + 4.0 * G_PI / 3.0) * inner + 0.5);
 593 }
 594
 595 /* Computes whether a point is inside the hue ring */
 596 static gboolean
 597 is_in_ring (GtkHSV *hsv,
 598             gdouble x,
 599             gdouble y)
 600 {
 601   HSVPrivate *priv;
 602   gdouble dx, dy, dist;
 603   gdouble center, inner, outer;
 604
 605   priv = hsv->priv;
 606
 607   center = priv->size / 2.0;
 608   outer = priv->size / 2.0;
 609   inner = outer - priv->ring_width;
 610
 611   dx = x - center;
 612   dy = center - y;
 613   dist = dx * dx + dy * dy;
 614
 615   return (dist >= inner * inner && dist <= outer * outer);
 616 }
 617
 618 /* Computes a saturation/value pair based on the mouse coordinates */
 619 static void
 620 compute_sv (GtkHSV  *hsv,
 621             gdouble  x,
 622             gdouble  y,
 623             gdouble *s,
 624             gdouble *v)
 625 {
 626   HSVPrivate *priv;
 627   int ihx, ihy, isx, isy, ivx, ivy;
 628   double hx, hy, sx, sy, vx, vy;
 629   double center;
 630
 631   priv = hsv->priv;
 632
 633   compute_triangle (hsv, &ihx, &ihy, &isx, &isy, &ivx, &ivy);
 634   center = priv->size / 2.0;
 635   hx = ihx - center;
 636   hy = center - ihy;
 637   sx = isx - center;
 638   sy = center - isy;
 639   vx = ivx - center;
 640   vy = center - ivy;
 641   x -= center;
 642   y = center - y;
 643
 644   if (vx * (x - sx) + vy * (y - sy) < 0.0)
 645     {
 646       *s = 1.0;
 647       *v = (((x - sx) * (hx - sx) + (y - sy) * (hy-sy))
 648             / ((hx - sx) * (hx - sx) + (hy - sy) * (hy - sy)));
 649
 650       if (*v < 0.0)
 651         *v = 0.0;
 652       else if (*v > 1.0)
 653         *v = 1.0;
 654     }
 655   else if (hx * (x - sx) + hy * (y - sy) < 0.0)
 656     {
 657       *s = 0.0;
 658       *v = (((x - sx) * (vx - sx) + (y - sy) * (vy - sy))
 659             / ((vx - sx) * (vx - sx) + (vy - sy) * (vy - sy)));
 660
 661       if (*v < 0.0)
 662         *v = 0.0;
 663       else if (*v > 1.0)
 664         *v = 1.0;
 665     }
 666   else if (sx * (x - hx) + sy * (y - hy) < 0.0)
 667     {
 668       *v = 1.0;
 669       *s = (((x - vx) * (hx - vx) + (y - vy) * (hy - vy)) /
 670             ((hx - vx) * (hx - vx) + (hy - vy) * (hy - vy)));
 671
 672       if (*s < 0.0)
 673         *s = 0.0;
 674       else if (*s > 1.0)
 675         *s = 1.0;
 676     }
 677   else
 678     {
 679       *v = (((x - sx) * (hy - vy) - (y - sy) * (hx - vx))
 680             / ((vx - sx) * (hy - vy) - (vy - sy) * (hx - vx)));
 681
 682       if (*v<= 0.0)
 683         {
 684           *v = 0.0;
 685           *s = 0.0;
 686         }
 687       else
 688         {
 689           if (*v > 1.0)
 690             *v = 1.0;
 691
 692           if (fabs (hy - vy) < fabs (hx - vx))
 693             *s = (x - sx - *v * (vx - sx)) / (*v * (hx - vx));
 694           else
 695             *s = (y - sy - *v * (vy - sy)) / (*v * (hy - vy));
 696
 697           if (*s < 0.0)
 698             *s = 0.0;
 699           else if (*s > 1.0)
 700             *s = 1.0;
 701         }
 702     }
 703 }
 704
 705 /* Computes whether a point is inside the saturation/value triangle */
 706 static gboolean
 707 is_in_triangle (GtkHSV *hsv,
 708                 gdouble x,
 709                 gdouble y)
 710 {
 711   int hx, hy, sx, sy, vx, vy;
 712   double det, s, v;
 713
 714   compute_triangle (hsv, &hx, &hy, &sx, &sy, &vx, &vy);
 715
 716   det = (vx - sx) * (hy - sy) - (vy - sy) * (hx - sx);
 717
 718   s = ((x - sx) * (hy - sy) - (y - sy) * (hx - sx)) / det;
 719   v = ((vx - sx) * (y - sy) - (vy - sy) * (x - sx)) / det;
 720
 721   return (s >= 0.0 && v >= 0.0 && s + v <= 1.0);
 722 }
 723
 724 /* Computes a value based on the mouse coordinates */
 725 static double
 726 compute_v (GtkHSV *hsv,
 727            gdouble x,
 728            gdouble y)
 729 {
 730   HSVPrivate *priv;
 731   double center;
 732   double dx, dy;
 733   double angle;
 734
 735   priv = hsv->priv;
 736
 737   center = priv->size / 2.0;
 738   dx = x - center;
 739   dy = center - y;
 740
 741   angle = atan2 (dy, dx);
 742   if (angle < 0.0)
 743     angle += 2.0 * G_PI;
 744
 745   return angle / (2.0 * G_PI);
 746 }
 747
 748 /* Event handlers */
 749
 750 static void
 751 set_cross_grab (GtkHSV *hsv,
 752                 guint32 time)
 753 {
 754   HSVPrivate *priv;
 755   GdkCursor *cursor;
 756
 757   priv = hsv->priv;
 758
 759   cursor = gdk_cursor_new (GDK_CROSSHAIR);
 760   gdk_pointer_grab (priv->window, FALSE,
 761                     (GDK_POINTER_MOTION_MASK
 762                      | GDK_POINTER_MOTION_HINT_MASK
 763                      | GDK_BUTTON_RELEASE_MASK),
 764                     NULL,
 765                     cursor,
 766                     time);
 767   gdk_cursor_destroy (cursor);
 768 }
 769
 770 /* Button_press_event handler for the HSV color selector */
 771 static gint
 772 gtk_hsv_button_press (GtkWidget      *widget,
 773                       GdkEventButton *event)
 774 {
 775   GtkHSV *hsv;
 776   HSVPrivate *priv;
 777   double x, y;
 778
 779   hsv = GTK_HSV (widget);
 780   priv = hsv->priv;
 781
 782   if (priv->mode != DRAG_NONE || event->button != 1)
 783     return FALSE;
 784
 785   x = event->x;
 786   y = event->y;
 787
 788   if (is_in_ring (hsv, x, y))
 789     {
 790       priv->mode = DRAG_H;
 791       set_cross_grab (hsv, event->time);
 792
 793       gtk_hsv_set_color (hsv,
 794                          compute_v (hsv, x, y),
 795                          priv->s,
 796                          priv->v);
 797
 798       gtk_widget_grab_focus (widget);
 799       priv->focus_on_ring = TRUE;
 800
 801       return TRUE;
 802     }
 803
 804   if (is_in_triangle (hsv, x, y))
 805     {
 806       gdouble s, v;
 807
 808       priv->mode = DRAG_SV;
 809       set_cross_grab (hsv, event->time);
 810
 811       compute_sv (hsv, x, y, &s, &v);
 812       gtk_hsv_set_color (hsv, priv->h, s, v);
 813
 814       gtk_widget_grab_focus (widget);
 815       priv->focus_on_ring = FALSE;
 816
 817       return TRUE;
 818     }
 819
 820   return FALSE;
 821 }
 822
 823 /* Button_release_event handler for the HSV color selector */
 824 static gint
 825 gtk_hsv_button_release (GtkWidget      *widget,
 826                         GdkEventButton *event)
 827 {
 828   GtkHSV *hsv;
 829   HSVPrivate *priv;
 830   DragMode mode;
 831   gdouble x, y;
 832
 833   hsv = GTK_HSV (widget);
 834   priv = hsv->priv;
 835
 836   if (priv->mode == DRAG_NONE || event->button != 1)
 837     return FALSE;
 838
 839   /* Set the drag mode to DRAG_NONE so that signal handlers for "catched"
 840    * can see that this is the final color state.
 841    */
 842
 843   mode = priv->mode;
 844   priv->mode = DRAG_NONE;
 845
 846   x = event->x;
 847   y = event->y;
 848
 849   if (mode == DRAG_H)
 850     gtk_hsv_set_color (hsv, compute_v (hsv, x, y), priv->s, priv->v);
 851   else if (mode == DRAG_SV) {
 852     double s, v;
 853
 854     compute_sv (hsv, x, y, &s, &v);
 855     gtk_hsv_set_color (hsv, priv->h, s, v);
 856   } else
 857     g_assert_not_reached ();
 858
 859   gdk_pointer_ungrab (event->time);
 860
 861   return TRUE;
 862 }
 863
 864 /* Motion_notify_event handler for the HSV color selector */
 865 static gint
 866 gtk_hsv_motion (GtkWidget      *widget,
 867                 GdkEventMotion *event)
 868 {
 869   GtkHSV *hsv;
 870   HSVPrivate *priv;
 871   double x, y;
 872   gint ix, iy;
 873   GdkModifierType mods;
 874
 875   hsv = GTK_HSV (widget);
 876   priv = hsv->priv;
 877
 878   if (priv->mode == DRAG_NONE)
 879     return FALSE;
 880
 881   if (event->is_hint)
 882     {
 883       gdk_window_get_pointer (priv->window, &ix, &iy, &mods);
 884       x = ix;
 885       y = iy;
 886     }
 887   else
 888     {
 889       x = event->x;
 890       y = event->y;
 891     }
 892
 893   if (priv->mode == DRAG_H)
 894     {
 895       gtk_hsv_set_color (hsv, compute_v (hsv, x, y), priv->s, priv->v);
 896       return TRUE;
 897     }
 898   else if (priv->mode == DRAG_SV)
 899     {
 900       double s, v;
 901
 902       compute_sv (hsv, x, y, &s, &v);
 903       gtk_hsv_set_color (hsv, priv->h, s, v);
 904       return TRUE;
 905     }
 906
 907   g_assert_not_reached ();
 908   return FALSE;
 909 }
 910
 911
 912 /* Redrawing */
 913
 914 /* Paints the hue ring */
 915 static void
 916 paint_ring (GtkHSV      *hsv,
 917             GdkDrawable *drawable,
 918             gint         x,
 919             gint         y,
 920             gint         width,
 921             gint         height)
 922 {
 923   HSVPrivate *priv;
 924   int xx, yy;
 925   gdouble dx, dy, dist;
 926   gdouble center;
 927   gdouble inner, outer;
 928   guchar *buf, *p;
 929   gdouble angle;
 930   gdouble hue;
 931   gdouble r, g, b;
 932   GdkBitmap *mask;
 933   GdkGC *gc;
 934   GdkColor color;
 935
 936   priv = hsv->priv;
 937
 938   center = priv->size / 2.0;
 939
 940   outer = priv->size / 2.0;
 941   inner = outer - priv->ring_width;
 942
 943   /* Paint the ring */
 944
 945   buf = g_new (guchar, width * height * 3);
 946
 947   for (yy = 0; yy < height; yy++)
 948     {
 949       p = buf + yy * width * 3;
 950
 951       dy = -(yy + y - center);
 952
 953       for (xx = 0; xx < width; xx++)
 954         {
 955           dx = xx + x - center;
 956
 957           dist = dx * dx + dy * dy;
 958           if (dist < ((inner-1) * (inner-1)) || dist > ((outer+1) * (outer+1)))
 959             {
 960               *p++ = 0;
 961               *p++ = 0;
 962               *p++ = 0;
 963               continue;
 964             }
 965
 966           angle = atan2 (dy, dx);
 967           if (angle < 0.0)
 968             angle += 2.0 * G_PI;
 969
 970           hue = angle / (2.0 * G_PI);
 971
 972           r = hue;
 973           g = 1.0;
 974           b = 1.0;
 975           hsv_to_rgb (&r, &g, &b);
 976
 977           *p++ = floor (r * 255 + 0.5);
 978           *p++ = floor (g * 255 + 0.5);
 979           *p++ = floor (b * 255 + 0.5);
 980         }
 981     }
 982
 983   /* Create clipping mask */
 984
 985   mask = gdk_pixmap_new (NULL, width, height, 1);
 986   gc = gdk_gc_new (mask);
 987
 988   color.pixel = 0;
 989   gdk_gc_set_foreground (gc, &color);
 990   gdk_draw_rectangle (mask, gc, TRUE,
 991                       0, 0, width, height);
 992
 993
 994   color.pixel = 1;
 995   gdk_gc_set_foreground (gc, &color);
 996   gdk_draw_arc (mask, gc, TRUE,
 997                 -x, -y,
 998                 priv->size - 1, priv->size - 1,
 999                 0, 360 * 64);
1000
1001   color.pixel = 0;
1002   gdk_gc_set_foreground (gc, &color);
1003   gdk_draw_arc (mask, gc, TRUE,
1004                 -x + priv->ring_width - 1, -y + priv->ring_width - 1,
1005                 priv->size - 2 * priv->ring_width + 1, priv->size - 2 * priv->ring_width + 1,
1006                 0, 360 * 64);
1007
1008   gdk_gc_unref (gc);
1009
1010   gdk_gc_set_clip_mask (priv->gc, mask);
1011   gdk_gc_set_clip_origin (priv->gc, 0, 0);
1012
1013   /* Draw ring */
1014
1015   gdk_draw_rgb_image_dithalign (drawable, priv->gc, 0, 0, width, height,
1016                                 GDK_RGB_DITHER_MAX,
1017                                 buf,
1018                                 width * 3,
1019                                 x, y);
1020
1021   /* Draw value marker */
1022
1023   r = priv->h;
1024   g = 1.0;
1025   b = 1.0;
1026   hsv_to_rgb (&r, &g, &b);
1027
1028   if (INTENSITY (r, g, b) > 0.5)
1029     gdk_rgb_gc_set_foreground (priv->gc, 0x000000);
1030   else
1031     gdk_rgb_gc_set_foreground (priv->gc, 0xffffff);
1032
1033   gdk_draw_line (drawable, priv->gc,
1034                  -x + center, -y + center,
1035                  -x + center + cos (priv->h * 2.0 * G_PI) * center,
1036                  -y + center - sin (priv->h * 2.0 * G_PI) * center);
1037
1038   gdk_gc_set_clip_mask (priv->gc, NULL);
1039   gdk_bitmap_unref (mask);
1040
1041   g_free (buf);
1042
1043   /* Draw ring outline */
1044
1045   if (GTK_WIDGET_HAS_FOCUS (hsv) &&
1046       priv->focus_on_ring)
1047     {
1048       gdk_rgb_gc_set_foreground (priv->gc, 0x000000);
1049
1050       gdk_draw_arc (drawable, priv->gc, FALSE,
1051                     -x, -y,
1052                     priv->size - 1, priv->size - 1,
1053                     0, 360 * 64);
1054       gdk_draw_arc (drawable, priv->gc, FALSE,
1055                     -x + priv->ring_width - 1, -y + priv->ring_width - 1,
1056                     priv->size - 2 * priv->ring_width + 1, priv->size - 2 * priv->ring_width + 1,
1057                     0, 360 * 64);
1058     }
1059 }
1060
1061 /* Converts an HSV triplet to an integer RGB triplet */
1062 static void
1063 get_color (gdouble h,
1064            gdouble s,
1065            gdouble v,
1066            gint   *r,
1067            gint   *g,
1068            gint   *b)
1069 {
1070   hsv_to_rgb (&h, &s, &v);
1071
1072   *r = floor (h * 255 + 0.5);
1073   *g = floor (s * 255 + 0.5);
1074   *b = floor (v * 255 + 0.5);
1075 }
1076
1077 #define SWAP(a, b, t) ((t) = (a), (a) = (b), (b) = (t))
1078
1079 #define LERP(a, b, v1, v2, i) (((v2) - (v1) != 0)                                       \
1080                                ? ((a) + ((b) - (a)) * ((i) - (v1)) / ((v2) - (v1)))     \
1081                                : (a))
1082
1083 /* Paints the HSV triangle */
1084 static void
1085 paint_triangle (GtkHSV      *hsv,
1086                 GdkDrawable *drawable,
1087                 gint         x,
1088                 gint         y,
1089                 gint         width,
1090                 gint         height)
1091 {
1092   HSVPrivate *priv;
1093   gint hx, hy, sx, sy, vx, vy; /* HSV vertices */
1094   gint x1, y1, r1, g1, b1; /* First vertex in scanline order */
1095   gint x2, y2, r2, g2, b2; /* Second vertex */
1096   gint x3, y3, r3, g3, b3; /* Third vertex */
1097   gint t;
1098   guchar *buf, *p;
1099   gint xl, xr, rl, rr, gl, gr, bl, br; /* Scanline data */
1100   gint xx, yy;
1101   GdkBitmap *mask;
1102   GdkGC *gc;
1103   GdkColor color;
1104   GdkPoint points[3];
1105   gdouble r, g, b;
1106
1107   priv = hsv->priv;
1108
1109   /* Compute triangle's vertices */
1110
1111   compute_triangle (hsv, &hx, &hy, &sx, &sy, &vx, &vy);
1112
1113   x1 = hx;
1114   y1 = hy;
1115   get_color (priv->h, 1.0, 1.0, &r1, &g1, &b1);
1116
1117   x2 = sx;
1118   y2 = sy;
1119   get_color (priv->h, 1.0, 0.0, &r2, &g2, &b2);
1120
1121   x3 = vx;
1122   y3 = vy;
1123   get_color (priv->h, 0.0, 1.0, &r3, &g3, &b3);
1124
1125   if (y2 > y3)
1126     {
1127       SWAP (x2, x3, t);
1128       SWAP (y2, y3, t);
1129       SWAP (r2, r3, t);
1130       SWAP (g2, g3, t);
1131       SWAP (b2, b3, t);
1132     }
1133
1134   if (y1 > y3)
1135     {
1136       SWAP (x1, x3, t);
1137       SWAP (y1, y3, t);
1138       SWAP (r1, r3, t);
1139       SWAP (g1, g3, t);
1140       SWAP (b1, b3, t);
1141     }
1142
1143   if (y1 > y2)
1144     {
1145       SWAP (x1, x2, t);
1146       SWAP (y1, y2, t);
1147       SWAP (r1, r2, t);
1148       SWAP (g1, g2, t);
1149       SWAP (b1, b2, t);
1150     }
1151
1152   /* Shade the triangle */
1153
1154   buf = g_new (guchar, width * height * 3);
1155
1156   for (yy = 0; yy < height; yy++)
1157     {
1158       p = buf + yy * width * 3;
1159
1160       if (yy + y < y1 || yy + y > y3)
1161         for (xx = 0; xx < width; xx++)
1162           {
1163             *p++ = 0;
1164             *p++ = 0;
1165             *p++ = 0;
1166           }
1167       else {
1168         if (yy + y < y2)
1169           {
1170             xl = LERP (x1, x2, y1, y2, yy + y);
1171
1172             rl = LERP (r1, r2, y1, y2, yy + y);
1173             gl = LERP (g1, g2, y1, y2, yy + y);
1174             bl = LERP (b1, b2, y1, y2, yy + y);
1175           }
1176         else
1177           {
1178             xl = LERP (x2, x3, y2, y3, yy + y);
1179
1180             rl = LERP (r2, r3, y2, y3, yy + y);
1181             gl = LERP (g2, g3, y2, y3, yy + y);
1182             bl = LERP (b2, b3, y2, y3, yy + y);
1183           }
1184
1185         xr = LERP (x1, x3, y1, y3, yy + y);
1186
1187         rr = LERP (r1, r3, y1, y3, yy + y);
1188         gr = LERP (g1, g3, y1, y3, yy + y);
1189         br = LERP (b1, b3, y1, y3, yy + y);
1190
1191         if (xl > xr)
1192           {
1193             SWAP (xl, xr, t);
1194             SWAP (rl, rr, t);
1195             SWAP (gl, gr, t);
1196             SWAP (bl, br, t);
1197           }
1198
1199         for (xx = 0; xx < width; xx++)
1200           {
1201             if (xx + x < xl || xx + x > xr)
1202               {
1203                 *p++ = 0;
1204                 *p++ = 0;
1205                 *p++ = 0;
1206               }
1207             else
1208               {
1209                 *p++ = LERP (rl, rr, xl, xr, xx + x);
1210                 *p++ = LERP (gl, gr, xl, xr, xx + x);
1211                 *p++ = LERP (bl, br, xl, xr, xx + x);
1212               }
1213           }
1214       }
1215     }
1216
1217   /* Create clipping mask */
1218
1219   mask = gdk_pixmap_new (NULL, width, height, 1);
1220   gc = gdk_gc_new (mask);
1221
1222   color.pixel = 0;
1223   gdk_gc_set_foreground (gc, &color);
1224   gdk_draw_rectangle (mask, gc, TRUE,
1225                       0, 0, width, height);
1226
1227   color.pixel = 1;
1228   gdk_gc_set_foreground (gc, &color);
1229
1230   points[0].x = x1 - x;
1231   points[0].y = y1 - y;
1232   points[1].x = x2 - x;
1233   points[1].y = y2 - y;
1234   points[2].x = x3 - x;
1235   points[2].y = y3 - y;
1236   gdk_draw_polygon (mask, gc, TRUE, points, 3);
1237
1238   gdk_gc_unref (gc);
1239
1240   gdk_gc_set_clip_mask (priv->gc, mask);
1241   gdk_gc_set_clip_origin (priv->gc, 0, 0);
1242
1243   /* Draw triangle */
1244
1245   gdk_draw_rgb_image_dithalign (drawable, priv->gc, 0, 0, width, height,
1246                                 GDK_RGB_DITHER_MAX,
1247                                 buf,
1248                                 width * 3,
1249                                 x, y);
1250
1251   gdk_gc_set_clip_mask (priv->gc, NULL);
1252   gdk_bitmap_unref (mask);
1253
1254   g_free (buf);
1255
1256   /* Draw triangle focus outline */
1257
1258   if (GTK_WIDGET_HAS_FOCUS (hsv) &&
1259       !priv->focus_on_ring)
1260     {
1261       gdk_rgb_gc_set_foreground (priv->gc, 0x000000);
1262
1263       gdk_draw_polygon (drawable, priv->gc, FALSE, points, 3);
1264     }
1265
1266   /* Draw value marker */
1267
1268   xx = floor (sx + (vx - sx) * priv->v + (hx - vx) * priv->s * priv->v + 0.5);
1269   yy = floor (sy + (vy - sy) * priv->v + (hy - vy) * priv->s * priv->v + 0.5);
1270
1271   r = priv->h;
1272   g = priv->s;
1273   b = priv->v;
1274   hsv_to_rgb (&r, &g, &b);
1275
1276   if (INTENSITY (r, g, b) > 0.5)
1277     gdk_rgb_gc_set_foreground (priv->gc, 0x000000);
1278   else
1279     gdk_rgb_gc_set_foreground (priv->gc, 0xffffff);
1280
1281 #define OUTER_RADIUS 4
1282 #define INNER_RADIUS 3
1283
1284   gdk_draw_arc (drawable, priv->gc, FALSE,
1285                 xx - OUTER_RADIUS, yy - OUTER_RADIUS,
1286                 OUTER_RADIUS * 2, OUTER_RADIUS * 2,
1287                 0, 360 * 64);
1288   gdk_draw_arc (drawable, priv->gc, FALSE,
1289                 xx - INNER_RADIUS, yy - INNER_RADIUS,
1290                 INNER_RADIUS * 2, INNER_RADIUS * 2,
1291                 0, 360 * 64);
1292 }
1293
1294 /* Paints the contents of the HSV color selector */
1295 static void
1296 paint (GtkHSV      *hsv,
1297        GdkDrawable *drawable,
1298        gint         x,
1299        gint         y,
1300        gint         width,
1301        gint         height)
1302 {
1303   paint_ring (hsv, drawable, x, y, width, height);
1304   paint_triangle (hsv, drawable, x, y, width, height);
1305 }
1306
1307 /* Expose_event handler for the HSV color selector */
1308 static gint
1309 gtk_hsv_expose (GtkWidget      *widget,
1310                 GdkEventExpose *event)
1311 {
1312   GtkHSV *hsv;
1313   HSVPrivate *priv;
1314   GdkRectangle rect, dest;
1315   GdkPixmap *pixmap;
1316
1317   hsv = GTK_HSV (widget);
1318   priv = hsv->priv;
1319
1320   if (!(GTK_WIDGET_DRAWABLE (widget) && event->window == widget->window))
1321     return FALSE;
1322
1323   rect.x = widget->allocation.x;
1324   rect.y = widget->allocation.y;
1325   rect.width = widget->allocation.width;
1326   rect.height = widget->allocation.height;
1327
1328   if (!gdk_rectangle_intersect (&event->area, &rect, &dest))
1329     return FALSE;
1330
1331   pixmap = gdk_pixmap_new (widget->window, dest.width, dest.height,
1332                            gtk_widget_get_visual (widget)->depth);
1333
1334   rect = dest;
1335   rect.x = 0;
1336   rect.y = 0;
1337
1338   gdk_draw_rectangle (pixmap,
1339                       widget->style->bg_gc[GTK_WIDGET_STATE (widget)],
1340                       TRUE,
1341                       0, 0, dest.width, dest.height);
1342   paint (hsv, pixmap,
1343          dest.x - widget->allocation.x, dest.y - widget->allocation.y,
1344          dest.width, dest.height);
1345
1346   gdk_draw_pixmap (widget->window,
1347                    priv->gc,
1348                    pixmap,
1349                    0, 0,
1350                    dest.x,
1351                    dest.y,
1352                    event->area.width, event->area.height);
1353
1354   gdk_pixmap_unref (pixmap);
1355
1356   return FALSE;
1357 }
1358
1359 static gboolean
1360 gtk_hsv_focus (GtkContainer    *container,
1361                GtkDirectionType dir)
1362 {
1363   GtkHSV *hsv;
1364   HSVPrivate *priv;
1365
1366   hsv = GTK_HSV (container);
1367   priv = hsv->priv;
1368
1369   if (!GTK_WIDGET_DRAWABLE (container) ||
1370       !GTK_WIDGET_IS_SENSITIVE (container))
1371     return FALSE;
1372
1373   if (!GTK_WIDGET_HAS_FOCUS (hsv))
1374     {
1375       if (dir == GTK_DIR_TAB_BACKWARD)
1376         priv->focus_on_ring = FALSE;
1377       else
1378         priv->focus_on_ring = TRUE;
1379
1380       gtk_widget_grab_focus (GTK_WIDGET (hsv));
1381       return TRUE;
1382     }
1383
1384   switch (dir)
1385     {
1386     case GTK_DIR_UP:
1387       if (priv->focus_on_ring)
1388         return FALSE;
1389       else
1390         priv->focus_on_ring = TRUE;
1391       break;
1392
1393     case GTK_DIR_DOWN:
1394       if (priv->focus_on_ring)
1395         priv->focus_on_ring = FALSE;
1396       else
1397         return FALSE;
1398       break;
1399
1400     case GTK_DIR_LEFT:
1401     case GTK_DIR_TAB_BACKWARD:
1402       if (priv->focus_on_ring)
1403         return FALSE;
1404       else
1405         priv->focus_on_ring = TRUE;
1406       break;
1407
1408     case GTK_DIR_RIGHT:
1409     case GTK_DIR_TAB_FORWARD:
1410       if (priv->focus_on_ring)
1411         priv->focus_on_ring = FALSE;
1412       else
1413         return FALSE;
1414       break;
1415     }
1416
1417   gtk_widget_queue_draw (GTK_WIDGET (hsv));
1418
1419   return TRUE;
1420 }
1421
1422 /**
1423  * gtk_hsv_new:
1424  * @void:
1425  *
1426  * Creates a new HSV color selector.
1427  *
1428  * Return value: A newly-created HSV color selector.
1429  **/
1430 GtkWidget*
1431 gtk_hsv_new (void)
1432 {
1433   return GTK_WIDGET (gtk_type_new (GTK_TYPE_HSV));
1434 }
1435
1436 /**
1437  * gtk_hsv_set_color:
1438  * @hsv: An HSV color selector.
1439  * @h: Hue.
1440  * @s: Saturation.
1441  * @v: Value.
1442  *
1443  * Sets the current color in an HSV color selector.  Color component values must
1444  * be in the [0.0, 1.0] range.
1445  **/
1446 void
1447 gtk_hsv_set_color (GtkHSV *hsv,
1448                    gdouble h,
1449                    gdouble s,
1450                    gdouble v)
1451 {
1452   HSVPrivate *priv;
1453
1454   g_return_if_fail (hsv != NULL);
1455   g_return_if_fail (GTK_IS_HSV (hsv));
1456   g_return_if_fail (h >= 0.0 && h <= 1.0);
1457   g_return_if_fail (s >= 0.0 && s <= 1.0);
1458   g_return_if_fail (v >= 0.0 && v <= 1.0);
1459
1460   priv = hsv->priv;
1461
1462   priv->h = h;
1463   priv->s = s;
1464   priv->v = v;
1465
1466   gtk_signal_emit (GTK_OBJECT (hsv), hsv_signals[CHANGED]);
1467
1468   gtk_widget_queue_draw (GTK_WIDGET (hsv));
1469 }
1470
1471 /**
1472  * gtk_hsv_get_color:
1473  * @hsv: An HSV color selector.
1474  * @h: Return value for the hue.
1475  * @s: Return value for the saturation.
1476  * @v: Return value for the value.
1477  *
1478  * Queries the current color in an HSV color selector.  Returned values will be
1479  * in the [0.0, 1.0] range.
1480  **/
1481 void
1482 gtk_hsv_get_color (GtkHSV *hsv, double *h, double *s, double *v)
1483 {
1484   HSVPrivate *priv;
1485
1486   g_return_if_fail (hsv != NULL);
1487   g_return_if_fail (GTK_IS_HSV (hsv));
1488
1489   priv = hsv->priv;
1490
1491   if (h)
1492     *h = priv->h;
1493
1494   if (s)
1495     *s = priv->s;
1496
1497   if (v)
1498     *v = priv->v;
1499 }
1500
1501 /**
1502  * gtk_hsv_set_metrics:
1503  * @hsv: An HSV color selector.
1504  * @size: Diameter for the hue ring.
1505  * @ring_width: Width of the hue ring.
1506  *
1507  * Sets the size and ring width of an HSV color selector.
1508  **/
1509 void
1510 gtk_hsv_set_metrics (GtkHSV *hsv,
1511                      gint    size,
1512                      gint    ring_width)
1513 {
1514   HSVPrivate *priv;
1515   int same_size;
1516
1517   g_return_if_fail (hsv != NULL);
1518   g_return_if_fail (GTK_IS_HSV (hsv));
1519   g_return_if_fail (size > 0);
1520   g_return_if_fail (ring_width > 0);
1521   g_return_if_fail (2 * ring_width + 1 <= size);
1522
1523   priv = hsv->priv;
1524
1525   same_size = (priv->size == size);
1526
1527   priv->size = size;
1528   priv->ring_width = ring_width;
1529
1530   if (same_size)
1531     gtk_widget_queue_draw (GTK_WIDGET (hsv));
1532   else
1533     gtk_widget_queue_resize (GTK_WIDGET (hsv));
1534 }
1535
1536 /**
1537  * gtk_hsv_get_metrics:
1538  * @hsv: An HSV color selector.
1539  * @size: Return value for the diameter of the hue ring.
1540  * @ring_width: Return value for the width of the hue ring.
1541  *
1542  * Queries the size and ring width of an HSV color selector.
1543  **/
1544 void
1545 gtk_hsv_get_metrics (GtkHSV *hsv,
1546                      gint   *size,
1547                      gint   *ring_width)
1548 {
1549   HSVPrivate *priv;
1550
1551   g_return_if_fail (hsv != NULL);
1552   g_return_if_fail (GTK_IS_HSV (hsv));
1553
1554   priv = hsv->priv;
1555
1556   if (size)
1557     *size = priv->size;
1558
1559   if (ring_width)
1560     *ring_width = priv->ring_width;
1561 }
1562
1563 /**
1564  * gtk_hsv_is_adjusting:
1565  * @hsv:
1566  *
1567  * An HSV color selector can be said to be adjusting if multiple rapid changes
1568  * are being made to its value, for example, when the user is adjusting the
1569  * value with the mouse.  This function queries whether the HSV color selector
1570  * is being adjusted or not.
1571  *
1572  * Return value: TRUE if clients can ignore changes to the color value, since
1573  * they may be transitory, or FALSE if they should consider the color value
1574  * status to be final.
1575  **/
1576 gboolean
1577 gtk_hsv_is_adjusting (GtkHSV *hsv)
1578 {
1579   HSVPrivate *priv;
1580
1581   g_return_val_if_fail (hsv != NULL, FALSE);
1582   g_return_val_if_fail (GTK_IS_HSV (hsv), FALSE);
1583
1584   priv = hsv->priv;
1585
1586   return priv->mode != DRAG_NONE;
1587 }
1588
1589 /**
1590  * gtk_hsv_to_rgb:
1591  * @h: Hue.
1592  * @s: Saturation.
1593  * @v: Value.
1594  * @r: Return value for the red component.
1595  * @g: Return value for the green component.
1596  * @b: Return value for the blue component.
1597  *
1598  * Converts a color from HSV space to RGB.  Input values must be in the
1599  * [0.0, 1.0] range; output values will be in the same range.
1600  **/
1601 void
1602 gtk_hsv_to_rgb (gdouble  h,
1603                 gdouble  s,
1604                 gdouble  v,
1605                 gdouble *r,
1606                 gdouble *g,
1607                 gdouble *b)
1608 {
1609   g_return_if_fail (h >= 0.0 && h <= 1.0);
1610   g_return_if_fail (s >= 0.0 && s <= 1.0);
1611   g_return_if_fail (v >= 0.0 && v <= 1.0);
1612
1613   hsv_to_rgb (&h, &s, &v);
1614
1615   if (r)
1616     *r = h;
1617
1618   if (g)
1619     *g = s;
1620
1621   if (b)
1622     *b = v;
1623 }
1624
1625 /**
1626  * gtk_hsv_to_rgb:
1627  * @r: Red.
1628  * @g: Green.
1629  * @b: Blue.
1630  * @h: Return value for the hue component.
1631  * @s: Return value for the saturation component.
1632  * @v: Return value for the value component.
1633  *
1634  * Converts a color from RGB space to HSV.  Input values must be in the
1635  * [0.0, 1.0] range; output values will be in the same range.
1636  **/
1637 void
1638 gtk_rgb_to_hsv (gdouble  r,
1639                 gdouble  g,
1640                 gdouble  b,
1641                 gdouble *h,
1642                 gdouble *s,
1643                 gdouble *v)
1644 {
1645   g_return_if_fail (r >= 0.0 && r <= 1.0);
1646   g_return_if_fail (g >= 0.0 && g <= 1.0);
1647   g_return_if_fail (b >= 0.0 && b <= 1.0);
1648
1649   rgb_to_hsv (&r, &g, &b);
1650
1651   if (h)
1652     *h = r;
1653
1654   if (s)
1655     *s = g;
1656
1657   if (v)
1658     *v = b;
1659 }
1660
1661 static void
1662 gtk_hsv_move (GtkHSV          *hsv,
1663               GtkDirectionType dir)
1664 {
1665   HSVPrivate *priv;
1666   gdouble hue, sat, val;
1667   gint hx, hy, sx, sy, vx, vy; /* HSV vertices */
1668   gint x, y; /* position in triangle */
1669
1670   priv = hsv->priv;
1671
1672   hue = priv->h;
1673   sat = priv->s;
1674   val = priv->v;
1675
1676   compute_triangle (hsv, &hx, &hy, &sx, &sy, &vx, &vy);
1677
1678   x = floor (sx + (vx - sx) * priv->v + (hx - vx) * priv->s * priv->v + 0.5);
1679   y = floor (sy + (vy - sy) * priv->v + (hy - vy) * priv->s * priv->v + 0.5);
1680
1681 #define HUE_DELTA 0.002
1682   switch (dir)
1683     {
1684     case GTK_DIR_UP:
1685       if (priv->focus_on_ring)
1686         hue += HUE_DELTA;
1687       else
1688         {
1689           y -= 1;
1690           compute_sv (hsv, x, y, &sat, &val);
1691         }
1692       break;
1693
1694     case GTK_DIR_DOWN:
1695       if (priv->focus_on_ring)
1696         hue -= HUE_DELTA;
1697       else
1698         {
1699           y += 1;
1700           compute_sv (hsv, x, y, &sat, &val);
1701         }
1702       break;
1703
1704     case GTK_DIR_LEFT:
1705       if (priv->focus_on_ring)
1706         hue += HUE_DELTA;
1707       else
1708         {
1709           x -= 1;
1710           compute_sv (hsv, x, y, &sat, &val);
1711         }
1712       break;
1713
1714     case GTK_DIR_RIGHT:
1715       if (priv->focus_on_ring)
1716         hue -= HUE_DELTA
1717           ;
1718       else
1719         {
1720           x += 1;
1721           compute_sv (hsv, x, y, &sat, &val);
1722         }
1723       break;
1724
1725     default:
1726       /* we don't care about the tab directions */
1727       break;
1728     }
1729
1730   /* Wrap */
1731   if (hue < 0.0)
1732     hue = 1.0;
1733   else if (hue > 1.0)
1734     hue = 0.0;
1735
1736   gtk_hsv_set_color (hsv, hue, sat, val);
1737 }
1738