1 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
3 * Copyright (C) 2004 Imendio AB
4 * Copyright (C) 2007-2008 Collabora Ltd.
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License as
8 * published by the Free Software Foundation; either version 2 of the
9 * License, or (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * General Public License for more details.
16 * You should have received a copy of the GNU General Public
17 * License along with this program; if not, write to the
18 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 * Boston, MA 02111-1307, USA.
21 * Authors: Mikael Hallendal <micke@imendio.com>
22 * Martyn Russell <martyn@imendio.com>
23 * Xavier Claessens <xclaesse@gmail.com>
26 #ifndef __EMPATHY_CONTACT_H__
27 #define __EMPATHY_CONTACT_H__
29 #include <glib-object.h>
31 #include <libmissioncontrol/mc-account.h>
32 #include <libmissioncontrol/mission-control.h>
36 #define EMPATHY_TYPE_CONTACT (empathy_contact_get_type ())
37 #define EMPATHY_CONTACT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), EMPATHY_TYPE_CONTACT, EmpathyContact))
38 #define EMPATHY_CONTACT_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), EMPATHY_TYPE_CONTACT, EmpathyContactClass))
39 #define EMPATHY_IS_CONTACT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), EMPATHY_TYPE_CONTACT))
40 #define EMPATHY_IS_CONTACT_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), EMPATHY_TYPE_CONTACT))
41 #define EMPATHY_CONTACT_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), EMPATHY_TYPE_CONTACT, EmpathyContactClass))
43 typedef struct _EmpathyContact EmpathyContact;
44 typedef struct _EmpathyContactClass EmpathyContactClass;
46 struct _EmpathyContact
52 struct _EmpathyContactClass
54 GObjectClass parent_class;
66 EMPATHY_CAPABILITIES_NONE = 0,
67 EMPATHY_CAPABILITIES_AUDIO = 1 << 0,
68 EMPATHY_CAPABILITIES_VIDEO = 1 << 1,
69 EMPATHY_CAPABILITIES_FT = 1 << 2,
70 EMPATHY_CAPABILITIES_UNKNOWN = 1 << 7
71 } EmpathyCapabilities;
74 EMPATHY_CONTACT_READY_NONE = 0,
75 EMPATHY_CONTACT_READY_ID = 1 << 0,
76 EMPATHY_CONTACT_READY_HANDLE = 1 << 1,
77 EMPATHY_CONTACT_READY_NAME = 1 << 2,
78 EMPATHY_CONTACT_READY_ALL = (1 << 3) - 1,
79 } EmpathyContactReady;
81 GType empathy_contact_get_type (void) G_GNUC_CONST;
82 EmpathyContact * empathy_contact_new (McAccount *account);
83 EmpathyContact * empathy_contact_new_full (McAccount *account, const gchar *id,
85 const gchar * empathy_contact_get_id (EmpathyContact *contact);
86 void empathy_contact_set_id (EmpathyContact *contact, const gchar *id);
87 const gchar * empathy_contact_get_name (EmpathyContact *contact);
88 void empathy_contact_set_name (EmpathyContact *contact, const gchar *name);
89 EmpathyAvatar * empathy_contact_get_avatar (EmpathyContact *contact);
90 void empathy_contact_set_avatar (EmpathyContact *contact,
91 EmpathyAvatar *avatar);
92 McAccount * empathy_contact_get_account (EmpathyContact *contact);
93 void empathy_contact_set_account (EmpathyContact *contact, McAccount *account);
94 McPresence empathy_contact_get_presence (EmpathyContact *contact);
95 void empathy_contact_set_presence (EmpathyContact *contact,
97 const gchar * empathy_contact_get_presence_message (EmpathyContact *contact);
98 void empathy_contact_set_presence_message (EmpathyContact *contact,
99 const gchar *message);
100 guint empathy_contact_get_handle (EmpathyContact *contact);
101 void empathy_contact_set_handle (EmpathyContact *contact, guint handle);
102 EmpathyCapabilities empathy_contact_get_capabilities (EmpathyContact *contact);
103 void empathy_contact_set_capabilities (EmpathyContact *contact,
104 EmpathyCapabilities capabilities);
105 EmpathyContactReady empathy_contact_get_ready (EmpathyContact *contact);
106 gboolean empathy_contact_is_user (EmpathyContact *contact);
107 void empathy_contact_set_is_user (EmpathyContact *contact,
109 gboolean empathy_contact_is_online (EmpathyContact *contact);
110 const gchar * empathy_contact_get_status (EmpathyContact *contact);
111 gboolean empathy_contact_can_voip (EmpathyContact *contact);
112 gboolean empathy_contact_can_send_files (EmpathyContact *contact);
113 gboolean empathy_contact_equal (gconstpointer v1, gconstpointer v2);
114 guint empathy_contact_hash (gconstpointer key);
116 typedef void (EmpathyContactReadyCb)
117 (EmpathyContact *contact, const GError *error, gpointer user_data,
118 GObject *weak_object);
119 void empathy_contact_call_when_ready (EmpathyContact *contact,
120 EmpathyContactReady ready, EmpathyContactReadyCb *callback, gpointer
121 user_data, GDestroyNotify destroy, GObject *weak_object);
123 void empathy_contact_run_until_ready (EmpathyContact *contact,
124 EmpathyContactReady ready, GMainLoop **loop);
126 void empathy_contact_load_avatar_data (EmpathyContact *contact,
127 const guchar *data, const gsize len, const gchar *format,
129 gboolean empathy_contact_load_avatar_cache (EmpathyContact *contact,
133 #define EMPATHY_TYPE_AVATAR (empathy_avatar_get_type ())
134 GType empathy_avatar_get_type (void) G_GNUC_CONST;
135 EmpathyAvatar * empathy_avatar_new (guchar *data,
139 EmpathyAvatar * empathy_avatar_ref (EmpathyAvatar *avatar);
140 void empathy_avatar_unref (EmpathyAvatar *avatar);
142 gboolean empathy_avatar_save_to_file (EmpathyAvatar *avatar,
143 const gchar *filename, GError **error);
147 #endif /* __EMPATHY_CONTACT_H__ */