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 
00035 #ifdef __cplusplus
00036 extern "C" {
00037 #endif
00038 
00039 
00040 /**************************************************************************/
00042 /**************************************************************************/
00059 PurpleBuddyIcon *purple_buddy_icon_new(PurpleAccount *account, const char *username,
00060                                        void *icon_data, size_t icon_len,
00061                                        const char *checksum);
00062 
00070 PurpleBuddyIcon *purple_buddy_icon_ref(PurpleBuddyIcon *icon);
00071 
00081 PurpleBuddyIcon *purple_buddy_icon_unref(PurpleBuddyIcon *icon);
00082 
00088 void purple_buddy_icon_update(PurpleBuddyIcon *icon);
00089 
00099 void
00100 purple_buddy_icon_set_data(PurpleBuddyIcon *icon, guchar *data,
00101                            size_t len, const char *checksum);
00102 
00110 PurpleAccount *purple_buddy_icon_get_account(const PurpleBuddyIcon *icon);
00111 
00119 const char *purple_buddy_icon_get_username(const PurpleBuddyIcon *icon);
00120 
00130 const char *purple_buddy_icon_get_checksum(const PurpleBuddyIcon *icon);
00131 
00141 gconstpointer purple_buddy_icon_get_data(const PurpleBuddyIcon *icon, size_t *len);
00142 
00151 const char *purple_buddy_icon_get_extension(const PurpleBuddyIcon *icon);
00152 
00167 char *purple_buddy_icon_get_full_path(PurpleBuddyIcon *icon);
00168 
00171 /**************************************************************************/
00173 /**************************************************************************/
00188 void
00189 purple_buddy_icons_set_for_user(PurpleAccount *account, const char *username,
00190                                 void *icon_data, size_t icon_len,
00191                                 const char *checksum);
00192 
00203 const char *
00204 purple_buddy_icons_get_checksum_for_user(PurpleBuddy *buddy);
00205 
00215 PurpleBuddyIcon *
00216 purple_buddy_icons_find(PurpleAccount *account, const char *username);
00217 
00225 gboolean
00226 purple_buddy_icons_has_custom_icon(PurpleContact *contact);
00227 
00242 PurpleStoredImage *
00243 purple_buddy_icons_find_account_icon(PurpleAccount *account);
00244 
00260 PurpleStoredImage *
00261 purple_buddy_icons_set_account_icon(PurpleAccount *account,
00262                                     guchar *icon_data, size_t icon_len);
00263 
00274 time_t
00275 purple_buddy_icons_get_account_icon_timestamp(PurpleAccount *account);
00276 
00291 PurpleStoredImage *
00292 purple_buddy_icons_find_custom_icon(PurpleContact *contact);
00293 
00309 PurpleStoredImage *
00310 purple_buddy_icons_set_custom_icon(PurpleContact *contact,
00311                                    guchar *icon_data, size_t icon_len);
00312 
00319 void purple_buddy_icons_set_caching(gboolean caching);
00320 
00329 gboolean purple_buddy_icons_is_caching(void);
00330 
00336 void purple_buddy_icons_set_cache_dir(const char *cache_dir);
00337 
00346 const char *purple_buddy_icons_get_cache_dir(void);
00347 
00353 void *purple_buddy_icons_get_handle(void);
00354 
00358 void purple_buddy_icons_init(void);
00359 
00363 void purple_buddy_icons_uninit(void);
00364 
00367 /**************************************************************************/
00369 /**************************************************************************/
00375 void purple_buddy_icon_get_scale_size(PurpleBuddyIconSpec *spec, int *width, int *height);
00376 
00379 #ifdef __cplusplus
00380 }
00381 #endif
00382 
00383 #endif /* _PURPLE_BUDDYICON_H_ */