comparison src/blist.h @ 9944:e4a27c9aec4c

[gaim-migrate @ 10838] with much rejoicing, and massive thanks to the efforts of Christian, and all who have helped him, I present to you the incomplete status rewrite! committer: Tailor Script <[e-mail]>

9943:f8e395a054e2

typedef struct _GaimContact GaimContact;
typedef struct _GaimBuddy GaimBuddy;

#include "account.h"
#include "buddyicon.h"

/**************************************************************************/
/* Enumerations                                                           */
/**************************************************************************/
typedef enum

	GAIM_BLIST_CHAT_NODE,
	GAIM_BLIST_OTHER_NODE

} GaimBlistNodeType;

#define GAIM_BLIST_NODE_IS_CHAT(n) ((n)->type == GAIM_BLIST_CHAT_NODE)
#define GAIM_BLIST_NODE_IS_BUDDY(n) ((n)->type == GAIM_BLIST_BUDDY_NODE)
#define GAIM_BLIST_NODE_IS_CONTACT(n) ((n)->type == GAIM_BLIST_CONTACT_NODE)
#define GAIM_BLIST_NODE_IS_GROUP(n) ((n)->type == GAIM_BLIST_GROUP_NODE)

typedef enum
{
	GAIM_BUDDY_SIGNING_OFF = -1,
	GAIM_BUDDY_OFFLINE = 0,
	GAIM_BUDDY_ONLINE,
	GAIM_BUDDY_SIGNING_ON

} GaimBuddyPresenceState;

#define GAIM_BUDDY_IS_ONLINE(b) ((b)->account->gc && \
		((b)->present == GAIM_BUDDY_ONLINE || \
		 (b)->present == GAIM_BUDDY_SIGNING_ON))

typedef enum
{
	GAIM_BLIST_NODE_FLAG_NO_SAVE = 1,	/**< node should not be saved with the buddy list */
} GaimBlistNodeFlags;

void gaim_blist_update_buddy_presence(GaimBuddy *buddy, gboolean online);

/**
 * Updates a buddy's signon time.
 *
 * @param buddy  The buddy whose idle time has changed.
 * @param signon The buddy's signon time since the dawn of the UNIX epoch.
 */
void gaim_blist_update_buddy_signon(GaimBuddy *buddy, time_t signon);

/**
 * Updates a buddy's idle time.
 *
 * @param buddy  The buddy whose idle time has changed
 * @param idle   The buddy's idle time in minutes.
 */
void gaim_blist_update_buddy_idle(GaimBuddy *buddy, int idle);


/**
 * Updates a buddy's warning level.
 *
 * @param buddy   The buddy whose warning level has changed.
 * @param warning The warning level as an int from 0 to 100.
 */
void gaim_blist_update_buddy_evil(GaimBuddy *buddy, int warning);

/**
 * Updates a buddy's icon.
 *
 * @param buddy  The buddy whose buddy icon has changed

 * @return The buddy's contact.
 */
GaimContact *gaim_buddy_get_contact(GaimBuddy *buddy);

/**
 * Adds a new buddy to the buddy list.
 *
 * The buddy will be inserted right after node or prepended to the
 * group if node is NULL.  If both are NULL, the buddy will be added to
 * the "Buddies" group.

 *
 * @return TRUE if there are any buddies from account in the contact, or FALSE otherwise.
 */
gboolean gaim_contact_on_account(GaimContact *contact, GaimAccount *account);


/**
 * Removes a buddy from the buddy list and frees the memory allocated to it.
 *
 * @param buddy   The buddy to be removed

9944:e4a27c9aec4c

typedef struct _GaimContact GaimContact;
typedef struct _GaimBuddy GaimBuddy;

#include "account.h"
#include "buddyicon.h"
#include "status.h"

/**************************************************************************/
/* Enumerations                                                           */
/**************************************************************************/
typedef enum

	GAIM_BLIST_CHAT_NODE,
	GAIM_BLIST_OTHER_NODE

} GaimBlistNodeType;

#define GAIM_BLIST_NODE_IS_CHAT(n)    ((n)->type == GAIM_BLIST_CHAT_NODE)
#define GAIM_BLIST_NODE_IS_BUDDY(n)   ((n)->type == GAIM_BLIST_BUDDY_NODE)
#define GAIM_BLIST_NODE_IS_CONTACT(n) ((n)->type == GAIM_BLIST_CONTACT_NODE)
#define GAIM_BLIST_NODE_IS_GROUP(n)   ((n)->type == GAIM_BLIST_GROUP_NODE)

typedef enum
{
	GAIM_BUDDY_SIGNING_OFF = -1,
	GAIM_BUDDY_OFFLINE = 0,
	GAIM_BUDDY_ONLINE,
	GAIM_BUDDY_SIGNING_ON

} GaimBuddyPresenceState;

#define GAIM_BUDDY_IS_ONLINE(b) \
	((b) != NULL && gaim_account_is_connected((b)->account) && \
	 gaim_presence_is_online(gaim_buddy_get_presence(b)))

typedef enum
{
	GAIM_BLIST_NODE_FLAG_NO_SAVE = 1,	/**< node should not be saved with the buddy list */
} GaimBlistNodeFlags;

void gaim_blist_update_buddy_presence(GaimBuddy *buddy, gboolean online);

/**
 * Updates a buddy's signon time.
 *
 * @param buddy  The buddy whose sign-on time has changed.
 * @param signon The buddy's signon time since the dawn of the UNIX epoch.
 */
void gaim_blist_update_buddy_signon(GaimBuddy *buddy, time_t signon);

/**
 * Updates a buddy's icon.
 *
 * @param buddy  The buddy whose buddy icon has changed

 * @return The buddy's contact.
 */
GaimContact *gaim_buddy_get_contact(GaimBuddy *buddy);

/**
 * Returns a buddy's presence.
 *
 * @param buddy The buddy.
 *
 * @return The buddy's presence.
 */
GaimPresence *gaim_buddy_get_presence(const GaimBuddy *buddy);

/**
 * Adds a new buddy to the buddy list.
 *
 * The buddy will be inserted right after node or prepended to the
 * group if node is NULL.  If both are NULL, the buddy will be added to
 * the "Buddies" group.

 *
 * @return TRUE if there are any buddies from account in the contact, or FALSE otherwise.
 */
gboolean gaim_contact_on_account(GaimContact *contact, GaimAccount *account);


/**
 * Re-calculates the priority buddy for a contact.
 *
 * @param contact The contact.
 */
void gaim_contact_compute_priority_buddy(GaimContact *contact);

/**
 * Removes a buddy from the buddy list and frees the memory allocated to it.
 *
 * @param buddy   The buddy to be removed