1 /* GIO - GLib Input, Output and Streaming Library
3 * Copyright (C) 2006-2007 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
16 * Public 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.
20 * Author: Alexander Larsson <alexl@redhat.com>
27 #include "gthemedicon.h"
35 * @short_description: Icon theming support
37 * @see_also: #GIcon, #GLoadableIcon
39 * #GThemedIcon is an implementation of #GIcon that supports icon themes.
40 * #GThemedIcon contains a list of all of the icons present in an icon
41 * theme, so that icons can be looked up quickly. #GThemedIcon does
42 * not provide actual pixmaps for icons, just the icon names.
43 * Ideally something like gtk_icon_theme_choose_icon() should be used to
44 * resolve the list of names so that fallback icons work nicely with
45 * themes that inherit other themes.
48 static void g_themed_icon_icon_iface_init (GIconIface *iface);
52 GObject parent_instance;
55 gboolean use_default_fallbacks;
58 struct _GThemedIconClass
60 GObjectClass parent_class;
68 PROP_USE_DEFAULT_FALLBACKS
71 G_DEFINE_TYPE_WITH_CODE (GThemedIcon, g_themed_icon, G_TYPE_OBJECT,
72 G_IMPLEMENT_INTERFACE (G_TYPE_ICON,
73 g_themed_icon_icon_iface_init))
76 g_themed_icon_get_property (GObject *object,
81 GThemedIcon *icon = G_THEMED_ICON (object);
86 g_value_set_boxed (value, icon->names);
89 case PROP_USE_DEFAULT_FALLBACKS:
90 g_value_set_boolean (value, icon->use_default_fallbacks);
94 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
99 g_themed_icon_set_property (GObject *object,
104 GThemedIcon *icon = G_THEMED_ICON (object);
111 name = g_value_get_string (value);
117 g_strfreev (icon->names);
119 icon->names = g_new (char *, 2);
120 icon->names[0] = g_strdup (name);
121 icon->names[1] = NULL;
125 names = g_value_dup_boxed (value);
131 g_strfreev (icon->names);
136 case PROP_USE_DEFAULT_FALLBACKS:
137 icon->use_default_fallbacks = g_value_get_boolean (value);
141 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
146 g_themed_icon_constructed (GObject *object)
148 GThemedIcon *themed = G_THEMED_ICON (object);
150 g_return_if_fail (themed->names != NULL && themed->names[0] != NULL);
152 if (themed->use_default_fallbacks)
154 int i = 0, dashes = 0;
158 gboolean is_symbolic;
162 is_symbolic = g_str_has_suffix (themed->names[0], "-symbolic");
164 name = g_strndup (themed->names[0], strlen (themed->names[0]) - 9);
166 name = g_strdup (themed->names[0]);
178 g_strfreev (themed->names);
180 names = g_new (char *, dashes + 1 + 1);
183 while ((dashp = strrchr (last, '-')) != NULL)
184 names[i++] = last = g_strndup (last, dashp - last);
190 themed->names = g_new (char *, 2 * dashes + 3);
191 for (i = 0; names[i] != NULL; i++)
193 themed->names[i] = g_strconcat (names[i], "-symbolic", NULL);
194 themed->names[dashes + 1 + i] = names[i];
197 themed->names[dashes + 1 + i] = NULL;
202 themed->names = names;
208 g_themed_icon_finalize (GObject *object)
212 themed = G_THEMED_ICON (object);
214 g_strfreev (themed->names);
216 G_OBJECT_CLASS (g_themed_icon_parent_class)->finalize (object);
220 g_themed_icon_class_init (GThemedIconClass *klass)
222 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
224 gobject_class->finalize = g_themed_icon_finalize;
225 gobject_class->constructed = g_themed_icon_constructed;
226 gobject_class->set_property = g_themed_icon_set_property;
227 gobject_class->get_property = g_themed_icon_get_property;
234 g_object_class_install_property (gobject_class, PROP_NAME,
235 g_param_spec_string ("name",
237 P_("The name of the icon"),
239 G_PARAM_CONSTRUCT_ONLY | G_PARAM_WRITABLE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_BLURB | G_PARAM_STATIC_NICK));
244 * A %NULL-terminated array of icon names.
246 g_object_class_install_property (gobject_class, PROP_NAMES,
247 g_param_spec_boxed ("names",
249 P_("An array containing the icon names"),
251 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_BLURB | G_PARAM_STATIC_NICK));
254 * GThemedIcon:use-default-fallbacks:
256 * Whether to use the default fallbacks found by shortening the icon name
257 * at '-' characters. If the "names" array has more than one element,
258 * ignores any past the first.
260 * For example, if the icon name was "gnome-dev-cdrom-audio", the array
264 * "gnome-dev-cdrom-audio",
272 g_object_class_install_property (gobject_class, PROP_USE_DEFAULT_FALLBACKS,
273 g_param_spec_boolean ("use-default-fallbacks",
274 P_("use default fallbacks"),
275 P_("Whether to use default fallbacks found by shortening the name at '-' characters. Ignores names after the first if multiple names are given."),
277 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_BLURB | G_PARAM_STATIC_NICK));
281 g_themed_icon_init (GThemedIcon *themed)
283 themed->names = NULL;
288 * @iconname: a string containing an icon name.
290 * Creates a new themed icon for @iconname.
292 * Returns: (transfer full) (type GThemedIcon): a new #GThemedIcon.
295 g_themed_icon_new (const char *iconname)
297 g_return_val_if_fail (iconname != NULL, NULL);
299 return G_ICON (g_object_new (G_TYPE_THEMED_ICON, "name", iconname, NULL));
303 * g_themed_icon_new_from_names:
304 * @iconnames: (array length=len): an array of strings containing icon names.
305 * @len: the length of the @iconnames array, or -1 if @iconnames is
308 * Creates a new themed icon for @iconnames.
310 * Returns: (transfer full) (type GThemedIcon): a new #GThemedIcon
313 g_themed_icon_new_from_names (char **iconnames,
318 g_return_val_if_fail (iconnames != NULL, NULL);
325 names = g_new (char *, len + 1);
327 for (i = 0; i < len; i++)
328 names[i] = iconnames[i];
332 icon = G_ICON (g_object_new (G_TYPE_THEMED_ICON, "names", names, NULL));
337 icon = G_ICON (g_object_new (G_TYPE_THEMED_ICON, "names", iconnames, NULL));
343 * g_themed_icon_new_with_default_fallbacks:
344 * @iconname: a string containing an icon name
346 * Creates a new themed icon for @iconname, and all the names
347 * that can be created by shortening @iconname at '-' characters.
349 * In the following example, @icon1 and @icon2 are equivalent:
351 * const char *names[] = {
352 * "gnome-dev-cdrom-audio",
358 * icon1 = g_themed_icon_new_from_names (names, 4);
359 * icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
362 * Returns: (transfer full) (type GThemedIcon): a new #GThemedIcon.
365 g_themed_icon_new_with_default_fallbacks (const char *iconname)
367 g_return_val_if_fail (iconname != NULL, NULL);
369 return G_ICON (g_object_new (G_TYPE_THEMED_ICON, "name", iconname, "use-default-fallbacks", TRUE, NULL));
374 * g_themed_icon_get_names:
375 * @icon: a #GThemedIcon.
377 * Gets the names of icons from within @icon.
379 * Returns: (transfer none): a list of icon names.
382 g_themed_icon_get_names (GThemedIcon *icon)
384 g_return_val_if_fail (G_IS_THEMED_ICON (icon), NULL);
385 return (const char * const *)icon->names;
389 * g_themed_icon_append_name:
390 * @icon: a #GThemedIcon
391 * @iconname: name of icon to append to list of icons from within @icon.
393 * Append a name to the list of icons from within @icon.
396 * Note that doing so invalidates the hash computed by prior calls
401 g_themed_icon_append_name (GThemedIcon *icon,
402 const char *iconname)
406 g_return_if_fail (G_IS_THEMED_ICON (icon));
407 g_return_if_fail (iconname != NULL);
409 num_names = g_strv_length (icon->names);
410 icon->names = g_realloc (icon->names, sizeof (char*) * (num_names + 2));
411 icon->names[num_names] = g_strdup (iconname);
412 icon->names[num_names + 1] = NULL;
414 g_object_notify (G_OBJECT (icon), "names");
418 * g_themed_icon_prepend_name:
419 * @icon: a #GThemedIcon
420 * @iconname: name of icon to prepend to list of icons from within @icon.
422 * Prepend a name to the list of icons from within @icon.
425 * Note that doing so invalidates the hash computed by prior calls
432 g_themed_icon_prepend_name (GThemedIcon *icon,
433 const char *iconname)
439 g_return_if_fail (G_IS_THEMED_ICON (icon));
440 g_return_if_fail (iconname != NULL);
442 num_names = g_strv_length (icon->names);
443 names = g_new (char*, num_names + 2);
444 for (i = 0; icon->names[i]; i++)
445 names[i + 1] = icon->names[i];
446 names[0] = g_strdup (iconname);
447 names[num_names + 1] = NULL;
449 g_free (icon->names);
452 g_object_notify (G_OBJECT (icon), "names");
456 g_themed_icon_hash (GIcon *icon)
458 GThemedIcon *themed = G_THEMED_ICON (icon);
464 for (i = 0; themed->names[i] != NULL; i++)
465 hash ^= g_str_hash (themed->names[i]);
471 g_themed_icon_equal (GIcon *icon1,
474 GThemedIcon *themed1 = G_THEMED_ICON (icon1);
475 GThemedIcon *themed2 = G_THEMED_ICON (icon2);
478 for (i = 0; themed1->names[i] != NULL && themed2->names[i] != NULL; i++)
480 if (!g_str_equal (themed1->names[i], themed2->names[i]))
484 return themed1->names[i] == NULL && themed2->names[i] == NULL;
489 g_themed_icon_to_tokens (GIcon *icon,
493 GThemedIcon *themed_icon = G_THEMED_ICON (icon);
496 g_return_val_if_fail (out_version != NULL, FALSE);
500 for (n = 0; themed_icon->names[n] != NULL; n++)
501 g_ptr_array_add (tokens,
502 g_strdup (themed_icon->names[n]));
508 g_themed_icon_from_tokens (gchar **tokens,
523 G_IO_ERROR_INVALID_ARGUMENT,
524 _("Can't handle version %d of GThemedIcon encoding"),
529 names = g_new0 (gchar *, num_tokens + 1);
530 for (n = 0; n < num_tokens; n++)
531 names[n] = tokens[n];
534 icon = g_themed_icon_new_from_names (names, num_tokens);
542 g_themed_icon_serialize (GIcon *icon)
544 GThemedIcon *themed_icon = G_THEMED_ICON (icon);
546 return g_variant_new ("(sv)", "themed", g_variant_new ("^as", themed_icon->names));
550 g_themed_icon_icon_iface_init (GIconIface *iface)
552 iface->hash = g_themed_icon_hash;
553 iface->equal = g_themed_icon_equal;
554 iface->to_tokens = g_themed_icon_to_tokens;
555 iface->from_tokens = g_themed_icon_from_tokens;
556 iface->serialize = g_themed_icon_serialize;