comparison src/conversation.h @ 6982:083d1e4a9c78

[gaim-migrate @ 7538] This is Mr. Holland's Opus. And by Mr. Holland I mean Robot101. He rewrote the coreish IM image support so that the binary data gets ripped out in the prpl and put in an imgstore instead of just being passed in the same huge as char string as the actual message. This is good because it's prpl agnostic, or something. It also means we don't have a silly length of "-1" with pretty much every send or receive IM function. It should be crash free, bug free, and memleak free, but additional testing is always a good thing. If you like good stuff then you'll love this patch. But don't take my word for it--ba dun dunt! committer: Tailor Script <[e-mail]>

6981:abd3c684da31

/**
 * Flags applicable to a message. Most will have send, recv or system.
 */
typedef enum
{
	GAIM_MESSAGE_SEND      = 0x0001, /**< Outgoing message.     */
	GAIM_MESSAGE_RECV      = 0x0002, /**< Incoming message.     */
	GAIM_MESSAGE_SYSTEM    = 0x0004, /**< System message.       */
	GAIM_MESSAGE_AUTO_RESP = 0x0008, /**< Auto response.        */
	GAIM_MESSAGE_COLORIZE  = 0x0010, /**< Colorize nicks.       */
	GAIM_MESSAGE_NICK      = 0x0020, /**< Contains your nick.   */
	GAIM_MESSAGE_NO_LOG    = 0x0040, /**< Do not log.           */
	GAIM_MESSAGE_WHISPER   = 0x0080  /**< Whispered message.    */

} GaimMessageFlags;

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

{
	void (*destroy_conversation)(GaimConversation *conv);
	void (*write_chat)(GaimConversation *conv, const char *who,
					   const char *message, GaimMessageFlags flags, time_t mtime);
	void (*write_im)(GaimConversation *conv, const char *who,
					 const char *message, size_t len, GaimMessageFlags flags, time_t mtime);
	void (*write_conv)(GaimConversation *conv, const char *who,
					   const char *message, size_t length, GaimMessageFlags flags,
					   time_t mtime);

	void (*chat_add_user)(GaimConversation *conv, const char *user);
	void (*chat_add_users)(GaimConversation *conv, GList *users);
	void (*chat_rename_user)(GaimConversation *conv,

 * the conversation window."
 *
 * @param conv    The conversation.
 * @param who     The user who sent the message.
 * @param message The message.
 * @param length  The length of the message.
 * @param flags   The message flags.
 * @param mtime   The time the message was sent.
 *
 * @see gaim_im_write()
 * @see gaim_chat_write()
 */
void gaim_conversation_write(GaimConversation *conv, const char *who,
							 const char *message, size_t length, GaimMessageFlags flags,
							 time_t mtime);

/**
 * Updates the progress bar on a conversation window
 * (if one exists in the UI).

 */
void gaim_im_update_typing(GaimIm *im);

/**
 * Writes to an IM.
 *
 * The @a len parameter is used for writing binary data, such as an
 * image. If @c message is text, specify -1 for @a len.
 *
 * @param im      The IM.
 * @param who     The user who sent the message.
 * @param message The message to write.
 * @param len     The length of the message, or -1 to specify the length
 *                of @a message.
 * @param flags   The message flags.
 * @param mtime   The time the message was sent.
 */
void gaim_im_write(GaimIm *im, const char *who,
				   const char *message, size_t len, GaimMessageFlags flags, time_t mtime);

/**
 * Sends a message to this IM conversation.
 *
 * @param im      The IM.

6982:083d1e4a9c78

/**
 * Flags applicable to a message. Most will have send, recv or system.
 */
typedef enum
{
	GAIM_MESSAGE_SEND      = 0x0001, /**< Outgoing message.        */
	GAIM_MESSAGE_RECV      = 0x0002, /**< Incoming message.        */
	GAIM_MESSAGE_SYSTEM    = 0x0004, /**< System message.          */
	GAIM_MESSAGE_AUTO_RESP = 0x0008, /**< Auto response.           */
	GAIM_MESSAGE_COLORIZE  = 0x0010, /**< Colorize nicks.          */
	GAIM_MESSAGE_NICK      = 0x0020, /**< Contains your nick.      */
	GAIM_MESSAGE_NO_LOG    = 0x0040, /**< Do not log.              */
	GAIM_MESSAGE_WHISPER   = 0x0080, /**< Whispered message.       */
	GAIM_MESSAGE_IMAGES    = 0x0100  /**< Message contains images. */
} GaimMessageFlags;

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

{
	void (*destroy_conversation)(GaimConversation *conv);
	void (*write_chat)(GaimConversation *conv, const char *who,
					   const char *message, GaimMessageFlags flags, time_t mtime);
	void (*write_im)(GaimConversation *conv, const char *who,
					 const char *message, GaimMessageFlags flags, time_t mtime);
	void (*write_conv)(GaimConversation *conv, const char *who,
					   const char *message, GaimMessageFlags flags,
					   time_t mtime);

	void (*chat_add_user)(GaimConversation *conv, const char *user);
	void (*chat_add_users)(GaimConversation *conv, GList *users);
	void (*chat_rename_user)(GaimConversation *conv,

 * the conversation window."
 *
 * @param conv    The conversation.
 * @param who     The user who sent the message.
 * @param message The message.
 * @param flags   The message flags.
 * @param mtime   The time the message was sent.
 *
 * @see gaim_im_write()
 * @see gaim_chat_write()
 */
void gaim_conversation_write(GaimConversation *conv, const char *who,
							 const char *message, GaimMessageFlags flags,
							 time_t mtime);

/**
 * Updates the progress bar on a conversation window
 * (if one exists in the UI).

 */
void gaim_im_update_typing(GaimIm *im);

/**
 * Writes to an IM.
 *
 * @param im      The IM.
 * @param who     The user who sent the message.
 * @param message The message to write.
 * @param flags   The message flags.
 * @param mtime   The time the message was sent.
 */
void gaim_im_write(GaimIm *im, const char *who,
				   const char *message, GaimMessageFlags flags, time_t mtime);

/**
 * Sends a message to this IM conversation.
 *
 * @param im      The IM.