diff libpurple/buddyicon.h @ 23120:4044655e5615

Add a purple_buddy_icons_node_set_custom_icon_from_file convenience function.

--- 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.