1 /* GTK - The GIMP Toolkit
3 * Copyright (C) 2012 Red Hat, Inc.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 * Boston, MA 02111-1307, USA.
23 #include "gtkcolorchooserprivate.h"
24 #include "gtkcolorchooserwidget.h"
25 #include "gtkcoloreditor.h"
26 #include "gtkcolorswatch.h"
30 #include "gtkorientable.h"
31 #include "gtkprivate.h"
33 #include "gtksizegroup.h"
34 #include "gtkalignment.h"
37 * SECTION:gtkcolorchooserwidget
38 * @Short_description: A widget for choosing colors
39 * @Title: GtkColorChooserWidget
40 * @See_also: #GtkColorChooserDialog
42 * The #GtkColorChooserWidget widget lets the user select a
43 * color. By default, the chooser presents a prefined palette
44 * of colors, plus a small number of settable custom colors.
45 * It is also possible to select a different color with the
46 * single-color editor. To enter the single-color editing mode,
47 * use the context menu of any color of the palette, or use the
48 * '+' button to add a new custom color.
50 * The chooser automatically remembers the last selection, as well
53 * To change the initially selected color, use gtk_color_chooser_set_rgba().
54 * To get the selected font use gtk_color_chooser_get_rgba().
56 * The #GtkColorChooserWidget is used in the #GtkColorChooserDialog
57 * to provide a dialog for selecting colors.
62 struct _GtkColorChooserWidgetPrivate
66 GtkSizeGroup *size_group;
68 GtkWidget *custom_label;
72 GtkColorSwatch *current;
75 gboolean has_default_palette;
88 static void gtk_color_chooser_widget_iface_init (GtkColorChooserInterface *iface);
90 G_DEFINE_TYPE_WITH_CODE (GtkColorChooserWidget, gtk_color_chooser_widget, GTK_TYPE_BOX,
91 G_IMPLEMENT_INTERFACE (GTK_TYPE_COLOR_CHOOSER,
92 gtk_color_chooser_widget_iface_init))
95 select_swatch (GtkColorChooserWidget *cc,
96 GtkColorSwatch *swatch)
100 if (cc->priv->current == swatch)
103 if (cc->priv->current != NULL)
104 gtk_color_swatch_set_selected (cc->priv->current, FALSE);
105 gtk_color_swatch_set_selected (swatch, TRUE);
106 cc->priv->current = swatch;
108 gtk_color_swatch_get_rgba (swatch, &color);
109 g_settings_set (cc->priv->settings, "selected-color", "(bdddd)",
110 TRUE, color.red, color.green, color.blue, color.alpha);
112 g_object_notify (G_OBJECT (cc), "rgba");
116 swatch_activate (GtkColorSwatch *swatch,
117 GtkColorChooserWidget *cc)
121 gtk_color_swatch_get_rgba (swatch, &color);
122 _gtk_color_chooser_color_activated (GTK_COLOR_CHOOSER (cc), &color);
126 swatch_customize (GtkColorSwatch *swatch,
127 GtkColorChooserWidget *cc)
131 gtk_color_swatch_get_rgba (swatch, &color);
132 gtk_color_chooser_set_rgba (GTK_COLOR_CHOOSER (cc->priv->editor), &color);
134 gtk_widget_hide (cc->priv->palette);
135 gtk_widget_show (cc->priv->editor);
139 swatch_selected (GtkColorSwatch *swatch,
141 GtkColorChooserWidget *cc)
143 select_swatch (cc, swatch);
147 connect_swatch_signals (GtkWidget *p,
150 g_signal_connect (p, "activate", G_CALLBACK (swatch_activate), data);
151 g_signal_connect (p, "customize", G_CALLBACK (swatch_customize), data);
152 g_signal_connect (p, "notify::selected", G_CALLBACK (swatch_selected), data);
156 button_activate (GtkColorSwatch *swatch,
157 GtkColorChooserWidget *cc)
159 /* somewhat random, makes the hairline nicely visible */
160 GdkRGBA color = { 0.75, 0.25, 0.25, 1.0 };
162 gtk_color_chooser_set_rgba (GTK_COLOR_CHOOSER (cc->priv->editor), &color);
164 gtk_widget_hide (cc->priv->palette);
165 gtk_widget_show (cc->priv->editor);
169 connect_button_signals (GtkWidget *p,
172 g_signal_connect (p, "activate", G_CALLBACK (button_activate), data);
176 save_custom_colors (GtkColorChooserWidget *cc)
178 GVariantBuilder builder;
184 g_variant_builder_init (&builder, G_VARIANT_TYPE ("a(dddd)"));
187 while ((child = gtk_grid_get_child_at (GTK_GRID (cc->priv->custom), i, 0)) != NULL)
190 if (gtk_color_swatch_get_rgba (GTK_COLOR_SWATCH (child), &color))
191 g_variant_builder_add (&builder, "(dddd)",
192 color.red, color.green, color.blue, color.alpha);
195 variant = g_variant_builder_end (&builder);
196 g_settings_set_value (cc->priv->settings, "custom-colors", variant);
200 connect_custom_signals (GtkWidget *p,
203 connect_swatch_signals (p, data);
204 g_signal_connect_swapped (p, "notify::rgba",
205 G_CALLBACK (save_custom_colors), data);
209 gtk_color_chooser_widget_set_use_alpha (GtkColorChooserWidget *cc,
217 cc->priv->use_alpha = use_alpha;
218 gtk_color_chooser_set_use_alpha (GTK_COLOR_CHOOSER (cc->priv->editor), use_alpha);
220 palettes = gtk_container_get_children (GTK_CONTAINER (cc->priv->palette));
221 for (p = palettes; p; p = p->next)
225 if (!GTK_IS_GRID (grid))
228 children = gtk_container_get_children (GTK_CONTAINER (grid));
229 for (l = children; l; l = l->next)
232 gtk_color_swatch_set_use_alpha (GTK_COLOR_SWATCH (swatch), use_alpha);
234 g_list_free (children);
236 g_list_free (palettes);
238 gtk_widget_queue_draw (GTK_WIDGET (cc));
242 gtk_color_chooser_widget_set_show_editor (GtkColorChooserWidget *cc,
243 gboolean show_editor)
247 GdkRGBA color = { 0.75, 0.25, 0.25, 1.0 };
249 if (cc->priv->current)
250 gtk_color_swatch_get_rgba (cc->priv->current, &color);
251 gtk_color_chooser_set_rgba (GTK_COLOR_CHOOSER (cc->priv->editor), &color);
254 gtk_widget_set_visible (cc->priv->editor, show_editor);
255 gtk_widget_set_visible (cc->priv->palette, !show_editor);
258 /* UI construction {{{1 */
261 add_palette (GtkColorChooserWidget *cc,
263 gint colors_per_line,
273 grid = gtk_grid_new ();
274 gtk_widget_set_margin_bottom (grid, 12);
275 gtk_grid_set_row_spacing (GTK_GRID (grid), 2);
276 gtk_grid_set_column_spacing (GTK_GRID (grid), 4);
277 gtk_container_add (GTK_CONTAINER (cc->priv->palette), grid);
280 right = colors_per_line - 1;
281 if (gtk_widget_get_direction (GTK_WIDGET (cc)) == GTK_TEXT_DIR_RTL)
288 for (i = 0; i < n_colors; i++)
290 p = gtk_color_swatch_new ();
291 gtk_color_swatch_set_rgba (GTK_COLOR_SWATCH (p), &colors[i]);
292 connect_swatch_signals (p, cc);
294 line = i / colors_per_line;
295 pos = i % colors_per_line;
300 gtk_style_context_add_class (gtk_widget_get_style_context (p), GTK_STYLE_CLASS_LEFT);
301 else if (pos == right)
302 gtk_style_context_add_class (gtk_widget_get_style_context (p), GTK_STYLE_CLASS_RIGHT);
304 gtk_grid_attach (GTK_GRID (grid), p, pos, line, 1, 1);
309 gtk_style_context_add_class (gtk_widget_get_style_context (p), GTK_STYLE_CLASS_TOP);
310 else if (pos == colors_per_line - 1)
311 gtk_style_context_add_class (gtk_widget_get_style_context (p), GTK_STYLE_CLASS_BOTTOM);
313 gtk_grid_attach (GTK_GRID (grid), p, line, pos, 1, 1);
317 gtk_widget_show_all (grid);
321 remove_default_palette (GtkColorChooserWidget *cc)
326 if (!cc->priv->has_default_palette)
329 children = gtk_container_get_children (GTK_CONTAINER (cc->priv->palette));
330 for (l = children; l; l = l->next)
333 if (widget == cc->priv->custom_label || widget == cc->priv->custom)
335 gtk_container_remove (GTK_CONTAINER (cc->priv->palette), widget);
337 g_list_free (children);
339 cc->priv->has_default_palette = FALSE;
343 add_default_palette (GtkColorChooserWidget *cc)
345 const gchar *default_colors[9][3] = {
346 { "#ef2929", "#cc0000", "#a40000" }, /* Scarlet Red */
347 { "#fcaf3e", "#f57900", "#ce5c00" }, /* Orange */
348 { "#fce94f", "#edd400", "#c4a000" }, /* Butter */
349 { "#8ae234", "#73d216", "#4e9a06" }, /* Chameleon */
350 { "#729fcf", "#3465a4", "#204a87" }, /* Sky Blue */
351 { "#ad7fa8", "#75507b", "#5c3566" }, /* Plum */
352 { "#e9b96e", "#c17d11", "#8f5902" }, /* Chocolate */
353 { "#888a85", "#555753", "#2e3436" }, /* Aluminum 1 */
354 { "#eeeeec", "#d3d7cf", "#babdb6" } /* Aluminum 2 */
356 const gchar *default_grays[9] = {
370 for (i = 0; i < 9; i++)
371 for (j = 0; j < 3; j++)
372 gdk_rgba_parse (&colors[i*3 + j], default_colors[i][j]);
374 add_palette (cc, FALSE, 3, 9*3, colors);
376 for (i = 0; i < 9; i++)
377 gdk_rgba_parse (&colors[i], default_grays[i]);
379 add_palette (cc, TRUE, 9, 9, colors);
381 cc->priv->has_default_palette = TRUE;
385 gtk_color_chooser_widget_init (GtkColorChooserWidget *cc)
389 GtkWidget *alignment;
398 cc->priv = G_TYPE_INSTANCE_GET_PRIVATE (cc, GTK_TYPE_COLOR_CHOOSER_WIDGET, GtkColorChooserWidgetPrivate);
400 gtk_orientable_set_orientation (GTK_ORIENTABLE (cc), GTK_ORIENTATION_VERTICAL);
401 cc->priv->palette = gtk_box_new (GTK_ORIENTATION_VERTICAL, 0);
402 gtk_container_add (GTK_CONTAINER (cc), cc->priv->palette);
404 add_default_palette (cc);
406 cc->priv->custom = grid = gtk_grid_new ();
407 g_object_set (grid, "margin-top", 12, NULL);
408 gtk_grid_set_column_spacing (GTK_GRID (grid), 4);
409 gtk_box_pack_end (GTK_BOX (cc->priv->palette), grid, FALSE, TRUE, 0);
411 /* translators: label for the custom section in the color chooser */
412 cc->priv->custom_label = label = gtk_label_new (_("Custom"));
413 gtk_widget_set_halign (label, GTK_ALIGN_START);
414 gtk_box_pack_end (GTK_BOX (cc->priv->palette), label, FALSE, TRUE, 0);
416 cc->priv->button = button = gtk_color_swatch_new ();
417 gtk_color_swatch_set_corner_radii (GTK_COLOR_SWATCH (button), 10, 10, 10, 10);
418 connect_button_signals (button, cc);
419 gtk_color_swatch_set_icon (GTK_COLOR_SWATCH (button), "list-add-symbolic");
420 gtk_grid_attach (GTK_GRID (grid), button, 0, 0, 1, 1);
422 cc->priv->settings = g_settings_new_with_path ("org.gtk.Settings.ColorChooser",
423 "/org/gtk/settings/color-chooser/");
424 variant = g_settings_get_value (cc->priv->settings, "custom-colors");
425 g_variant_iter_init (&iter, variant);
428 while (g_variant_iter_loop (&iter, "(dddd)", &color.red, &color.green, &color.blue, &color.alpha))
431 p = gtk_color_swatch_new ();
432 gtk_color_swatch_set_corner_radii (GTK_COLOR_SWATCH (p), 1, 1, 1, 1);
433 gtk_color_swatch_set_rgba (GTK_COLOR_SWATCH (p), &color);
434 gtk_color_swatch_set_can_drop (GTK_COLOR_SWATCH (p), TRUE);
435 connect_custom_signals (p, cc);
436 gtk_grid_attach (GTK_GRID (grid), p, i, 0, 1, 1);
441 g_variant_unref (variant);
445 if (gtk_widget_get_direction (GTK_WIDGET (cc)) == GTK_TEXT_DIR_LTR)
447 gtk_color_swatch_set_corner_radii (GTK_COLOR_SWATCH (p), 1, 10, 10, 1);
448 gtk_color_swatch_set_corner_radii (GTK_COLOR_SWATCH (button), 10, 1, 1, 10);
452 gtk_color_swatch_set_corner_radii (GTK_COLOR_SWATCH (button), 1, 10, 10, 1);
453 gtk_color_swatch_set_corner_radii (GTK_COLOR_SWATCH (p), 10, 1, 1, 10);
457 cc->priv->editor = gtk_color_editor_new ();
458 alignment = gtk_alignment_new (0.5, 0.5, 0, 0);
459 gtk_container_add (GTK_CONTAINER (cc), alignment);
460 gtk_container_add (GTK_CONTAINER (alignment), cc->priv->editor);
462 g_settings_get (cc->priv->settings, "selected-color", "(bdddd)",
464 &color.red, &color.green, &color.blue, &color.alpha);
466 gtk_color_chooser_set_rgba (GTK_COLOR_CHOOSER (cc), &color);
468 gtk_widget_show_all (GTK_WIDGET (cc));
469 gtk_widget_hide (GTK_WIDGET (cc->priv->editor));
470 gtk_widget_hide (GTK_WIDGET (cc));
472 gtk_widget_set_no_show_all (cc->priv->palette, TRUE);
473 gtk_widget_set_no_show_all (cc->priv->editor, TRUE);
475 cc->priv->size_group = gtk_size_group_new (GTK_SIZE_GROUP_HORIZONTAL);
476 gtk_size_group_add_widget (cc->priv->size_group, cc->priv->palette);
477 gtk_size_group_add_widget (cc->priv->size_group, alignment);
480 /* GObject implementation {{{1 */
483 gtk_color_chooser_widget_get_property (GObject *object,
488 GtkColorChooserWidget *cw = GTK_COLOR_CHOOSER_WIDGET (object);
489 GtkColorChooser *cc = GTK_COLOR_CHOOSER (object);
497 gtk_color_chooser_get_rgba (cc, &color);
498 g_value_set_boxed (value, &color);
502 g_value_set_boolean (value, cw->priv->use_alpha);
504 case PROP_SHOW_EDITOR:
505 g_value_set_boolean (value, gtk_widget_get_visible (cw->priv->editor));
508 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
514 gtk_color_chooser_widget_set_property (GObject *object,
519 GtkColorChooserWidget *cc = GTK_COLOR_CHOOSER_WIDGET (object);
524 gtk_color_chooser_set_rgba (GTK_COLOR_CHOOSER (cc),
525 g_value_get_boxed (value));
528 gtk_color_chooser_widget_set_use_alpha (cc,
529 g_value_get_boolean (value));
531 case PROP_SHOW_EDITOR:
532 gtk_color_chooser_widget_set_show_editor (cc,
533 g_value_get_boolean (value));
536 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
542 gtk_color_chooser_widget_finalize (GObject *object)
544 GtkColorChooserWidget *cc = GTK_COLOR_CHOOSER_WIDGET (object);
546 g_object_unref (cc->priv->size_group);
547 g_object_unref (cc->priv->settings);
549 G_OBJECT_CLASS (gtk_color_chooser_widget_parent_class)->finalize (object);
553 gtk_color_chooser_widget_class_init (GtkColorChooserWidgetClass *class)
555 GObjectClass *object_class = G_OBJECT_CLASS (class);
557 object_class->get_property = gtk_color_chooser_widget_get_property;
558 object_class->set_property = gtk_color_chooser_widget_set_property;
559 object_class->finalize = gtk_color_chooser_widget_finalize;
561 g_object_class_override_property (object_class, PROP_RGBA, "rgba");
562 g_object_class_override_property (object_class, PROP_USE_ALPHA, "use-alpha");
565 * GtkColorChooserWidget:show-editor:
567 * The ::show-editor property is %TRUE when the color chooser
568 * is showing the single-color editor. It can be set to switch
569 * the color chooser into single-color editing mode.
573 g_object_class_install_property (object_class, PROP_SHOW_EDITOR,
574 g_param_spec_boolean ("show-editor", P_("Show editor"), P_("Show editor"),
575 FALSE, GTK_PARAM_READWRITE));
577 g_type_class_add_private (object_class, sizeof (GtkColorChooserWidgetPrivate));
580 /* GtkColorChooser implementation {{{1 */
583 gtk_color_chooser_widget_get_rgba (GtkColorChooser *chooser,
586 GtkColorChooserWidget *cc = GTK_COLOR_CHOOSER_WIDGET (chooser);
588 if (gtk_widget_get_visible (cc->priv->editor))
589 gtk_color_chooser_get_rgba (GTK_COLOR_CHOOSER (cc->priv->editor), color);
590 else if (cc->priv->current)
591 gtk_color_swatch_get_rgba (cc->priv->current, color);
600 if (!cc->priv->use_alpha)
605 add_custom_color (GtkColorChooserWidget *cc,
606 const GdkRGBA *color)
611 last = gtk_grid_get_child_at (GTK_GRID (cc->priv->custom), 8, 0);
614 gtk_container_remove (GTK_CONTAINER (cc->priv->custom), last);
615 last = gtk_grid_get_child_at (GTK_GRID (cc->priv->custom), 7, 0);
616 gtk_color_swatch_set_corner_radii (GTK_COLOR_SWATCH (last), 1, 10, 10, 1);
619 gtk_color_swatch_set_corner_radii (GTK_COLOR_SWATCH (cc->priv->button), 10, 1, 1, 10);
621 p = gtk_color_swatch_new ();
622 gtk_color_swatch_set_rgba (GTK_COLOR_SWATCH (p), color);
623 gtk_color_swatch_set_can_drop (GTK_COLOR_SWATCH (p), TRUE);
624 connect_custom_signals (p, cc);
626 if (gtk_grid_get_child_at (GTK_GRID (cc->priv->custom), 1, 0) != NULL)
627 gtk_color_swatch_set_corner_radii (GTK_COLOR_SWATCH (p), 1, 1, 1, 1);
629 gtk_color_swatch_set_corner_radii (GTK_COLOR_SWATCH (p), 1, 10, 10, 1);
631 gtk_grid_insert_next_to (GTK_GRID (cc->priv->custom), cc->priv->button, GTK_POS_RIGHT);
632 gtk_grid_attach (GTK_GRID (cc->priv->custom), p, 1, 0, 1, 1);
635 select_swatch (cc, GTK_COLOR_SWATCH (p));
636 save_custom_colors (cc);
640 gtk_color_chooser_widget_set_rgba (GtkColorChooser *chooser,
641 const GdkRGBA *color)
643 GtkColorChooserWidget *cc = GTK_COLOR_CHOOSER_WIDGET (chooser);
646 GtkColorSwatch *swatch;
650 palettes = gtk_container_get_children (GTK_CONTAINER (cc->priv->palette));
651 for (p = palettes; p; p = p->next)
654 if (!GTK_IS_GRID (grid))
657 children = gtk_container_get_children (GTK_CONTAINER (grid));
658 for (l = children; l; l = l->next)
661 gtk_color_swatch_get_rgba (swatch, &c);
662 if (!cc->priv->use_alpha)
663 c.alpha = color->alpha;
664 if (gdk_rgba_equal (color, &c))
666 select_swatch (cc, swatch);
667 g_list_free (children);
671 g_list_free (children);
673 g_list_free (palettes);
675 add_custom_color (cc, color);
679 gtk_color_chooser_widget_add_palette (GtkColorChooser *chooser,
681 gint colors_per_line,
685 GtkColorChooserWidget *cc = GTK_COLOR_CHOOSER_WIDGET (chooser);
687 remove_default_palette (cc);
688 add_palette (cc, horizontal, colors_per_line, n_colors, colors);
692 gtk_color_chooser_widget_iface_init (GtkColorChooserInterface *iface)
694 iface->get_rgba = gtk_color_chooser_widget_get_rgba;
695 iface->set_rgba = gtk_color_chooser_widget_set_rgba;
696 iface->add_palette = gtk_color_chooser_widget_add_palette;
699 /* Public API {{{1 */
702 * gtk_color_chooser_widget_new:
704 * Creates a new #GtkColorChooserWidget.
706 * Returns: a new #GtkColorChooserWidget
711 gtk_color_chooser_widget_new (void)
713 return g_object_new (GTK_TYPE_COLOR_CHOOSER_WIDGET, NULL);
716 /* vim:set foldmethod=marker: */