# HG changeset patch
# User Etan Reisner <pidgin@unreliablesource.net>
# Date 1210818953 0
# Node ID 4044655e561569d5c23368d9592444cab1071ecf
# Parent  21636ef92dbb21e27b530bc3e56393749839aba6
Add a purple_buddy_icons_node_set_custom_icon_from_file convenience function.

diff -r 21636ef92dbb -r 4044655e5615 ChangeLog.API
--- a/ChangeLog.API	Tue May 13 04:40:04 2008 +0000
+++ b/ChangeLog.API	Thu May 15 02:35:53 2008 +0000
@@ -9,6 +9,7 @@
 		* purple_buddy_icons_node_has_custom_icon
 		* purple_buddy_icons_node_find_custom_icon
 		* purple_buddy_icons_node_set_custom_icon
+		* purple_buddy_icons_node_set_custom_icon_from_file
 
 		Deprecated:
 		* purple_blist_update_buddy_icon
diff -r 21636ef92dbb -r 4044655e5615 libpurple/buddyicon.c
--- a/libpurple/buddyicon.c	Tue May 13 04:40:04 2008 +0000
+++ b/libpurple/buddyicon.c	Thu May 15 02:35:53 2008 +0000
@@ -930,6 +930,28 @@
 	return img;
 }
 
+PurpleStoredImage *
+purple_buddy_icons_node_set_custom_icon_from_file(PurpleBlistNode *node,
+                                                  const gchar *filename)
+{
+	size_t len;
+	guchar *data;
+
+	g_return_val_if_fail(node != NULL, NULL);
+
+	if (!PURPLE_BLIST_NODE_IS_CONTACT(node) &&
+	    !PURPLE_BLIST_NODE_IS_CHAT(node) &&
+	    !PURPLE_BLIST_NODE_IS_GROUP(node)) {
+		return NULL;
+	}
+
+	if (!read_icon_file(filename, &data, &len)) {
+		return NULL;
+	}
+
+	return purple_buddy_icons_node_set_custom_icon(node, data, len);
+}
+
 #ifndef PURPLE_DISABLE_DEPRECATED
 gboolean
 purple_buddy_icons_has_custom_icon(PurpleContact *contact)
diff -r 21636ef92dbb -r 4044655e5615 libpurple/buddyicon.h
--- a/libpurple/buddyicon.h	Tue May 13 04:40:04 2008 +0000
+++ b/libpurple/buddyicon.h	Thu May 15 02:35:53 2008 +0000
@@ -314,6 +314,23 @@
 purple_buddy_icons_node_set_custom_icon(PurpleBlistNode *node,
                                         guchar *icon_data, size_t icon_len);
 
+/**
+ * Sets a custom buddy icon for a blist node.
+ *
+ * Convenience wrapper around purple_buddy_icons_node_set_custom_icon.
+ * @see purple_buddy_icons_node_set_custom_icon()
+ *
+ * @param node      The blist node for which to set a custom icon.
+ * @param filename  The path to the icon to set for the blist node.
+ *
+ * @return The icon that was set. The caller does NOT own a reference to this,
+ *         and must call purple_imgstore_ref() if it wants one.
+ * @since 2.5.0
+ */
+PurpleStoredImage *
+purple_buddy_icons_node_set_custom_icon_from_file(PurpleBlistNode *node,
+                                                  const gchar *filename);
+
 #ifndef PURPLE_DISABLE_DEPRECATED
 /**
  * PurpleContact version of purple_buddy_icons_node_has_custom_icon.