GIcon: add g_icon_[de]serialize()

Add support for serialising a GIcon to a GVariant and deserialising the
result back to a GIcon.

This solves a number of problems suffered by the existing to_string()
API, primarily these:

 - not forcing the icon to be a utf8 string means that we can
   efficiently encode a PNG (ie: just give the array of bytes)

 - there is no need to ensure that proper types are loaded before using
   the deserialisation interface.  'Foreign' icon types will probably
   emit a serialised format the deserialises to a GBytesIcon.

We additionally clearly document what is required for being a consumer
or implementation of #GIcon.

Further patches will be required to GdkPixbuf and GVfsIcon to bring
their implementations in line with the new rules (essentially: introduce
implementations of the new serialize() API).

https://bugzilla.gnome.org/show_bug.cgi?id=688820
This commit is contained in:
Ryan Lortie
2013-04-20 18:50:21 -04:00
parent 9cc222c0bf
commit c16f914b40
9 changed files with 439 additions and 8 deletions

View File

@@ -512,6 +512,14 @@ g_themed_icon_from_tokens (gchar **tokens,
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)
{
@@ -519,4 +527,5 @@ g_themed_icon_icon_iface_init (GIconIface *iface)
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;
}