1 /* -*- Mode: C; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2; -*- */
3 * Copyright (C) 2007-2009 Collabora Ltd.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 * Authors: Xavier Claessens <xclaesse@gmail.com>
26 #include <glib/gi18n-lib.h>
28 #include <telepathy-glib/util.h>
30 #include "empathy-contact.h"
31 #include "empathy-account-manager.h"
32 #include "empathy-utils.h"
33 #include "empathy-enum-types.h"
34 #include "empathy-marshal.h"
36 #define DEBUG_FLAG EMPATHY_DEBUG_CONTACT
37 #include "empathy-debug.h"
39 #define GET_PRIV(obj) EMPATHY_GET_PRIV (obj, EmpathyContact)
41 TpContact *tp_contact;
42 EmpathyAccount *account;
45 EmpathyAvatar *avatar;
46 TpConnectionPresenceType presence;
47 gchar *presence_message;
49 EmpathyCapabilities capabilities;
52 /* Location is composed of string keys and GValues.
53 * Example: a "city" key would have "Helsinki" as string GValue,
54 * a "latitude" would have 65.0 as double GValue.
59 static void contact_finalize (GObject *object);
60 static void contact_get_property (GObject *object, guint param_id,
61 GValue *value, GParamSpec *pspec);
62 static void contact_set_property (GObject *object, guint param_id,
63 const GValue *value, GParamSpec *pspec);
65 G_DEFINE_TYPE (EmpathyContact, empathy_contact, G_TYPE_OBJECT);
76 PROP_PRESENCE_MESSAGE,
88 static guint signals[LAST_SIGNAL];
91 tp_contact_notify_cb (TpContact *tp_contact,
95 EmpathyContactPriv *priv = GET_PRIV (contact);
97 /* Forward property notifications */
98 if (!tp_strdiff (param->name, "alias"))
99 g_object_notify (contact, "name");
100 else if (!tp_strdiff (param->name, "presence-type")) {
101 TpConnectionPresenceType presence;
103 presence = empathy_contact_get_presence (EMPATHY_CONTACT (contact));
104 g_signal_emit (contact, signals[PRESENCE_CHANGED], 0, presence,
106 priv->presence = presence;
107 g_object_notify (contact, "presence");
109 else if (!tp_strdiff (param->name, "presence-message"))
110 g_object_notify (contact, "presence-message");
111 else if (!tp_strdiff (param->name, "identifier"))
112 g_object_notify (contact, "id");
113 else if (!tp_strdiff (param->name, "handle"))
114 g_object_notify (contact, "handle");
118 contact_dispose (GObject *object)
120 EmpathyContactPriv *priv = GET_PRIV (object);
122 if (priv->tp_contact)
124 g_signal_handlers_disconnect_by_func (priv->tp_contact,
125 tp_contact_notify_cb, object);
126 g_object_unref (priv->tp_contact);
128 priv->tp_contact = NULL;
131 g_object_unref (priv->account);
132 priv->account = NULL;
134 G_OBJECT_CLASS (empathy_contact_parent_class)->dispose (object);
138 empathy_contact_class_init (EmpathyContactClass *class)
140 GObjectClass *object_class;
142 object_class = G_OBJECT_CLASS (class);
144 object_class->finalize = contact_finalize;
145 object_class->dispose = contact_dispose;
146 object_class->get_property = contact_get_property;
147 object_class->set_property = contact_set_property;
149 g_object_class_install_property (object_class,
151 g_param_spec_object ("tp-contact",
153 "The TpContact associated with the contact",
155 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
157 g_object_class_install_property (object_class,
159 g_param_spec_object ("account",
161 "The account associated with the contact",
162 EMPATHY_TYPE_ACCOUNT,
163 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
165 g_object_class_install_property (object_class,
167 g_param_spec_string ("id",
169 "String identifying contact",
171 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
173 g_object_class_install_property (object_class,
175 g_param_spec_string ("name",
177 "The name of the contact",
179 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
181 g_object_class_install_property (object_class,
183 g_param_spec_boxed ("avatar",
187 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
189 g_object_class_install_property (object_class,
191 g_param_spec_uint ("presence",
193 "Presence of contact",
194 TP_CONNECTION_PRESENCE_TYPE_UNSET,
195 NUM_TP_CONNECTION_PRESENCE_TYPES,
196 TP_CONNECTION_PRESENCE_TYPE_UNSET,
197 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
199 g_object_class_install_property (object_class,
200 PROP_PRESENCE_MESSAGE,
201 g_param_spec_string ("presence-message",
202 "Contact presence message",
203 "Presence message of contact",
205 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
207 g_object_class_install_property (object_class,
209 g_param_spec_uint ("handle",
211 "The handle of the contact",
215 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
217 g_object_class_install_property (object_class,
219 g_param_spec_flags ("capabilities",
220 "Contact Capabilities",
221 "Capabilities of the contact",
222 EMPATHY_TYPE_CAPABILITIES,
223 EMPATHY_CAPABILITIES_UNKNOWN,
224 G_PARAM_CONSTRUCT | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
226 g_object_class_install_property (object_class,
228 g_param_spec_boolean ("is-user",
230 "Is contact the user",
232 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
235 g_object_class_install_property (object_class,
237 g_param_spec_boxed ("location",
239 "Physical location of the contact",
241 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
243 signals[PRESENCE_CHANGED] =
244 g_signal_new ("presence-changed",
245 G_TYPE_FROM_CLASS (class),
249 _empathy_marshal_VOID__UINT_UINT,
254 g_type_class_add_private (object_class, sizeof (EmpathyContactPriv));
258 empathy_contact_init (EmpathyContact *contact)
260 EmpathyContactPriv *priv = G_TYPE_INSTANCE_GET_PRIVATE (contact,
261 EMPATHY_TYPE_CONTACT, EmpathyContactPriv);
263 contact->priv = priv;
265 priv->location = NULL;
269 contact_finalize (GObject *object)
271 EmpathyContactPriv *priv;
273 priv = GET_PRIV (object);
275 DEBUG ("finalize: %p", object);
279 g_free (priv->presence_message);
282 empathy_avatar_unref (priv->avatar);
284 if (priv->location != NULL)
285 g_hash_table_unref (priv->location);
287 G_OBJECT_CLASS (empathy_contact_parent_class)->finalize (object);
291 set_tp_contact (EmpathyContact *contact,
292 TpContact *tp_contact)
294 EmpathyContactPriv *priv = GET_PRIV (contact);
296 if (tp_contact == NULL)
299 g_assert (priv->tp_contact == NULL);
300 priv->tp_contact = g_object_ref (tp_contact);
301 priv->presence = empathy_contact_get_presence (contact);
303 g_signal_connect (priv->tp_contact, "notify",
304 G_CALLBACK (tp_contact_notify_cb), contact);
308 contact_get_property (GObject *object,
313 EmpathyContact *contact = EMPATHY_CONTACT (object);
317 case PROP_TP_CONTACT:
318 g_value_set_object (value, empathy_contact_get_tp_contact (contact));
321 g_value_set_object (value, empathy_contact_get_account (contact));
324 g_value_set_string (value, empathy_contact_get_id (contact));
327 g_value_set_string (value, empathy_contact_get_name (contact));
330 g_value_set_boxed (value, empathy_contact_get_avatar (contact));
333 g_value_set_uint (value, empathy_contact_get_presence (contact));
335 case PROP_PRESENCE_MESSAGE:
336 g_value_set_string (value, empathy_contact_get_presence_message (contact));
339 g_value_set_uint (value, empathy_contact_get_handle (contact));
341 case PROP_CAPABILITIES:
342 g_value_set_flags (value, empathy_contact_get_capabilities (contact));
345 g_value_set_boolean (value, empathy_contact_is_user (contact));
348 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
354 contact_set_property (GObject *object,
359 EmpathyContact *contact = EMPATHY_CONTACT (object);
360 EmpathyContactPriv *priv = GET_PRIV (object);
364 case PROP_TP_CONTACT:
365 set_tp_contact (contact, g_value_get_object (value));
368 g_assert (priv->account == NULL);
369 priv->account = g_value_dup_object (value);
372 empathy_contact_set_id (contact, g_value_get_string (value));
375 empathy_contact_set_name (contact, g_value_get_string (value));
378 empathy_contact_set_avatar (contact, g_value_get_boxed (value));
381 empathy_contact_set_presence (contact, g_value_get_uint (value));
383 case PROP_PRESENCE_MESSAGE:
384 empathy_contact_set_presence_message (contact, g_value_get_string (value));
387 empathy_contact_set_handle (contact, g_value_get_uint (value));
389 case PROP_CAPABILITIES:
390 empathy_contact_set_capabilities (contact, g_value_get_flags (value));
393 empathy_contact_set_is_user (contact, g_value_get_boolean (value));
396 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
402 empathy_contact_new (TpContact *tp_contact)
404 g_return_val_if_fail (TP_IS_CONTACT (tp_contact), NULL);
406 return g_object_new (EMPATHY_TYPE_CONTACT,
407 "tp-contact", tp_contact,
412 empathy_contact_new_for_log (EmpathyAccount *account,
417 g_return_val_if_fail (id != NULL, NULL);
418 g_assert (account != NULL);
420 return g_object_new (EMPATHY_TYPE_CONTACT,
429 empathy_contact_get_tp_contact (EmpathyContact *contact)
431 EmpathyContactPriv *priv;
433 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
435 priv = GET_PRIV (contact);
437 return priv->tp_contact;
441 empathy_contact_get_id (EmpathyContact *contact)
443 EmpathyContactPriv *priv;
445 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
447 priv = GET_PRIV (contact);
449 if (priv->tp_contact != NULL)
450 return tp_contact_get_identifier (priv->tp_contact);
456 empathy_contact_set_id (EmpathyContact *contact,
459 EmpathyContactPriv *priv;
461 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
462 g_return_if_fail (id != NULL);
464 priv = GET_PRIV (contact);
466 /* We temporally ref the contact because it could be destroyed
467 * during the signal emition */
468 g_object_ref (contact);
469 if (tp_strdiff (id, priv->id))
472 priv->id = g_strdup (id);
474 g_object_notify (G_OBJECT (contact), "id");
475 if (EMP_STR_EMPTY (priv->name))
476 g_object_notify (G_OBJECT (contact), "name");
479 g_object_unref (contact);
483 empathy_contact_get_name (EmpathyContact *contact)
485 EmpathyContactPriv *priv;
487 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
489 priv = GET_PRIV (contact);
491 if (priv->tp_contact != NULL)
492 return tp_contact_get_alias (priv->tp_contact);
494 if (EMP_STR_EMPTY (priv->name))
495 return empathy_contact_get_id (contact);
501 empathy_contact_set_name (EmpathyContact *contact,
504 EmpathyContactPriv *priv;
506 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
508 priv = GET_PRIV (contact);
510 g_object_ref (contact);
511 if (tp_strdiff (name, priv->name))
514 priv->name = g_strdup (name);
515 g_object_notify (G_OBJECT (contact), "name");
517 g_object_unref (contact);
521 empathy_contact_get_avatar (EmpathyContact *contact)
523 EmpathyContactPriv *priv;
525 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
527 priv = GET_PRIV (contact);
533 empathy_contact_set_avatar (EmpathyContact *contact,
534 EmpathyAvatar *avatar)
536 EmpathyContactPriv *priv;
538 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
540 priv = GET_PRIV (contact);
542 if (priv->avatar == avatar)
547 empathy_avatar_unref (priv->avatar);
552 priv->avatar = empathy_avatar_ref (avatar);
554 g_object_notify (G_OBJECT (contact), "avatar");
558 empathy_contact_get_account (EmpathyContact *contact)
560 EmpathyContactPriv *priv;
562 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
564 priv = GET_PRIV (contact);
566 if (priv->account == NULL && priv->tp_contact != NULL)
568 EmpathyAccountManager *manager;
569 TpConnection *connection;
571 /* FIXME: This assume the account manager already exists */
572 manager = empathy_account_manager_dup_singleton ();
573 connection = tp_contact_get_connection (priv->tp_contact);
574 priv->account = empathy_account_manager_get_account_for_connection (
575 manager, connection);
576 g_object_ref (priv->account);
577 g_object_unref (manager);
580 return priv->account;
584 empathy_contact_get_connection (EmpathyContact *contact)
586 EmpathyContactPriv *priv;
588 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
590 priv = GET_PRIV (contact);
592 if (priv->tp_contact != NULL)
593 return tp_contact_get_connection (priv->tp_contact);
598 TpConnectionPresenceType
599 empathy_contact_get_presence (EmpathyContact *contact)
601 EmpathyContactPriv *priv;
603 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact),
604 TP_CONNECTION_PRESENCE_TYPE_UNSET);
606 priv = GET_PRIV (contact);
608 if (priv->tp_contact != NULL)
609 return tp_contact_get_presence_type (priv->tp_contact);
611 return priv->presence;
615 empathy_contact_set_presence (EmpathyContact *contact,
616 TpConnectionPresenceType presence)
618 EmpathyContactPriv *priv;
619 TpConnectionPresenceType old_presence;
621 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
623 priv = GET_PRIV (contact);
625 if (presence == priv->presence)
628 old_presence = priv->presence;
629 priv->presence = presence;
631 g_signal_emit (contact, signals[PRESENCE_CHANGED], 0, presence, old_presence);
633 g_object_notify (G_OBJECT (contact), "presence");
637 empathy_contact_get_presence_message (EmpathyContact *contact)
639 EmpathyContactPriv *priv;
641 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
643 priv = GET_PRIV (contact);
645 if (priv->tp_contact != NULL)
646 return tp_contact_get_presence_message (priv->tp_contact);
648 return priv->presence_message;
652 empathy_contact_set_presence_message (EmpathyContact *contact,
653 const gchar *message)
655 EmpathyContactPriv *priv = GET_PRIV (contact);
657 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
659 if (!tp_strdiff (message, priv->presence_message))
662 g_free (priv->presence_message);
663 priv->presence_message = g_strdup (message);
665 g_object_notify (G_OBJECT (contact), "presence-message");
669 empathy_contact_get_handle (EmpathyContact *contact)
671 EmpathyContactPriv *priv;
673 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
675 priv = GET_PRIV (contact);
677 if (priv->tp_contact != NULL)
678 return tp_contact_get_handle (priv->tp_contact);
684 empathy_contact_set_handle (EmpathyContact *contact,
687 EmpathyContactPriv *priv;
689 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
691 priv = GET_PRIV (contact);
693 g_object_ref (contact);
694 if (handle != priv->handle)
696 priv->handle = handle;
697 g_object_notify (G_OBJECT (contact), "handle");
699 g_object_unref (contact);
703 empathy_contact_get_capabilities (EmpathyContact *contact)
705 EmpathyContactPriv *priv;
707 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
709 priv = GET_PRIV (contact);
711 return priv->capabilities;
715 empathy_contact_set_capabilities (EmpathyContact *contact,
716 EmpathyCapabilities capabilities)
718 EmpathyContactPriv *priv;
720 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
722 priv = GET_PRIV (contact);
724 if (priv->capabilities == capabilities)
727 priv->capabilities = capabilities;
729 g_object_notify (G_OBJECT (contact), "capabilities");
733 empathy_contact_is_user (EmpathyContact *contact)
735 EmpathyContactPriv *priv;
737 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
739 priv = GET_PRIV (contact);
741 return priv->is_user;
745 empathy_contact_set_is_user (EmpathyContact *contact,
748 EmpathyContactPriv *priv;
750 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
752 priv = GET_PRIV (contact);
754 if (priv->is_user == is_user)
757 priv->is_user = is_user;
759 g_object_notify (G_OBJECT (contact), "is-user");
763 empathy_contact_is_online (EmpathyContact *contact)
765 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
767 switch (empathy_contact_get_presence (contact))
769 case TP_CONNECTION_PRESENCE_TYPE_OFFLINE:
770 case TP_CONNECTION_PRESENCE_TYPE_UNKNOWN:
771 case TP_CONNECTION_PRESENCE_TYPE_ERROR:
779 empathy_contact_get_status (EmpathyContact *contact)
781 const gchar *message;
783 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), "");
785 message = empathy_contact_get_presence_message (contact);
786 if (!EMP_STR_EMPTY (message))
789 return empathy_presence_get_default_message (
790 empathy_contact_get_presence (contact));
794 empathy_contact_can_voip (EmpathyContact *contact)
796 EmpathyContactPriv *priv;
798 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
800 priv = GET_PRIV (contact);
802 return priv->capabilities & (EMPATHY_CAPABILITIES_AUDIO |
803 EMPATHY_CAPABILITIES_VIDEO);
807 empathy_contact_can_voip_audio (EmpathyContact *contact)
809 EmpathyContactPriv *priv;
811 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
813 priv = GET_PRIV (contact);
815 return priv->capabilities & EMPATHY_CAPABILITIES_AUDIO;
819 empathy_contact_can_voip_video (EmpathyContact *contact)
821 EmpathyContactPriv *priv;
823 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
825 priv = GET_PRIV (contact);
827 return priv->capabilities & EMPATHY_CAPABILITIES_VIDEO;
831 empathy_contact_can_send_files (EmpathyContact *contact)
833 EmpathyContactPriv *priv;
835 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
837 priv = GET_PRIV (contact);
839 return priv->capabilities & EMPATHY_CAPABILITIES_FT;
843 empathy_contact_can_use_stream_tube (EmpathyContact *contact)
845 EmpathyContactPriv *priv;
847 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
849 priv = GET_PRIV (contact);
851 return priv->capabilities & EMPATHY_CAPABILITIES_STREAM_TUBE;
855 contact_get_avatar_filename (EmpathyContact *contact,
858 EmpathyAccount *account;
861 gchar *token_escaped;
863 if (EMP_STR_EMPTY (empathy_contact_get_id (contact)))
866 token_escaped = tp_escape_as_identifier (token);
867 account = empathy_contact_get_account (contact);
869 avatar_path = g_build_filename (g_get_user_cache_dir (),
872 empathy_account_get_connection_manager (account),
873 empathy_account_get_protocol (account),
875 g_mkdir_with_parents (avatar_path, 0700);
877 avatar_file = g_build_filename (avatar_path, token_escaped, NULL);
879 g_free (token_escaped);
880 g_free (avatar_path);
886 empathy_contact_load_avatar_data (EmpathyContact *contact,
892 EmpathyAvatar *avatar;
894 GError *error = NULL;
896 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
897 g_return_if_fail (data != NULL);
898 g_return_if_fail (len > 0);
899 g_return_if_fail (format != NULL);
900 g_return_if_fail (!EMP_STR_EMPTY (token));
902 /* Load and set the avatar */
903 filename = contact_get_avatar_filename (contact, token);
904 avatar = empathy_avatar_new (g_memdup (data, len), len, g_strdup (format),
905 g_strdup (token), filename);
906 empathy_contact_set_avatar (contact, avatar);
907 empathy_avatar_unref (avatar);
909 /* Save to cache if not yet in it */
910 if (filename && !g_file_test (filename, G_FILE_TEST_EXISTS))
912 if (!empathy_avatar_save_to_file (avatar, filename, &error))
914 DEBUG ("Failed to save avatar in cache: %s",
915 error ? error->message : "No error given");
916 g_clear_error (&error);
919 DEBUG ("Avatar saved to %s", filename);
924 empathy_contact_load_avatar_cache (EmpathyContact *contact,
927 EmpathyAvatar *avatar = NULL;
931 GError *error = NULL;
933 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
934 g_return_val_if_fail (!EMP_STR_EMPTY (token), FALSE);
936 /* Load the avatar from file if it exists */
937 filename = contact_get_avatar_filename (contact, token);
938 if (filename && g_file_test (filename, G_FILE_TEST_EXISTS))
940 if (!g_file_get_contents (filename, &data, &len, &error))
942 DEBUG ("Failed to load avatar from cache: %s",
943 error ? error->message : "No error given");
944 g_clear_error (&error);
950 DEBUG ("Avatar loaded from %s", filename);
951 avatar = empathy_avatar_new (data, len, NULL, g_strdup (token), filename);
952 empathy_contact_set_avatar (contact, avatar);
953 empathy_avatar_unref (avatar);
962 empathy_avatar_get_type (void)
964 static GType type_id = 0;
968 type_id = g_boxed_type_register_static ("EmpathyAvatar",
969 (GBoxedCopyFunc) empathy_avatar_ref,
970 (GBoxedFreeFunc) empathy_avatar_unref);
977 * empathy_avatar_new:
978 * @data: the avatar data
979 * @len: the size of avatar data
980 * @format: the mime type of the avatar image
981 * @token: the token of the avatar
982 * @filename: the filename where the avatar is stored in cache
984 * Create a #EmpathyAvatar from the provided data. This function takes the
985 * ownership of @data, @format, @token and @filename.
987 * Returns: a new #EmpathyAvatar
990 empathy_avatar_new (guchar *data,
996 EmpathyAvatar *avatar;
998 avatar = g_slice_new0 (EmpathyAvatar);
1001 avatar->format = format;
1002 avatar->token = token;
1003 avatar->filename = filename;
1004 avatar->refcount = 1;
1010 empathy_avatar_unref (EmpathyAvatar *avatar)
1012 g_return_if_fail (avatar != NULL);
1015 if (avatar->refcount == 0)
1017 g_free (avatar->data);
1018 g_free (avatar->format);
1019 g_free (avatar->token);
1020 g_slice_free (EmpathyAvatar, avatar);
1025 empathy_avatar_ref (EmpathyAvatar *avatar)
1027 g_return_val_if_fail (avatar != NULL, NULL);
1035 * empathy_avatar_save_to_file:
1036 * @avatar: the avatar
1037 * @filename: name of a file to write avatar to
1038 * @error: return location for a GError, or NULL
1040 * Save the avatar to a file named filename
1042 * Returns: %TRUE on success, %FALSE if an error occurred
1045 empathy_avatar_save_to_file (EmpathyAvatar *self,
1046 const gchar *filename,
1049 return g_file_set_contents (filename, self->data, self->len, error);
1053 * empathy_contact_get_location:
1054 * @contact: an #EmpathyContact
1056 * Returns the user's location if available. The keys are defined in
1057 * empathy-location.h. If the contact doesn't have location
1058 * information, the GHashTable will be empthy. Use #g_hash_table_unref when
1059 * you are done with the #GHashTable.
1061 * It is composed of string keys and GValues. Keys are
1062 * defined in empathy-location.h such as #EMPATHY_LOCATION_COUNTRY.
1063 * Example: a "city" key would have "Helsinki" as string GValue,
1064 * a "latitude" would have 65.0 as double GValue.
1066 * Returns: a #GHashTable of location values
1069 empathy_contact_get_location (EmpathyContact *contact)
1071 EmpathyContactPriv *priv;
1073 g_return_val_if_fail (EMPATHY_CONTACT (contact), NULL);
1075 priv = GET_PRIV (contact);
1077 return priv->location;
1081 * empathy_contact_set_location:
1082 * @contact: an #EmpathyContact
1083 * @location: a #GHashTable of the location
1085 * Sets the user's location based on the location #GHashTable passed.
1086 * It is composed of string keys and GValues. Keys are
1087 * defined in empathy-location.h such as #EMPATHY_LOCATION_COUNTRY.
1088 * Example: a "city" key would have "Helsinki" as string GValue,
1089 * a "latitude" would have 65.0 as double GValue.
1092 empathy_contact_set_location (EmpathyContact *contact,
1093 GHashTable *location)
1095 EmpathyContactPriv *priv;
1097 g_return_if_fail (EMPATHY_CONTACT (contact));
1098 g_return_if_fail (location != NULL);
1100 priv = GET_PRIV (contact);
1102 if (priv->location != NULL)
1103 g_hash_table_unref (priv->location);
1105 priv->location = g_hash_table_ref (location);
1106 g_object_notify (G_OBJECT (contact), "location");
1110 * empathy_contact_equal:
1111 * @contact1: an #EmpathyContact
1112 * @contact2: an #EmpathyContact
1114 * Returns FALSE if one of the contacts is NULL but the other is not.
1115 * Otherwise returns TRUE if both pointer are equal or if they bith
1116 * refer to the same id.
1117 * It's only necessary to call this function if your contact objects
1118 * come from logs where contacts are created dynamically and comparing
1119 * pointers is not enough.
1122 empathy_contact_equal (gconstpointer contact1,
1123 gconstpointer contact2)
1130 if ((contact1 == NULL) != (contact2 == NULL)) {
1133 if (contact1 == contact2) {
1136 c1 = EMPATHY_CONTACT (contact1);
1137 c2 = EMPATHY_CONTACT (contact2);
1138 id1 = empathy_contact_get_id (c1);
1139 id2 = empathy_contact_get_id (c2);
1140 if (!tp_strdiff (id1, id2)) {