Blame gio/gemblemedicon.c

Packit ae235b
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
Packit ae235b
Packit ae235b
/* GIO - GLib Input, Output and Streaming Library
Packit ae235b
 * 
Packit ae235b
 * Copyright (C) 2006-2007 Red Hat, Inc.
Packit ae235b
 *
Packit ae235b
 * This library is free software; you can redistribute it and/or
Packit ae235b
 * modify it under the terms of the GNU Lesser General Public
Packit ae235b
 * License as published by the Free Software Foundation; either
Packit ae235b
 * version 2.1 of the License, or (at your option) any later version.
Packit ae235b
 *
Packit ae235b
 * This library is distributed in the hope that it will be useful,
Packit ae235b
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit ae235b
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit ae235b
 * Lesser General Public License for more details.
Packit ae235b
 *
Packit ae235b
 * You should have received a copy of the GNU Lesser General
Packit ae235b
 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
Packit ae235b
 *
Packit ae235b
 * Author: Matthias Clasen <mclasen@redhat.com>
Packit ae235b
 *         Clemens N. Buss <cebuzz@gmail.com>
Packit ae235b
 */
Packit ae235b
Packit ae235b
#include <config.h>
Packit ae235b
Packit ae235b
#include <string.h>
Packit ae235b
Packit ae235b
#include "gemblemedicon.h"
Packit ae235b
#include "glibintl.h"
Packit ae235b
#include "gioerror.h"
Packit ae235b
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * SECTION:gemblemedicon
Packit ae235b
 * @short_description: Icon with emblems
Packit ae235b
 * @include: gio/gio.h
Packit ae235b
 * @see_also: #GIcon, #GLoadableIcon, #GThemedIcon, #GEmblem
Packit ae235b
 *
Packit ae235b
 * #GEmblemedIcon is an implementation of #GIcon that supports
Packit ae235b
 * adding an emblem to an icon. Adding multiple emblems to an
Packit ae235b
 * icon is ensured via g_emblemed_icon_add_emblem(). 
Packit ae235b
 *
Packit ae235b
 * Note that #GEmblemedIcon allows no control over the position
Packit ae235b
 * of the emblems. See also #GEmblem for more information.
Packit ae235b
 **/
Packit ae235b
Packit ae235b
enum {
Packit ae235b
  PROP_GICON = 1,
Packit ae235b
  NUM_PROPERTIES
Packit ae235b
};
Packit ae235b
Packit ae235b
struct _GEmblemedIconPrivate {
Packit ae235b
  GIcon *icon;
Packit ae235b
  GList *emblems;
Packit ae235b
};
Packit ae235b
Packit ae235b
static GParamSpec *properties[NUM_PROPERTIES] = { NULL, };
Packit ae235b
Packit ae235b
static void g_emblemed_icon_icon_iface_init (GIconIface *iface);
Packit ae235b
Packit ae235b
G_DEFINE_TYPE_WITH_CODE (GEmblemedIcon, g_emblemed_icon, G_TYPE_OBJECT,
Packit ae235b
                         G_ADD_PRIVATE (GEmblemedIcon)
Packit ae235b
                         G_IMPLEMENT_INTERFACE (G_TYPE_ICON,
Packit ae235b
                         g_emblemed_icon_icon_iface_init))
Packit ae235b
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_emblemed_icon_finalize (GObject *object)
Packit ae235b
{
Packit ae235b
  GEmblemedIcon *emblemed;
Packit ae235b
Packit ae235b
  emblemed = G_EMBLEMED_ICON (object);
Packit ae235b
Packit ae235b
  g_clear_object (&emblemed->priv->icon);
Packit ae235b
  g_list_free_full (emblemed->priv->emblems, g_object_unref);
Packit ae235b
Packit ae235b
  (*G_OBJECT_CLASS (g_emblemed_icon_parent_class)->finalize) (object);
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_emblemed_icon_set_property (GObject  *object,
Packit ae235b
                              guint property_id,
Packit ae235b
                              const GValue *value,
Packit ae235b
                              GParamSpec *pspec)
Packit ae235b
{
Packit ae235b
  GEmblemedIcon *self = G_EMBLEMED_ICON (object);
Packit ae235b
Packit ae235b
  switch (property_id)
Packit ae235b
    {
Packit ae235b
    case PROP_GICON:
Packit ae235b
      self->priv->icon = g_value_dup_object (value);
Packit ae235b
      break;
Packit ae235b
    default:
Packit ae235b
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
Packit ae235b
      break;
Packit ae235b
    }
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_emblemed_icon_get_property (GObject  *object,
Packit ae235b
                              guint property_id,
Packit ae235b
                              GValue *value,
Packit ae235b
                              GParamSpec *pspec)
Packit ae235b
{
Packit ae235b
  GEmblemedIcon *self = G_EMBLEMED_ICON (object);
Packit ae235b
Packit ae235b
  switch (property_id)
Packit ae235b
    {
Packit ae235b
    case PROP_GICON:
Packit ae235b
      g_value_set_object (value, self->priv->icon);
Packit ae235b
      break;
Packit ae235b
    default:
Packit ae235b
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
Packit ae235b
      break;
Packit ae235b
    }
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_emblemed_icon_class_init (GEmblemedIconClass *klass)
Packit ae235b
{
Packit ae235b
  GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
Packit ae235b
Packit ae235b
  gobject_class->finalize = g_emblemed_icon_finalize;
Packit ae235b
  gobject_class->set_property = g_emblemed_icon_set_property;
Packit ae235b
  gobject_class->get_property = g_emblemed_icon_get_property;
Packit ae235b
Packit ae235b
  properties[PROP_GICON] =
Packit ae235b
    g_param_spec_object ("gicon",
Packit ae235b
                         P_("The base GIcon"),
Packit ae235b
                         P_("The GIcon to attach emblems to"),
Packit ae235b
                         G_TYPE_ICON,
Packit ae235b
                         G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS);
Packit ae235b
Packit ae235b
  g_object_class_install_properties (gobject_class, NUM_PROPERTIES, properties);
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_emblemed_icon_init (GEmblemedIcon *emblemed)
Packit ae235b
{
Packit ae235b
  emblemed->priv = g_emblemed_icon_get_instance_private (emblemed);
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_emblemed_icon_new:
Packit ae235b
 * @icon: a #GIcon
Packit ae235b
 * @emblem: (nullable): a #GEmblem, or %NULL
Packit ae235b
 *
Packit ae235b
 * Creates a new emblemed icon for @icon with the emblem @emblem.
Packit ae235b
 *
Packit ae235b
 * Returns: (transfer full) (type GEmblemedIcon): a new #GIcon
Packit ae235b
 *
Packit ae235b
 * Since: 2.18
Packit ae235b
 **/
Packit ae235b
GIcon *
Packit ae235b
g_emblemed_icon_new (GIcon   *icon,
Packit ae235b
                     GEmblem *emblem)
Packit ae235b
{
Packit ae235b
  GEmblemedIcon *emblemed;
Packit ae235b
  
Packit ae235b
  g_return_val_if_fail (G_IS_ICON (icon), NULL);
Packit ae235b
  g_return_val_if_fail (!G_IS_EMBLEM (icon), NULL);
Packit ae235b
Packit ae235b
  emblemed = G_EMBLEMED_ICON (g_object_new (G_TYPE_EMBLEMED_ICON,
Packit ae235b
                                            "gicon", icon,
Packit ae235b
                                            NULL));
Packit ae235b
Packit ae235b
  if (emblem != NULL)
Packit ae235b
    g_emblemed_icon_add_emblem (emblemed, emblem);
Packit ae235b
Packit ae235b
  return G_ICON (emblemed);
Packit ae235b
}
Packit ae235b
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_emblemed_icon_get_icon:
Packit ae235b
 * @emblemed: a #GEmblemedIcon
Packit ae235b
 *
Packit ae235b
 * Gets the main icon for @emblemed.
Packit ae235b
 *
Packit ae235b
 * Returns: (transfer none): a #GIcon that is owned by @emblemed
Packit ae235b
 *
Packit ae235b
 * Since: 2.18
Packit ae235b
 **/
Packit ae235b
GIcon *
Packit ae235b
g_emblemed_icon_get_icon (GEmblemedIcon *emblemed)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_EMBLEMED_ICON (emblemed), NULL);
Packit ae235b
Packit ae235b
  return emblemed->priv->icon;
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_emblemed_icon_get_emblems:
Packit ae235b
 * @emblemed: a #GEmblemedIcon
Packit ae235b
 *
Packit ae235b
 * Gets the list of emblems for the @icon.
Packit ae235b
 *
Packit ae235b
 * Returns: (element-type Gio.Emblem) (transfer none): a #GList of
Packit ae235b
 *     #GEmblems that is owned by @emblemed
Packit ae235b
 *
Packit ae235b
 * Since: 2.18
Packit ae235b
 **/
Packit ae235b
Packit ae235b
GList *
Packit ae235b
g_emblemed_icon_get_emblems (GEmblemedIcon *emblemed)
Packit ae235b
{
Packit ae235b
  g_return_val_if_fail (G_IS_EMBLEMED_ICON (emblemed), NULL);
Packit ae235b
Packit ae235b
  return emblemed->priv->emblems;
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_emblemed_icon_clear_emblems:
Packit ae235b
 * @emblemed: a #GEmblemedIcon
Packit ae235b
 *
Packit ae235b
 * Removes all the emblems from @icon.
Packit ae235b
 *
Packit ae235b
 * Since: 2.28
Packit ae235b
 **/
Packit ae235b
void
Packit ae235b
g_emblemed_icon_clear_emblems (GEmblemedIcon *emblemed)
Packit ae235b
{
Packit ae235b
  g_return_if_fail (G_IS_EMBLEMED_ICON (emblemed));
Packit ae235b
Packit ae235b
  if (emblemed->priv->emblems == NULL)
Packit ae235b
    return;
Packit ae235b
Packit ae235b
  g_list_free_full (emblemed->priv->emblems, g_object_unref);
Packit ae235b
  emblemed->priv->emblems = NULL;
Packit ae235b
}
Packit ae235b
Packit ae235b
static gint
Packit ae235b
g_emblem_comp (GEmblem *a,
Packit ae235b
               GEmblem *b)
Packit ae235b
{
Packit ae235b
  guint hash_a = g_icon_hash (G_ICON (a));
Packit ae235b
  guint hash_b = g_icon_hash (G_ICON (b));
Packit ae235b
Packit ae235b
  if(hash_a < hash_b)
Packit ae235b
    return -1;
Packit ae235b
Packit ae235b
  if(hash_a == hash_b)
Packit ae235b
    return 0;
Packit ae235b
Packit ae235b
  return 1;
Packit ae235b
}
Packit ae235b
Packit ae235b
/**
Packit ae235b
 * g_emblemed_icon_add_emblem:
Packit ae235b
 * @emblemed: a #GEmblemedIcon
Packit ae235b
 * @emblem: a #GEmblem
Packit ae235b
 *
Packit ae235b
 * Adds @emblem to the #GList of #GEmblems.
Packit ae235b
 *
Packit ae235b
 * Since: 2.18
Packit ae235b
 **/
Packit ae235b
void 
Packit ae235b
g_emblemed_icon_add_emblem (GEmblemedIcon *emblemed,
Packit ae235b
                            GEmblem       *emblem)
Packit ae235b
{
Packit ae235b
  g_return_if_fail (G_IS_EMBLEMED_ICON (emblemed));
Packit ae235b
  g_return_if_fail (G_IS_EMBLEM (emblem));
Packit ae235b
Packit ae235b
  g_object_ref (emblem);
Packit ae235b
  emblemed->priv->emblems = g_list_insert_sorted (emblemed->priv->emblems, emblem,
Packit ae235b
                                                  (GCompareFunc) g_emblem_comp);
Packit ae235b
}
Packit ae235b
Packit ae235b
static guint
Packit ae235b
g_emblemed_icon_hash (GIcon *icon)
Packit ae235b
{
Packit ae235b
  GEmblemedIcon *emblemed = G_EMBLEMED_ICON (icon);
Packit ae235b
  GList *list;
Packit ae235b
  guint hash = g_icon_hash (emblemed->priv->icon);
Packit ae235b
Packit ae235b
  for (list = emblemed->priv->emblems; list != NULL; list = list->next)
Packit ae235b
    hash ^= g_icon_hash (G_ICON (list->data));
Packit ae235b
Packit ae235b
  return hash;
Packit ae235b
}
Packit ae235b
Packit ae235b
static gboolean
Packit ae235b
g_emblemed_icon_equal (GIcon *icon1,
Packit ae235b
                       GIcon *icon2)
Packit ae235b
{
Packit ae235b
  GEmblemedIcon *emblemed1 = G_EMBLEMED_ICON (icon1);
Packit ae235b
  GEmblemedIcon *emblemed2 = G_EMBLEMED_ICON (icon2);
Packit ae235b
  GList *list1, *list2;
Packit ae235b
Packit ae235b
  if (!g_icon_equal (emblemed1->priv->icon, emblemed2->priv->icon))
Packit ae235b
    return FALSE;
Packit ae235b
Packit ae235b
  list1 = emblemed1->priv->emblems;
Packit ae235b
  list2 = emblemed2->priv->emblems;
Packit ae235b
Packit ae235b
  while (list1 && list2)
Packit ae235b
  {
Packit ae235b
    if (!g_icon_equal (G_ICON (list1->data), G_ICON (list2->data)))
Packit ae235b
        return FALSE;
Packit ae235b
    
Packit ae235b
    list1 = list1->next;
Packit ae235b
    list2 = list2->next;
Packit ae235b
  }
Packit ae235b
  
Packit ae235b
  return list1 == NULL && list2 == NULL;
Packit ae235b
}
Packit ae235b
Packit ae235b
static gboolean
Packit ae235b
g_emblemed_icon_to_tokens (GIcon *icon,
Packit ae235b
                           GPtrArray *tokens,
Packit ae235b
                           gint  *out_version)
Packit ae235b
{
Packit ae235b
  GEmblemedIcon *emblemed_icon = G_EMBLEMED_ICON (icon);
Packit ae235b
  GList *l;
Packit ae235b
  char *s;
Packit ae235b
Packit ae235b
  /* GEmblemedIcons are encoded as
Packit ae235b
   *
Packit ae235b
   *   <encoded_icon> [<encoded_emblem_icon>]*
Packit ae235b
   */
Packit ae235b
Packit ae235b
  g_return_val_if_fail (out_version != NULL, FALSE);
Packit ae235b
Packit ae235b
  *out_version = 0;
Packit ae235b
Packit ae235b
  s = g_icon_to_string (emblemed_icon->priv->icon);
Packit ae235b
  if (s == NULL)
Packit ae235b
    return FALSE;
Packit ae235b
Packit ae235b
  g_ptr_array_add (tokens, s);
Packit ae235b
Packit ae235b
  for (l = emblemed_icon->priv->emblems; l != NULL; l = l->next)
Packit ae235b
    {
Packit ae235b
      GIcon *emblem_icon = G_ICON (l->data);
Packit ae235b
Packit ae235b
      s = g_icon_to_string (emblem_icon);
Packit ae235b
      if (s == NULL)
Packit ae235b
        return FALSE;
Packit ae235b
      
Packit ae235b
      g_ptr_array_add (tokens, s);
Packit ae235b
    }
Packit ae235b
Packit ae235b
  return TRUE;
Packit ae235b
}
Packit ae235b
Packit ae235b
static GIcon *
Packit ae235b
g_emblemed_icon_from_tokens (gchar  **tokens,
Packit ae235b
                             gint     num_tokens,
Packit ae235b
                             gint     version,
Packit ae235b
                             GError **error)
Packit ae235b
{
Packit ae235b
  GEmblemedIcon *emblemed_icon;
Packit ae235b
  int n;
Packit ae235b
Packit ae235b
  emblemed_icon = NULL;
Packit ae235b
Packit ae235b
  if (version != 0)
Packit ae235b
    {
Packit ae235b
      g_set_error (error,
Packit ae235b
                   G_IO_ERROR,
Packit ae235b
                   G_IO_ERROR_INVALID_ARGUMENT,
Packit ae235b
                   _("Can’t handle version %d of GEmblemedIcon encoding"),
Packit ae235b
                   version);
Packit ae235b
      goto fail;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  if (num_tokens < 1)
Packit ae235b
    {
Packit ae235b
      g_set_error (error,
Packit ae235b
                   G_IO_ERROR,
Packit ae235b
                   G_IO_ERROR_INVALID_ARGUMENT,
Packit ae235b
                   _("Malformed number of tokens (%d) in GEmblemedIcon encoding"),
Packit ae235b
                   num_tokens);
Packit ae235b
      goto fail;
Packit ae235b
    }
Packit ae235b
Packit ae235b
  emblemed_icon = g_object_new (G_TYPE_EMBLEMED_ICON, NULL);
Packit ae235b
  emblemed_icon->priv->icon = g_icon_new_for_string (tokens[0], error);
Packit ae235b
  if (emblemed_icon->priv->icon == NULL)
Packit ae235b
    goto fail;
Packit ae235b
Packit ae235b
  for (n = 1; n < num_tokens; n++)
Packit ae235b
    {
Packit ae235b
      GIcon *emblem;
Packit ae235b
Packit ae235b
      emblem = g_icon_new_for_string (tokens[n], error);
Packit ae235b
      if (emblem == NULL)
Packit ae235b
        goto fail;
Packit ae235b
Packit ae235b
      if (!G_IS_EMBLEM (emblem))
Packit ae235b
        {
Packit ae235b
          g_set_error_literal (error,
Packit ae235b
                               G_IO_ERROR,
Packit ae235b
                               G_IO_ERROR_INVALID_ARGUMENT,
Packit ae235b
                               _("Expected a GEmblem for GEmblemedIcon"));
Packit ae235b
          g_object_unref (emblem);
Packit ae235b
          goto fail;
Packit ae235b
        }
Packit ae235b
Packit ae235b
      emblemed_icon->priv->emblems = g_list_append (emblemed_icon->priv->emblems, emblem);
Packit ae235b
    }
Packit ae235b
Packit ae235b
  return G_ICON (emblemed_icon);
Packit ae235b
Packit ae235b
 fail:
Packit ae235b
  if (emblemed_icon != NULL)
Packit ae235b
    g_object_unref (emblemed_icon);
Packit ae235b
  return NULL;
Packit ae235b
}
Packit ae235b
Packit ae235b
static GVariant *
Packit ae235b
g_emblemed_icon_serialize (GIcon *icon)
Packit ae235b
{
Packit ae235b
  GEmblemedIcon *emblemed_icon = G_EMBLEMED_ICON (icon);
Packit ae235b
  GVariantBuilder builder;
Packit ae235b
  GVariant *icon_data;
Packit ae235b
  GList *node;
Packit ae235b
Packit ae235b
  icon_data = g_icon_serialize (emblemed_icon->priv->icon);
Packit ae235b
  if (!icon_data)
Packit ae235b
    return NULL;
Packit ae235b
Packit ae235b
  g_variant_builder_init (&builder, G_VARIANT_TYPE ("(va(va{sv}))"));
Packit ae235b
Packit ae235b
  g_variant_builder_add (&builder, "v", icon_data);
Packit ae235b
  g_variant_unref (icon_data);
Packit ae235b
Packit ae235b
  g_variant_builder_open (&builder, G_VARIANT_TYPE ("a(va{sv})"));
Packit ae235b
  for (node = emblemed_icon->priv->emblems; node != NULL; node = node->next)
Packit ae235b
    {
Packit ae235b
      icon_data = g_icon_serialize (node->data);
Packit ae235b
      if (icon_data)
Packit ae235b
        {
Packit ae235b
          /* We know how emblems serialise, so do a tweak here to
Packit ae235b
           * reduce some of the variant wrapping and redundant storage
Packit ae235b
           * of 'emblem' over and again...
Packit ae235b
           */
Packit ae235b
          if (g_variant_is_of_type (icon_data, G_VARIANT_TYPE ("(sv)")))
Packit ae235b
            {
Packit ae235b
              const gchar *name;
Packit ae235b
              GVariant *content;
Packit ae235b
Packit ae235b
              g_variant_get (icon_data, "(&sv)", &name, &content);
Packit ae235b
Packit ae235b
              if (g_str_equal (name, "emblem") && g_variant_is_of_type (content, G_VARIANT_TYPE ("(va{sv})")))
Packit ae235b
                g_variant_builder_add (&builder, "@(va{sv})", content);
Packit ae235b
Packit ae235b
              g_variant_unref (content);
Packit ae235b
            }
Packit ae235b
Packit ae235b
          g_variant_unref (icon_data);
Packit ae235b
        }
Packit ae235b
    }
Packit ae235b
  g_variant_builder_close (&builder);
Packit ae235b
Packit ae235b
  return g_variant_new ("(sv)", "emblemed", g_variant_builder_end (&builder));
Packit ae235b
}
Packit ae235b
Packit ae235b
static void
Packit ae235b
g_emblemed_icon_icon_iface_init (GIconIface *iface)
Packit ae235b
{
Packit ae235b
  iface->hash = g_emblemed_icon_hash;
Packit ae235b
  iface->equal = g_emblemed_icon_equal;
Packit ae235b
  iface->to_tokens = g_emblemed_icon_to_tokens;
Packit ae235b
  iface->from_tokens = g_emblemed_icon_from_tokens;
Packit ae235b
  iface->serialize = g_emblemed_icon_serialize;
Packit ae235b
}