buddyicon.h

Go to the documentation of this file.
00001 
00025 #ifndef _PURPLE_BUDDYICON_H_
00026 #define _PURPLE_BUDDYICON_H_
00027 
00028 typedef struct _PurpleBuddyIcon PurpleBuddyIcon;
00029 
00030 #include "account.h"
00031 #include "blist.h"
00032 #include "imgstore.h"
00033 #include "prpl.h"
00034 #include "util.h"
00035 
00036 #ifdef __cplusplus
00037 extern "C" {
00038 #endif
00039 
00040 
00041 /**************************************************************************/
00043 /**************************************************************************/
00060 PurpleBuddyIcon *purple_buddy_icon_new(PurpleAccount *account, const char *username,
00061                                        void *icon_data, size_t icon_len,
00062                                        const char *checksum);
00063 
00071 PurpleBuddyIcon *purple_buddy_icon_ref(PurpleBuddyIcon *icon);
00072 
00082 PurpleBuddyIcon *purple_buddy_icon_unref(PurpleBuddyIcon *icon);
00083 
00089 void purple_buddy_icon_update(PurpleBuddyIcon *icon);
00090 
00100 void
00101 purple_buddy_icon_set_data(PurpleBuddyIcon *icon, guchar *data,
00102                            size_t len, const char *checksum);
00103 
00111 PurpleAccount *purple_buddy_icon_get_account(const PurpleBuddyIcon *icon);
00112 
00120 const char *purple_buddy_icon_get_username(const PurpleBuddyIcon *icon);
00121 
00131 const char *purple_buddy_icon_get_checksum(const PurpleBuddyIcon *icon);
00132 
00142 gconstpointer purple_buddy_icon_get_data(const PurpleBuddyIcon *icon, size_t *len);
00143 
00152 const char *purple_buddy_icon_get_extension(const PurpleBuddyIcon *icon);
00153 
00168 char *purple_buddy_icon_get_full_path(PurpleBuddyIcon *icon);
00169 
00172 /**************************************************************************/
00174 /**************************************************************************/
00189 void
00190 purple_buddy_icons_set_for_user(PurpleAccount *account, const char *username,
00191                                 void *icon_data, size_t icon_len,
00192                                 const char *checksum);
00193 
00204 const char *
00205 purple_buddy_icons_get_checksum_for_user(PurpleBuddy *buddy);
00206 
00216 PurpleBuddyIcon *
00217 purple_buddy_icons_find(PurpleAccount *account, const char *username);
00218 
00226 gboolean
00227 purple_buddy_icons_has_custom_icon(PurpleContact *contact);
00228 
00243 PurpleStoredImage *
00244 purple_buddy_icons_find_account_icon(PurpleAccount *account);
00245 
00261 PurpleStoredImage *
00262 purple_buddy_icons_set_account_icon(PurpleAccount *account,
00263                                     guchar *icon_data, size_t icon_len);
00264 
00275 time_t
00276 purple_buddy_icons_get_account_icon_timestamp(PurpleAccount *account);
00277 
00292 PurpleStoredImage *
00293 purple_buddy_icons_find_custom_icon(PurpleContact *contact);
00294 
00310 PurpleStoredImage *
00311 purple_buddy_icons_set_custom_icon(PurpleContact *contact,
00312                                    guchar *icon_data, size_t icon_len);
00313 
00320 void purple_buddy_icons_set_caching(gboolean caching);
00321 
00330 gboolean purple_buddy_icons_is_caching(void);
00331 
00337 void purple_buddy_icons_set_cache_dir(const char *cache_dir);
00338 
00347 const char *purple_buddy_icons_get_cache_dir(void);
00348 
00354 void *purple_buddy_icons_get_handle(void);
00355 
00359 void purple_buddy_icons_init(void);
00360 
00364 void purple_buddy_icons_uninit(void);
00365 
00368 /**************************************************************************/
00370 /**************************************************************************/
00376 void purple_buddy_icon_get_scale_size(PurpleBuddyIconSpec *spec, int *width, int *height);
00377 
00380 #ifdef __cplusplus
00381 }
00382 #endif
00383 
00384 #endif /* _PURPLE_BUDDYICON_H_ */