<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="EmpathyContact">
<refmeta>
<refentrytitle role="top_of_page" id="EmpathyContact.top_of_page">EmpathyContact</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBEMPATHY Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>EmpathyContact</refname>
<refpurpose></refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv id="EmpathyContact.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
                    <link linkend="EmpathyContact-struct">EmpathyContact</link>;
                    <link linkend="EmpathyAvatar">EmpathyAvatar</link>;
enum                <link linkend="EmpathyCapabilities">EmpathyCapabilities</link>;
enum                <link linkend="EmpathyContactReady">EmpathyContactReady</link>;
<link linkend="EmpathyContact">EmpathyContact</link>*     <link linkend="empathy-contact-new">empathy_contact_new</link>                 (<link linkend="McAccount">McAccount</link> *account);
<link linkend="EmpathyContact">EmpathyContact</link>*     <link linkend="empathy-contact-new-full">empathy_contact_new_full</link>            (<link linkend="McAccount">McAccount</link> *account,
                                                         const <link linkend="gchar">gchar</link> *id,
                                                         const <link linkend="gchar">gchar</link> *name);
const <link linkend="gchar">gchar</link>*        <link linkend="empathy-contact-get-id">empathy_contact_get_id</link>              (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="void">void</link>                <link linkend="empathy-contact-set-id">empathy_contact_set_id</link>              (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         const <link linkend="gchar">gchar</link> *id);
const <link linkend="gchar">gchar</link>*        <link linkend="empathy-contact-get-name">empathy_contact_get_name</link>            (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="void">void</link>                <link linkend="empathy-contact-set-name">empathy_contact_set_name</link>            (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         const <link linkend="gchar">gchar</link> *name);
<link linkend="EmpathyAvatar">EmpathyAvatar</link>*      <link linkend="empathy-contact-get-avatar">empathy_contact_get_avatar</link>          (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="void">void</link>                <link linkend="empathy-contact-set-avatar">empathy_contact_set_avatar</link>          (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="EmpathyAvatar">EmpathyAvatar</link> *avatar);
<link linkend="McAccount">McAccount</link>*          <link linkend="empathy-contact-get-account">empathy_contact_get_account</link>         (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="void">void</link>                <link linkend="empathy-contact-set-account">empathy_contact_set_account</link>         (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="McAccount">McAccount</link> *account);
<link linkend="McPresence">McPresence</link>          <link linkend="empathy-contact-get-presence">empathy_contact_get_presence</link>        (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="void">void</link>                <link linkend="empathy-contact-set-presence">empathy_contact_set_presence</link>        (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="McPresence">McPresence</link> presence);
const <link linkend="gchar">gchar</link>*        <link linkend="empathy-contact-get-presence-message">empathy_contact_get_presence_message</link>
                                                        (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="void">void</link>                <link linkend="empathy-contact-set-presence-message">empathy_contact_set_presence_message</link>
                                                        (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         const <link linkend="gchar">gchar</link> *message);
<link linkend="guint">guint</link>               <link linkend="empathy-contact-get-handle">empathy_contact_get_handle</link>          (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="void">void</link>                <link linkend="empathy-contact-set-handle">empathy_contact_set_handle</link>          (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="guint">guint</link> handle);
<link linkend="EmpathyCapabilities">EmpathyCapabilities</link> <link linkend="empathy-contact-get-capabilities">empathy_contact_get_capabilities</link>    (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="void">void</link>                <link linkend="empathy-contact-set-capabilities">empathy_contact_set_capabilities</link>    (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="EmpathyCapabilities">EmpathyCapabilities</link> capabilities);
<link linkend="EmpathyContactReady">EmpathyContactReady</link> <link linkend="empathy-contact-get-ready">empathy_contact_get_ready</link>           (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="gboolean">gboolean</link>            <link linkend="empathy-contact-is-user">empathy_contact_is_user</link>             (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="void">void</link>                <link linkend="empathy-contact-set-is-user">empathy_contact_set_is_user</link>         (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="gboolean">gboolean</link> is_user);
<link linkend="gboolean">gboolean</link>            <link linkend="empathy-contact-is-online">empathy_contact_is_online</link>           (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
const <link linkend="gchar">gchar</link>*        <link linkend="empathy-contact-get-status">empathy_contact_get_status</link>          (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="gboolean">gboolean</link>            <link linkend="empathy-contact-can-voip">empathy_contact_can_voip</link>            (<link linkend="EmpathyContact">EmpathyContact</link> *contact);
<link linkend="gboolean">gboolean</link>            <link linkend="empathy-contact-equal">empathy_contact_equal</link>               (<link linkend="gconstpointer">gconstpointer</link> v1,
                                                         <link linkend="gconstpointer">gconstpointer</link> v2);
<link linkend="guint">guint</link>               <link linkend="empathy-contact-hash">empathy_contact_hash</link>                (<link linkend="gconstpointer">gconstpointer</link> key);
<link linkend="void">void</link>                <link linkend="empathy-contact-run-until-ready">empathy_contact_run_until_ready</link>     (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="EmpathyContactReady">EmpathyContactReady</link> ready,
                                                         <link linkend="GMainLoop">GMainLoop</link> **loop);
<link linkend="void">void</link>                <link linkend="empathy-contact-load-avatar-data">empathy_contact_load_avatar_data</link>    (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         const <link linkend="guchar">guchar</link> *data,
                                                         const <link linkend="gsize">gsize</link> len,
                                                         const <link linkend="gchar">gchar</link> *format,
                                                         const <link linkend="gchar">gchar</link> *token);
<link linkend="gboolean">gboolean</link>            <link linkend="empathy-contact-load-avatar-cache">empathy_contact_load_avatar_cache</link>   (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         const <link linkend="gchar">gchar</link> *token);
#define             <link linkend="EMPATHY-TYPE-AVATAR:CAPS">EMPATHY_TYPE_AVATAR</link>
<link linkend="GType">GType</link>               <link linkend="empathy-avatar-get-type">empathy_avatar_get_type</link>             (void);
<link linkend="EmpathyAvatar">EmpathyAvatar</link>*      <link linkend="empathy-avatar-new">empathy_avatar_new</link>                  (<link linkend="guchar">guchar</link> *data,
                                                         <link linkend="gsize">gsize</link> len,
                                                         <link linkend="gchar">gchar</link> *format,
                                                         <link linkend="gchar">gchar</link> *token);
<link linkend="EmpathyAvatar">EmpathyAvatar</link>*      <link linkend="empathy-avatar-ref">empathy_avatar_ref</link>                  (<link linkend="EmpathyAvatar">EmpathyAvatar</link> *avatar);
<link linkend="void">void</link>                <link linkend="empathy-avatar-unref">empathy_avatar_unref</link>                (<link linkend="EmpathyAvatar">EmpathyAvatar</link> *avatar);
<link linkend="gboolean">gboolean</link>            <link linkend="empathy-avatar-save-to-file">empathy_avatar_save_to_file</link>         (<link linkend="EmpathyAvatar">EmpathyAvatar</link> *avatar,
                                                         const <link linkend="gchar">gchar</link> *filename,
                                                         <link linkend="GError">GError</link> **error);
</synopsis>
</refsynopsisdiv>

<refsect1 id="EmpathyContact.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----EmpathyContact
</synopsis>

</refsect1>





<refsect1 id="EmpathyContact.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="EmpathyContact--account">account</link>&quot;                  <link linkend="McAccount">McAccount</link>*            : Read / Write
  &quot;<link linkend="EmpathyContact--avatar">avatar</link>&quot;                   <link linkend="EmpathyAvatar">EmpathyAvatar</link>*        : Read / Write
  &quot;<link linkend="EmpathyContact--capabilities">capabilities</link>&quot;             <link linkend="EmpathyCapabilities">EmpathyCapabilities</link>   : Read / Write / Construct
  &quot;<link linkend="EmpathyContact--handle">handle</link>&quot;                   <link linkend="guint">guint</link>                 : Read / Write
  &quot;<link linkend="EmpathyContact--id">id</link>&quot;                       <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="EmpathyContact--is-user">is-user</link>&quot;                  <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="EmpathyContact--name">name</link>&quot;                     <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="EmpathyContact--presence">presence</link>&quot;                 <link linkend="guint">guint</link>                 : Read / Write
  &quot;<link linkend="EmpathyContact--presence-message">presence-message</link>&quot;         <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="EmpathyContact--ready">ready</link>&quot;                    <link linkend="EmpathyContactReady">EmpathyContactReady</link>   : Read
</synopsis>
</refsect1>



<refsect1 id="EmpathyContact.description" role="desc">
<title role="desc.title">Description</title>
<para>

</para>
</refsect1>

<refsect1 id="EmpathyContact.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="EmpathyContact-struct" role="struct">
<title>EmpathyContact</title>
<indexterm zone="EmpathyContact-struct"><primary>EmpathyContact</primary></indexterm><programlisting>typedef struct _EmpathyContact EmpathyContact;</programlisting>
<para>

</para></refsect2>
<refsect2 id="EmpathyAvatar" role="struct">
<title>EmpathyAvatar</title>
<indexterm zone="EmpathyAvatar"><primary>EmpathyAvatar</primary></indexterm><programlisting>typedef struct {
  guchar *data;
  gsize len;
  gchar *format;
  gchar *token;
  guint refcount;
} EmpathyAvatar;
</programlisting>
<para>

</para></refsect2>
<refsect2 id="EmpathyCapabilities" role="enum">
<title>enum EmpathyCapabilities</title>
<indexterm zone="EmpathyCapabilities"><primary>EmpathyCapabilities</primary></indexterm><programlisting>typedef enum {
  EMPATHY_CAPABILITIES_NONE = 0,
  EMPATHY_CAPABILITIES_AUDIO = 1 &lt;&lt; 0,
  EMPATHY_CAPABILITIES_VIDEO = 1 &lt;&lt; 1,
  EMPATHY_CAPABILITIES_UNKNOWN = 1 &lt;&lt; 7
} EmpathyCapabilities;
</programlisting>
<para>

</para></refsect2>
<refsect2 id="EmpathyContactReady" role="enum">
<title>enum EmpathyContactReady</title>
<indexterm zone="EmpathyContactReady"><primary>EmpathyContactReady</primary></indexterm><programlisting>typedef enum {
  EMPATHY_CONTACT_READY_NONE = 0,
  EMPATHY_CONTACT_READY_ID = 1 &lt;&lt; 0,
  EMPATHY_CONTACT_READY_HANDLE = 1 &lt;&lt; 1,
  EMPATHY_CONTACT_READY_NAME = 1 &lt;&lt; 2,
  EMPATHY_CONTACT_READY_ALL = (1 &lt;&lt; 3) - 1,
} EmpathyContactReady;
</programlisting>
<para>

</para></refsect2>
<refsect2 id="empathy-contact-new" role="function">
<title>empathy_contact_new ()</title>
<indexterm zone="empathy-contact-new"><primary>empathy_contact_new</primary></indexterm><programlisting><link linkend="EmpathyContact">EmpathyContact</link>*     empathy_contact_new                 (<link linkend="McAccount">McAccount</link> *account);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>account</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-new-full" role="function">
<title>empathy_contact_new_full ()</title>
<indexterm zone="empathy-contact-new-full"><primary>empathy_contact_new_full</primary></indexterm><programlisting><link linkend="EmpathyContact">EmpathyContact</link>*     empathy_contact_new_full            (<link linkend="McAccount">McAccount</link> *account,
                                                         const <link linkend="gchar">gchar</link> *id,
                                                         const <link linkend="gchar">gchar</link> *name);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>account</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>id</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-get-id" role="function">
<title>empathy_contact_get_id ()</title>
<indexterm zone="empathy-contact-get-id"><primary>empathy_contact_get_id</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>*        empathy_contact_get_id              (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-set-id" role="function">
<title>empathy_contact_set_id ()</title>
<indexterm zone="empathy-contact-set-id"><primary>empathy_contact_set_id</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_set_id              (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         const <link linkend="gchar">gchar</link> *id);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>id</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-get-name" role="function">
<title>empathy_contact_get_name ()</title>
<indexterm zone="empathy-contact-get-name"><primary>empathy_contact_get_name</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>*        empathy_contact_get_name            (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-set-name" role="function">
<title>empathy_contact_set_name ()</title>
<indexterm zone="empathy-contact-set-name"><primary>empathy_contact_set_name</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_set_name            (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         const <link linkend="gchar">gchar</link> *name);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-get-avatar" role="function">
<title>empathy_contact_get_avatar ()</title>
<indexterm zone="empathy-contact-get-avatar"><primary>empathy_contact_get_avatar</primary></indexterm><programlisting><link linkend="EmpathyAvatar">EmpathyAvatar</link>*      empathy_contact_get_avatar          (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-set-avatar" role="function">
<title>empathy_contact_set_avatar ()</title>
<indexterm zone="empathy-contact-set-avatar"><primary>empathy_contact_set_avatar</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_set_avatar          (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="EmpathyAvatar">EmpathyAvatar</link> *avatar);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>avatar</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-get-account" role="function">
<title>empathy_contact_get_account ()</title>
<indexterm zone="empathy-contact-get-account"><primary>empathy_contact_get_account</primary></indexterm><programlisting><link linkend="McAccount">McAccount</link>*          empathy_contact_get_account         (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-set-account" role="function">
<title>empathy_contact_set_account ()</title>
<indexterm zone="empathy-contact-set-account"><primary>empathy_contact_set_account</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_set_account         (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="McAccount">McAccount</link> *account);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>account</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-get-presence" role="function">
<title>empathy_contact_get_presence ()</title>
<indexterm zone="empathy-contact-get-presence"><primary>empathy_contact_get_presence</primary></indexterm><programlisting><link linkend="McPresence">McPresence</link>          empathy_contact_get_presence        (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-set-presence" role="function">
<title>empathy_contact_set_presence ()</title>
<indexterm zone="empathy-contact-set-presence"><primary>empathy_contact_set_presence</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_set_presence        (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="McPresence">McPresence</link> presence);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>presence</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-get-presence-message" role="function">
<title>empathy_contact_get_presence_message ()</title>
<indexterm zone="empathy-contact-get-presence-message"><primary>empathy_contact_get_presence_message</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>*        empathy_contact_get_presence_message
                                                        (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-set-presence-message" role="function">
<title>empathy_contact_set_presence_message ()</title>
<indexterm zone="empathy-contact-set-presence-message"><primary>empathy_contact_set_presence_message</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_set_presence_message
                                                        (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         const <link linkend="gchar">gchar</link> *message);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-get-handle" role="function">
<title>empathy_contact_get_handle ()</title>
<indexterm zone="empathy-contact-get-handle"><primary>empathy_contact_get_handle</primary></indexterm><programlisting><link linkend="guint">guint</link>               empathy_contact_get_handle          (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-set-handle" role="function">
<title>empathy_contact_set_handle ()</title>
<indexterm zone="empathy-contact-set-handle"><primary>empathy_contact_set_handle</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_set_handle          (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="guint">guint</link> handle);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>handle</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-get-capabilities" role="function">
<title>empathy_contact_get_capabilities ()</title>
<indexterm zone="empathy-contact-get-capabilities"><primary>empathy_contact_get_capabilities</primary></indexterm><programlisting><link linkend="EmpathyCapabilities">EmpathyCapabilities</link> empathy_contact_get_capabilities    (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-set-capabilities" role="function">
<title>empathy_contact_set_capabilities ()</title>
<indexterm zone="empathy-contact-set-capabilities"><primary>empathy_contact_set_capabilities</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_set_capabilities    (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="EmpathyCapabilities">EmpathyCapabilities</link> capabilities);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>capabilities</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-get-ready" role="function">
<title>empathy_contact_get_ready ()</title>
<indexterm zone="empathy-contact-get-ready"><primary>empathy_contact_get_ready</primary></indexterm><programlisting><link linkend="EmpathyContactReady">EmpathyContactReady</link> empathy_contact_get_ready           (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-is-user" role="function">
<title>empathy_contact_is_user ()</title>
<indexterm zone="empathy-contact-is-user"><primary>empathy_contact_is_user</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            empathy_contact_is_user             (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-set-is-user" role="function">
<title>empathy_contact_set_is_user ()</title>
<indexterm zone="empathy-contact-set-is-user"><primary>empathy_contact_set_is_user</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_set_is_user         (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="gboolean">gboolean</link> is_user);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>is_user</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-is-online" role="function">
<title>empathy_contact_is_online ()</title>
<indexterm zone="empathy-contact-is-online"><primary>empathy_contact_is_online</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            empathy_contact_is_online           (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-get-status" role="function">
<title>empathy_contact_get_status ()</title>
<indexterm zone="empathy-contact-get-status"><primary>empathy_contact_get_status</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>*        empathy_contact_get_status          (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-can-voip" role="function">
<title>empathy_contact_can_voip ()</title>
<indexterm zone="empathy-contact-can-voip"><primary>empathy_contact_can_voip</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            empathy_contact_can_voip            (<link linkend="EmpathyContact">EmpathyContact</link> *contact);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-equal" role="function">
<title>empathy_contact_equal ()</title>
<indexterm zone="empathy-contact-equal"><primary>empathy_contact_equal</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            empathy_contact_equal               (<link linkend="gconstpointer">gconstpointer</link> v1,
                                                         <link linkend="gconstpointer">gconstpointer</link> v2);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>v1</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>v2</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-hash" role="function">
<title>empathy_contact_hash ()</title>
<indexterm zone="empathy-contact-hash"><primary>empathy_contact_hash</primary></indexterm><programlisting><link linkend="guint">guint</link>               empathy_contact_hash                (<link linkend="gconstpointer">gconstpointer</link> key);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>key</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-run-until-ready" role="function">
<title>empathy_contact_run_until_ready ()</title>
<indexterm zone="empathy-contact-run-until-ready"><primary>empathy_contact_run_until_ready</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_run_until_ready     (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         <link linkend="EmpathyContactReady">EmpathyContactReady</link> ready,
                                                         <link linkend="GMainLoop">GMainLoop</link> **loop);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ready</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>loop</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-load-avatar-data" role="function">
<title>empathy_contact_load_avatar_data ()</title>
<indexterm zone="empathy-contact-load-avatar-data"><primary>empathy_contact_load_avatar_data</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_contact_load_avatar_data    (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         const <link linkend="guchar">guchar</link> *data,
                                                         const <link linkend="gsize">gsize</link> len,
                                                         const <link linkend="gchar">gchar</link> *format,
                                                         const <link linkend="gchar">gchar</link> *token);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>len</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>format</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>token</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-contact-load-avatar-cache" role="function">
<title>empathy_contact_load_avatar_cache ()</title>
<indexterm zone="empathy-contact-load-avatar-cache"><primary>empathy_contact_load_avatar_cache</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            empathy_contact_load_avatar_cache   (<link linkend="EmpathyContact">EmpathyContact</link> *contact,
                                                         const <link linkend="gchar">gchar</link> *token);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>contact</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>token</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="EMPATHY-TYPE-AVATAR:CAPS" role="macro">
<title>EMPATHY_TYPE_AVATAR</title>
<indexterm zone="EMPATHY-TYPE-AVATAR:CAPS"><primary>EMPATHY_TYPE_AVATAR</primary></indexterm><programlisting>#define EMPATHY_TYPE_AVATAR (empathy_avatar_get_type ())
</programlisting>
<para>

</para></refsect2>
<refsect2 id="empathy-avatar-get-type" role="function">
<title>empathy_avatar_get_type ()</title>
<indexterm zone="empathy-avatar-get-type"><primary>empathy_avatar_get_type</primary></indexterm><programlisting><link linkend="GType">GType</link>               empathy_avatar_get_type             (void);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-avatar-new" role="function">
<title>empathy_avatar_new ()</title>
<indexterm zone="empathy-avatar-new"><primary>empathy_avatar_new</primary></indexterm><programlisting><link linkend="EmpathyAvatar">EmpathyAvatar</link>*      empathy_avatar_new                  (<link linkend="guchar">guchar</link> *data,
                                                         <link linkend="gsize">gsize</link> len,
                                                         <link linkend="gchar">gchar</link> *format,
                                                         <link linkend="gchar">gchar</link> *token);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>len</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>format</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>token</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-avatar-ref" role="function">
<title>empathy_avatar_ref ()</title>
<indexterm zone="empathy-avatar-ref"><primary>empathy_avatar_ref</primary></indexterm><programlisting><link linkend="EmpathyAvatar">EmpathyAvatar</link>*      empathy_avatar_ref                  (<link linkend="EmpathyAvatar">EmpathyAvatar</link> *avatar);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>avatar</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-avatar-unref" role="function">
<title>empathy_avatar_unref ()</title>
<indexterm zone="empathy-avatar-unref"><primary>empathy_avatar_unref</primary></indexterm><programlisting><link linkend="void">void</link>                empathy_avatar_unref                (<link linkend="EmpathyAvatar">EmpathyAvatar</link> *avatar);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>avatar</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="empathy-avatar-save-to-file" role="function">
<title>empathy_avatar_save_to_file ()</title>
<indexterm zone="empathy-avatar-save-to-file"><primary>empathy_avatar_save_to_file</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            empathy_avatar_save_to_file         (<link linkend="EmpathyAvatar">EmpathyAvatar</link> *avatar,
                                                         const <link linkend="gchar">gchar</link> *filename,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Save the avatar to a file named filename</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>avatar</parameter>&nbsp;:</term>
<listitem><simpara> the avatar
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filename</parameter>&nbsp;:</term>
<listitem><simpara> name of a file to write avatar to
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
<listitem><simpara> return location for a GError, or NULL
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if an error occurred 
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="EmpathyContact.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="EmpathyContact--account"><title>The <literal>&quot;account&quot;</literal> property</title>
<indexterm zone="EmpathyContact--account"><primary>EmpathyContact:account</primary></indexterm><programlisting>  &quot;account&quot;                  <link linkend="McAccount">McAccount</link>*            : Read / Write</programlisting>
<para>The account associated with the contact.</para></refsect2>
<refsect2 id="EmpathyContact--avatar"><title>The <literal>&quot;avatar&quot;</literal> property</title>
<indexterm zone="EmpathyContact--avatar"><primary>EmpathyContact:avatar</primary></indexterm><programlisting>  &quot;avatar&quot;                   <link linkend="EmpathyAvatar">EmpathyAvatar</link>*        : Read / Write</programlisting>
<para>The avatar image.</para></refsect2>
<refsect2 id="EmpathyContact--capabilities"><title>The <literal>&quot;capabilities&quot;</literal> property</title>
<indexterm zone="EmpathyContact--capabilities"><primary>EmpathyContact:capabilities</primary></indexterm><programlisting>  &quot;capabilities&quot;             <link linkend="EmpathyCapabilities">EmpathyCapabilities</link>   : Read / Write / Construct</programlisting>
<para>Capabilities of the contact.</para><para>Default value: EMPATHY_CAPABILITIES_UNKNOWN</para>
</refsect2>
<refsect2 id="EmpathyContact--handle"><title>The <literal>&quot;handle&quot;</literal> property</title>
<indexterm zone="EmpathyContact--handle"><primary>EmpathyContact:handle</primary></indexterm><programlisting>  &quot;handle&quot;                   <link linkend="guint">guint</link>                 : Read / Write</programlisting>
<para>The handle of the contact.</para><para>Default value: 0</para>
</refsect2>
<refsect2 id="EmpathyContact--id"><title>The <literal>&quot;id&quot;</literal> property</title>
<indexterm zone="EmpathyContact--id"><primary>EmpathyContact:id</primary></indexterm><programlisting>  &quot;id&quot;                       <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>String identifying contact.</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="EmpathyContact--is-user"><title>The <literal>&quot;is-user&quot;</literal> property</title>
<indexterm zone="EmpathyContact--is-user"><primary>EmpathyContact:is-user</primary></indexterm><programlisting>  &quot;is-user&quot;                  <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Is contact the user.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="EmpathyContact--name"><title>The <literal>&quot;name&quot;</literal> property</title>
<indexterm zone="EmpathyContact--name"><primary>EmpathyContact:name</primary></indexterm><programlisting>  &quot;name&quot;                     <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>The name of the contact.</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="EmpathyContact--presence"><title>The <literal>&quot;presence&quot;</literal> property</title>
<indexterm zone="EmpathyContact--presence"><primary>EmpathyContact:presence</primary></indexterm><programlisting>  &quot;presence&quot;                 <link linkend="guint">guint</link>                 : Read / Write</programlisting>
<para>Presence of contact.</para><para>Allowed values: &lt;= 7</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="EmpathyContact--presence-message"><title>The <literal>&quot;presence-message&quot;</literal> property</title>
<indexterm zone="EmpathyContact--presence-message"><primary>EmpathyContact:presence-message</primary></indexterm><programlisting>  &quot;presence-message&quot;         <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>Presence message of contact.</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="EmpathyContact--ready"><title>The <literal>&quot;ready&quot;</literal> property</title>
<indexterm zone="EmpathyContact--ready"><primary>EmpathyContact:ready</primary></indexterm><programlisting>  &quot;ready&quot;                    <link linkend="EmpathyContactReady">EmpathyContactReady</link>   : Read</programlisting>
<para>Flags for ready properties.</para></refsect2>

</refsect1>




</refentry>
