avatar.h

/* subdirectory name to save avatars in */
#define AVATAR_DIRECTORY "avatars"

/* data needed for each avatar in memory */
typedef struct avatar {
    uint8_t format; /* one of TOX_AVATAR_FORMAT */
    uint8_t hash[TOX_HASH_LENGTH]; /* tox_hash for the png data of this avatar */
    UTOX_NATIVE_IMAGE *image; /* converted avatar image to draw */
    uint16_t width, height; /* width and height of image (in pixels) */
}AVATAR;

/* whether user's avatar is set */
#define self_has_avatar() (self.avatar.format != TOX_AVATAR_FORMAT_NONE)
/* whether friend f's avatar is set, where f is a pointer to a friend struct */
#define friend_has_avatar(f) (f->avatar.format != TOX_AVATAR_FORMAT_NONE)

/* gets the avatar location on the disk and puts the result in dest.
 * id is the client id string for given client. To get the cid string from a cid, use cid_to_string
 *  returns the number of chars written
 */
int get_avatar_location(char_t *dest, const char_t *id);

/* loads an avatar from disk and puts the resulting png data in buffer given by dest.
 * id is the client id string for given client. To get the cid string from a cid, use cid_to_string
 *   id should be at least (TOX_PUBLIC_KEY_SIZE * 2) bytes long
 * if size_out is not NULL, load_avatar will store the length of the png data there
 *  on success: returns 1
 *  on failure: returns 0
 *  notes: dest should be at least TOX_AVATAR_MAX_DATA_LENGTH bytes long.
 */
int load_avatar(const char_t *id, uint8_t *dest, uint32_t *size_out);

/* saves avatar png data to disk
 * id is cid string(see load_avatar), and size is size of data
 *  on success: returns 1
 *  on failure: returns 0
 *  see also: load_avatar
 */
int save_avatar(const char_t *id, const uint8_t *data, uint32_t size);

/* deletes saved avatar data for given id
 *  on success: returns 1
 *  on failure: returns 0
 *  see also: load_avatar
 */
int delete_saved_avatar(const char_t *id);

/* loads avatar hash for given id from disk and copies it into dest
 *  on success: returns 1
 *  on failure: returns 0
 *  notes: dest should be at least TOX_HASH_LENGTH bytes long
 */
int load_avatar_hash(const char_t *id, uint8_t *dest);
/* saves avatar hash created by tox_hash for given id on disk
 *  on success: returns 1
 *  on failure: returns 0
 *  notes: hash should be TOX_HASH_LENGTH bytes long
 */
int save_avatar_hash(const char_t *id, const uint8_t *hash);
/* deletes saved avatar hash for given id
 *  on success: returns 1
 *  on failure: returns 0
 */
int delete_avatar_hash(const char_t *id);

/* converts png data given by data to a UTOX_NATIVE_IMAGE and uses that to populate the avatar struct
 *  avatar is pointer to an avatar struct to store result in. Remains unchanged if function fails.
 *  data is pointer to png data to convert
 *  size is size of data
 *  create_hash is whether to create a tox_hash of the given data and store it in avatar->hash
 *               (if 0, avatar->hash remains unchanged)
 *
 *  on success: returns 1
 *  on failure: returns 0
 *
 *  notes: fails if given size is larger than TOX_AVATAR_MAX_DATA_LENGTH or data is not valid PNG data
 */
int set_avatar(AVATAR *avatar, const uint8_t *data, uint32_t size, _Bool create_hash);

/* unsets an avatar by setting its format to TOX_AVATAR_FORMAT_NONE and
 * freeing its image */
void unset_avatar(AVATAR *avatar);

/* sets own avatar based on given png data and saves it to disk if successful
 *  data is png data to set avatar to
 *  size is size of data
 *
 *  on success: returns 1
 *  on failure: returns 0
 *
 *  notes: fails if size is too large or data is not a valid png file
 */
int self_set_and_save_avatar(const uint8_t *data, uint32_t size);

/* unsets own avatar and removes it from disk */
void self_remove_avatar();