mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-26 23:46:15 +01:00
ab53a54632
The basic test for duplicate icon names was not working fine when taking into account fallbacks and icon style mix. This fixes it. Also resolve the few review comments, i.e.: comment explaining g_themed_icon_update_names() and the priority order applied to icons; and using guint for 'i'.
629 lines
17 KiB
C
629 lines
17 KiB
C
/* GIO - GLib Input, Output and Streaming Library
|
||
*
|
||
* Copyright (C) 2006-2007 Red Hat, Inc.
|
||
*
|
||
* This library is free software; you can redistribute it and/or
|
||
* modify it under the terms of the GNU Lesser General Public
|
||
* License as published by the Free Software Foundation; either
|
||
* version 2.1 of the License, or (at your option) any later version.
|
||
*
|
||
* This library is distributed in the hope that it will be useful,
|
||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
* Lesser General Public License for more details.
|
||
*
|
||
* You should have received a copy of the GNU Lesser General
|
||
* Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
||
*
|
||
* Author: Alexander Larsson <alexl@redhat.com>
|
||
*/
|
||
|
||
#include "config.h"
|
||
|
||
#include <string.h>
|
||
|
||
#include "gthemedicon.h"
|
||
#include "gicon.h"
|
||
#include "gioerror.h"
|
||
#include "glibintl.h"
|
||
|
||
|
||
/**
|
||
* SECTION:gthemedicon
|
||
* @short_description: Icon theming support
|
||
* @include: gio/gio.h
|
||
* @see_also: #GIcon, #GLoadableIcon
|
||
*
|
||
* #GThemedIcon is an implementation of #GIcon that supports icon themes.
|
||
* #GThemedIcon contains a list of all of the icons present in an icon
|
||
* theme, so that icons can be looked up quickly. #GThemedIcon does
|
||
* not provide actual pixmaps for icons, just the icon names.
|
||
* Ideally something like gtk_icon_theme_choose_icon() should be used to
|
||
* resolve the list of names so that fallback icons work nicely with
|
||
* themes that inherit other themes.
|
||
**/
|
||
|
||
static void g_themed_icon_icon_iface_init (GIconIface *iface);
|
||
|
||
struct _GThemedIcon
|
||
{
|
||
GObject parent_instance;
|
||
|
||
char **init_names;
|
||
char **names;
|
||
gboolean use_default_fallbacks;
|
||
};
|
||
|
||
struct _GThemedIconClass
|
||
{
|
||
GObjectClass parent_class;
|
||
};
|
||
|
||
enum
|
||
{
|
||
PROP_0,
|
||
PROP_NAME,
|
||
PROP_NAMES,
|
||
PROP_USE_DEFAULT_FALLBACKS
|
||
};
|
||
|
||
static void g_themed_icon_update_names (GThemedIcon *themed);
|
||
|
||
G_DEFINE_TYPE_WITH_CODE (GThemedIcon, g_themed_icon, G_TYPE_OBJECT,
|
||
G_IMPLEMENT_INTERFACE (G_TYPE_ICON,
|
||
g_themed_icon_icon_iface_init))
|
||
|
||
static void
|
||
g_themed_icon_get_property (GObject *object,
|
||
guint prop_id,
|
||
GValue *value,
|
||
GParamSpec *pspec)
|
||
{
|
||
GThemedIcon *icon = G_THEMED_ICON (object);
|
||
|
||
switch (prop_id)
|
||
{
|
||
case PROP_NAMES:
|
||
g_value_set_boxed (value, icon->init_names);
|
||
break;
|
||
|
||
case PROP_USE_DEFAULT_FALLBACKS:
|
||
g_value_set_boolean (value, icon->use_default_fallbacks);
|
||
break;
|
||
|
||
default:
|
||
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
||
}
|
||
}
|
||
|
||
static void
|
||
g_themed_icon_set_property (GObject *object,
|
||
guint prop_id,
|
||
const GValue *value,
|
||
GParamSpec *pspec)
|
||
{
|
||
GThemedIcon *icon = G_THEMED_ICON (object);
|
||
gchar **names;
|
||
const gchar *name;
|
||
|
||
switch (prop_id)
|
||
{
|
||
case PROP_NAME:
|
||
name = g_value_get_string (value);
|
||
|
||
if (!name)
|
||
break;
|
||
|
||
if (icon->init_names)
|
||
g_strfreev (icon->init_names);
|
||
|
||
icon->init_names = g_new (char *, 2);
|
||
icon->init_names[0] = g_strdup (name);
|
||
icon->init_names[1] = NULL;
|
||
break;
|
||
|
||
case PROP_NAMES:
|
||
names = g_value_dup_boxed (value);
|
||
|
||
if (!names)
|
||
break;
|
||
|
||
if (icon->init_names)
|
||
g_strfreev (icon->init_names);
|
||
|
||
icon->init_names = names;
|
||
break;
|
||
|
||
case PROP_USE_DEFAULT_FALLBACKS:
|
||
icon->use_default_fallbacks = g_value_get_boolean (value);
|
||
break;
|
||
|
||
default:
|
||
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
||
}
|
||
}
|
||
|
||
static void
|
||
g_themed_icon_constructed (GObject *object)
|
||
{
|
||
g_themed_icon_update_names (G_THEMED_ICON (object));
|
||
}
|
||
|
||
static void
|
||
g_themed_icon_finalize (GObject *object)
|
||
{
|
||
GThemedIcon *themed;
|
||
|
||
themed = G_THEMED_ICON (object);
|
||
|
||
g_strfreev (themed->init_names);
|
||
g_strfreev (themed->names);
|
||
|
||
G_OBJECT_CLASS (g_themed_icon_parent_class)->finalize (object);
|
||
}
|
||
|
||
static void
|
||
g_themed_icon_class_init (GThemedIconClass *klass)
|
||
{
|
||
GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
|
||
|
||
gobject_class->finalize = g_themed_icon_finalize;
|
||
gobject_class->constructed = g_themed_icon_constructed;
|
||
gobject_class->set_property = g_themed_icon_set_property;
|
||
gobject_class->get_property = g_themed_icon_get_property;
|
||
|
||
/**
|
||
* GThemedIcon:name:
|
||
*
|
||
* The icon name.
|
||
*/
|
||
g_object_class_install_property (gobject_class, PROP_NAME,
|
||
g_param_spec_string ("name",
|
||
P_("name"),
|
||
P_("The name of the icon"),
|
||
NULL,
|
||
G_PARAM_CONSTRUCT_ONLY | G_PARAM_WRITABLE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_BLURB | G_PARAM_STATIC_NICK));
|
||
|
||
/**
|
||
* GThemedIcon:names:
|
||
*
|
||
* A %NULL-terminated array of icon names.
|
||
*/
|
||
g_object_class_install_property (gobject_class, PROP_NAMES,
|
||
g_param_spec_boxed ("names",
|
||
P_("names"),
|
||
P_("An array containing the icon names"),
|
||
G_TYPE_STRV,
|
||
G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_BLURB | G_PARAM_STATIC_NICK));
|
||
|
||
/**
|
||
* GThemedIcon:use-default-fallbacks:
|
||
*
|
||
* Whether to use the default fallbacks found by shortening the icon name
|
||
* at '-' characters. If the "names" array has more than one element,
|
||
* ignores any past the first.
|
||
*
|
||
* For example, if the icon name was "gnome-dev-cdrom-audio", the array
|
||
* would become
|
||
* |[<!-- language="C" -->
|
||
* {
|
||
* "gnome-dev-cdrom-audio",
|
||
* "gnome-dev-cdrom",
|
||
* "gnome-dev",
|
||
* "gnome",
|
||
* NULL
|
||
* };
|
||
* ]|
|
||
*/
|
||
g_object_class_install_property (gobject_class, PROP_USE_DEFAULT_FALLBACKS,
|
||
g_param_spec_boolean ("use-default-fallbacks",
|
||
P_("use default fallbacks"),
|
||
P_("Whether to use default fallbacks found by shortening the name at “-” characters. Ignores names after the first if multiple names are given."),
|
||
FALSE,
|
||
G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_BLURB | G_PARAM_STATIC_NICK));
|
||
}
|
||
|
||
static void
|
||
g_themed_icon_init (GThemedIcon *themed)
|
||
{
|
||
themed->init_names = NULL;
|
||
themed->names = NULL;
|
||
}
|
||
|
||
/**
|
||
* g_themed_icon_update_names:
|
||
* @themed: a #GThemedIcon.
|
||
*
|
||
* Update the actual icon name list, based on the requested names (from
|
||
* construction, or later added with g_themed_icon_prepend_name() and
|
||
* g_themed_icon_append_name()).
|
||
* The order of the list matters, indicating priority:
|
||
* - The first requested icon is first in priority.
|
||
* - If "use-default-fallbacks" is #TRUE, then it is followed by all its
|
||
* fallbacks (starting from top to lower context levels).
|
||
* - Then next requested icons, and optionally their fallbacks, follow.
|
||
* - Finally all the style variants (symbolic or regular, opposite to whatever
|
||
* is the requested style) follow in the same order.
|
||
*
|
||
* An icon is not added twice in the list if it was previously added.
|
||
*
|
||
* For instance, if requested names are:
|
||
* [ "some-icon-symbolic", "some-other-icon" ]
|
||
* and use-default-fallbacks is TRUE, the final name list shall be:
|
||
* [ "some-icon-symbolic", "some-symbolic", "some-other-icon",
|
||
* "some-other", "some", "some-icon", "some-other-icon-symbolic",
|
||
* "some-other-symbolic" ]
|
||
*
|
||
* Returns: (transfer full) (type GThemedIcon): a new #GThemedIcon
|
||
**/
|
||
static void
|
||
g_themed_icon_update_names (GThemedIcon *themed)
|
||
{
|
||
GList *names = NULL;
|
||
GList *variants = NULL;
|
||
GList *iter;
|
||
guint i;
|
||
|
||
g_return_if_fail (themed->init_names != NULL && themed->init_names[0] != NULL);
|
||
|
||
for (i = 0; themed->init_names[i]; i++)
|
||
{
|
||
gchar *name;
|
||
gboolean is_symbolic;
|
||
|
||
is_symbolic = g_str_has_suffix (themed->init_names[i], "-symbolic");
|
||
if (is_symbolic)
|
||
name = g_strndup (themed->init_names[i], strlen (themed->init_names[i]) - 9);
|
||
else
|
||
name = g_strdup (themed->init_names[i]);
|
||
|
||
if (g_list_find_custom (names, name, (GCompareFunc) g_strcmp0))
|
||
{
|
||
g_free (name);
|
||
continue;
|
||
}
|
||
|
||
if (is_symbolic)
|
||
names = g_list_prepend (names, g_strdup (themed->init_names[i]));
|
||
else
|
||
names = g_list_prepend (names, name);
|
||
|
||
if (themed->use_default_fallbacks)
|
||
{
|
||
char *dashp;
|
||
char *last;
|
||
|
||
last = name;
|
||
|
||
while ((dashp = strrchr (last, '-')) != NULL)
|
||
{
|
||
gchar *tmp = last;
|
||
gchar *fallback;
|
||
|
||
last = g_strndup (last, dashp - last);
|
||
if (is_symbolic)
|
||
{
|
||
g_free (tmp);
|
||
fallback = g_strdup_printf ("%s-symbolic", last);
|
||
}
|
||
else
|
||
fallback = last;
|
||
if (g_list_find_custom (names, fallback, (GCompareFunc) g_strcmp0))
|
||
{
|
||
g_free (fallback);
|
||
break;
|
||
}
|
||
names = g_list_prepend (names, fallback);
|
||
}
|
||
if (is_symbolic)
|
||
g_free (last);
|
||
}
|
||
else if (is_symbolic)
|
||
g_free (name);
|
||
}
|
||
for (iter = names; iter; iter = iter->next)
|
||
{
|
||
gchar *name = (gchar *) iter->data;
|
||
gchar *variant;
|
||
gboolean is_symbolic;
|
||
|
||
is_symbolic = g_str_has_suffix (name, "-symbolic");
|
||
if (is_symbolic)
|
||
variant = g_strndup (name, strlen (name) - 9);
|
||
else
|
||
variant = g_strdup_printf ("%s-symbolic", name);
|
||
if (g_list_find_custom (names, variant, (GCompareFunc) g_strcmp0) ||
|
||
g_list_find_custom (variants, variant, (GCompareFunc) g_strcmp0))
|
||
{
|
||
g_free (variant);
|
||
continue;
|
||
}
|
||
|
||
variants = g_list_prepend (variants, variant);
|
||
}
|
||
names = g_list_reverse (names);
|
||
|
||
g_strfreev (themed->names);
|
||
themed->names = g_new (char *, g_list_length (names) + g_list_length (variants) + 1);
|
||
|
||
for (iter = names, i = 0; iter; iter = iter->next, i++)
|
||
themed->names[i] = iter->data;
|
||
for (iter = variants; iter; iter = iter->next, i++)
|
||
themed->names[i] = iter->data;
|
||
themed->names[i] = NULL;
|
||
|
||
g_list_free (names);
|
||
g_list_free (variants);
|
||
|
||
g_object_notify (G_OBJECT (themed), "names");
|
||
}
|
||
|
||
/**
|
||
* g_themed_icon_new:
|
||
* @iconname: a string containing an icon name.
|
||
*
|
||
* Creates a new themed icon for @iconname.
|
||
*
|
||
* Returns: (transfer full) (type GThemedIcon): a new #GThemedIcon.
|
||
**/
|
||
GIcon *
|
||
g_themed_icon_new (const char *iconname)
|
||
{
|
||
g_return_val_if_fail (iconname != NULL, NULL);
|
||
|
||
return G_ICON (g_object_new (G_TYPE_THEMED_ICON, "name", iconname, NULL));
|
||
}
|
||
|
||
/**
|
||
* g_themed_icon_new_from_names:
|
||
* @iconnames: (array length=len): an array of strings containing icon names.
|
||
* @len: the length of the @iconnames array, or -1 if @iconnames is
|
||
* %NULL-terminated
|
||
*
|
||
* Creates a new themed icon for @iconnames.
|
||
*
|
||
* Returns: (transfer full) (type GThemedIcon): a new #GThemedIcon
|
||
**/
|
||
GIcon *
|
||
g_themed_icon_new_from_names (char **iconnames,
|
||
int len)
|
||
{
|
||
GIcon *icon;
|
||
|
||
g_return_val_if_fail (iconnames != NULL, NULL);
|
||
|
||
if (len >= 0)
|
||
{
|
||
char **names;
|
||
int i;
|
||
|
||
names = g_new (char *, len + 1);
|
||
|
||
for (i = 0; i < len; i++)
|
||
names[i] = iconnames[i];
|
||
|
||
names[i] = NULL;
|
||
|
||
icon = G_ICON (g_object_new (G_TYPE_THEMED_ICON, "names", names, NULL));
|
||
|
||
g_free (names);
|
||
}
|
||
else
|
||
icon = G_ICON (g_object_new (G_TYPE_THEMED_ICON, "names", iconnames, NULL));
|
||
|
||
return icon;
|
||
}
|
||
|
||
/**
|
||
* g_themed_icon_new_with_default_fallbacks:
|
||
* @iconname: a string containing an icon name
|
||
*
|
||
* Creates a new themed icon for @iconname, and all the names
|
||
* that can be created by shortening @iconname at '-' characters.
|
||
*
|
||
* In the following example, @icon1 and @icon2 are equivalent:
|
||
* |[<!-- language="C" -->
|
||
* const char *names[] = {
|
||
* "gnome-dev-cdrom-audio",
|
||
* "gnome-dev-cdrom",
|
||
* "gnome-dev",
|
||
* "gnome"
|
||
* };
|
||
*
|
||
* icon1 = g_themed_icon_new_from_names (names, 4);
|
||
* icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
|
||
* ]|
|
||
*
|
||
* Returns: (transfer full) (type GThemedIcon): a new #GThemedIcon.
|
||
*/
|
||
GIcon *
|
||
g_themed_icon_new_with_default_fallbacks (const char *iconname)
|
||
{
|
||
g_return_val_if_fail (iconname != NULL, NULL);
|
||
|
||
return G_ICON (g_object_new (G_TYPE_THEMED_ICON, "name", iconname, "use-default-fallbacks", TRUE, NULL));
|
||
}
|
||
|
||
|
||
/**
|
||
* g_themed_icon_get_names:
|
||
* @icon: a #GThemedIcon.
|
||
*
|
||
* Gets the names of icons from within @icon.
|
||
*
|
||
* Returns: (transfer none): a list of icon names.
|
||
*/
|
||
const char * const *
|
||
g_themed_icon_get_names (GThemedIcon *icon)
|
||
{
|
||
g_return_val_if_fail (G_IS_THEMED_ICON (icon), NULL);
|
||
return (const char * const *)icon->names;
|
||
}
|
||
|
||
/**
|
||
* g_themed_icon_append_name:
|
||
* @icon: a #GThemedIcon
|
||
* @iconname: name of icon to append to list of icons from within @icon.
|
||
*
|
||
* Append a name to the list of icons from within @icon.
|
||
*
|
||
* Note that doing so invalidates the hash computed by prior calls
|
||
* to g_icon_hash().
|
||
*/
|
||
void
|
||
g_themed_icon_append_name (GThemedIcon *icon,
|
||
const char *iconname)
|
||
{
|
||
guint num_names;
|
||
|
||
g_return_if_fail (G_IS_THEMED_ICON (icon));
|
||
g_return_if_fail (iconname != NULL);
|
||
|
||
num_names = g_strv_length (icon->init_names);
|
||
icon->init_names = g_realloc (icon->init_names, sizeof (char*) * (num_names + 2));
|
||
icon->init_names[num_names] = g_strdup (iconname);
|
||
icon->init_names[num_names + 1] = NULL;
|
||
|
||
g_themed_icon_update_names (icon);
|
||
}
|
||
|
||
/**
|
||
* g_themed_icon_prepend_name:
|
||
* @icon: a #GThemedIcon
|
||
* @iconname: name of icon to prepend to list of icons from within @icon.
|
||
*
|
||
* Prepend a name to the list of icons from within @icon.
|
||
*
|
||
* Note that doing so invalidates the hash computed by prior calls
|
||
* to g_icon_hash().
|
||
*
|
||
* Since: 2.18
|
||
*/
|
||
void
|
||
g_themed_icon_prepend_name (GThemedIcon *icon,
|
||
const char *iconname)
|
||
{
|
||
guint num_names;
|
||
gchar **names;
|
||
gint i;
|
||
|
||
g_return_if_fail (G_IS_THEMED_ICON (icon));
|
||
g_return_if_fail (iconname != NULL);
|
||
|
||
num_names = g_strv_length (icon->init_names);
|
||
names = g_new (char*, num_names + 2);
|
||
for (i = 0; icon->init_names[i]; i++)
|
||
names[i + 1] = icon->init_names[i];
|
||
names[0] = g_strdup (iconname);
|
||
names[num_names + 1] = NULL;
|
||
|
||
g_free (icon->init_names);
|
||
icon->init_names = names;
|
||
|
||
g_themed_icon_update_names (icon);
|
||
}
|
||
|
||
static guint
|
||
g_themed_icon_hash (GIcon *icon)
|
||
{
|
||
GThemedIcon *themed = G_THEMED_ICON (icon);
|
||
guint hash;
|
||
int i;
|
||
|
||
hash = 0;
|
||
|
||
for (i = 0; themed->names[i] != NULL; i++)
|
||
hash ^= g_str_hash (themed->names[i]);
|
||
|
||
return hash;
|
||
}
|
||
|
||
static gboolean
|
||
g_themed_icon_equal (GIcon *icon1,
|
||
GIcon *icon2)
|
||
{
|
||
GThemedIcon *themed1 = G_THEMED_ICON (icon1);
|
||
GThemedIcon *themed2 = G_THEMED_ICON (icon2);
|
||
int i;
|
||
|
||
for (i = 0; themed1->names[i] != NULL && themed2->names[i] != NULL; i++)
|
||
{
|
||
if (!g_str_equal (themed1->names[i], themed2->names[i]))
|
||
return FALSE;
|
||
}
|
||
|
||
return themed1->names[i] == NULL && themed2->names[i] == NULL;
|
||
}
|
||
|
||
|
||
static gboolean
|
||
g_themed_icon_to_tokens (GIcon *icon,
|
||
GPtrArray *tokens,
|
||
gint *out_version)
|
||
{
|
||
GThemedIcon *themed_icon = G_THEMED_ICON (icon);
|
||
int n;
|
||
|
||
g_return_val_if_fail (out_version != NULL, FALSE);
|
||
|
||
*out_version = 0;
|
||
|
||
for (n = 0; themed_icon->names[n] != NULL; n++)
|
||
g_ptr_array_add (tokens,
|
||
g_strdup (themed_icon->names[n]));
|
||
|
||
return TRUE;
|
||
}
|
||
|
||
static GIcon *
|
||
g_themed_icon_from_tokens (gchar **tokens,
|
||
gint num_tokens,
|
||
gint version,
|
||
GError **error)
|
||
{
|
||
GIcon *icon;
|
||
gchar **names;
|
||
int n;
|
||
|
||
icon = NULL;
|
||
|
||
if (version != 0)
|
||
{
|
||
g_set_error (error,
|
||
G_IO_ERROR,
|
||
G_IO_ERROR_INVALID_ARGUMENT,
|
||
_("Can’t handle version %d of GThemedIcon encoding"),
|
||
version);
|
||
goto out;
|
||
}
|
||
|
||
names = g_new0 (gchar *, num_tokens + 1);
|
||
for (n = 0; n < num_tokens; n++)
|
||
names[n] = tokens[n];
|
||
names[n] = NULL;
|
||
|
||
icon = g_themed_icon_new_from_names (names, num_tokens);
|
||
g_free (names);
|
||
|
||
out:
|
||
return icon;
|
||
}
|
||
|
||
static GVariant *
|
||
g_themed_icon_serialize (GIcon *icon)
|
||
{
|
||
GThemedIcon *themed_icon = G_THEMED_ICON (icon);
|
||
|
||
return g_variant_new ("(sv)", "themed", g_variant_new ("^as", themed_icon->names));
|
||
}
|
||
|
||
static void
|
||
g_themed_icon_icon_iface_init (GIconIface *iface)
|
||
{
|
||
iface->hash = g_themed_icon_hash;
|
||
iface->equal = g_themed_icon_equal;
|
||
iface->to_tokens = g_themed_icon_to_tokens;
|
||
iface->from_tokens = g_themed_icon_from_tokens;
|
||
iface->serialize = g_themed_icon_serialize;
|
||
}
|