Blob Blame History Raw
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>ClutterMedia: Clutter Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Clutter Reference Manual">
<link rel="up" href="ch01.html" title="Abstract classes and interfaces">
<link rel="prev" href="ClutterChildMeta.html" title="ClutterChildMeta">
<link rel="next" href="ClutterLayoutManager.html" title="ClutterLayoutManager">
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#ClutterMedia.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#ClutterMedia.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_prerequisites">  <span class="dim">|</span> 
                  <a href="#ClutterMedia.prerequisites" class="shortcut">Prerequisites</a></span><span id="nav_properties">  <span class="dim">|</span> 
                  <a href="#ClutterMedia.properties" class="shortcut">Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
                  <a href="#ClutterMedia.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="ClutterChildMeta.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="ClutterLayoutManager.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="ClutterMedia"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="ClutterMedia.top_of_page"></a>ClutterMedia</span></h2>
<p>ClutterMedia — An interface for controlling playback of media data</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="ClutterMedia.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-set-uri" title="clutter_media_set_uri ()">clutter_media_set_uri</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-get-uri" title="clutter_media_get_uri ()">clutter_media_get_uri</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-set-playing" title="clutter_media_set_playing ()">clutter_media_set_playing</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-get-playing" title="clutter_media_get_playing ()">clutter_media_get_playing</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-set-progress" title="clutter_media_set_progress ()">clutter_media_set_progress</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gdouble</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-get-progress" title="clutter_media_get_progress ()">clutter_media_get_progress</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-set-subtitle-uri" title="clutter_media_set_subtitle_uri ()">clutter_media_set_subtitle_uri</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-get-subtitle-uri" title="clutter_media_get_subtitle_uri ()">clutter_media_get_subtitle_uri</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-set-subtitle-font-name" title="clutter_media_set_subtitle_font_name ()">clutter_media_set_subtitle_font_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-get-subtitle-font-name" title="clutter_media_get_subtitle_font_name ()">clutter_media_get_subtitle_font_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-set-audio-volume" title="clutter_media_set_audio_volume ()">clutter_media_set_audio_volume</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gdouble</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-get-audio-volume" title="clutter_media_get_audio_volume ()">clutter_media_get_audio_volume</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-get-can-seek" title="clutter_media_get_can_seek ()">clutter_media_get_can_seek</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gdouble</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-get-buffer-fill" title="clutter_media_get_buffer_fill ()">clutter_media_get_buffer_fill</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gdouble</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-get-duration" title="clutter_media_get_duration ()">clutter_media_get_duration</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="ClutterMedia.html#clutter-media-set-filename" title="clutter_media_set_filename ()">clutter_media_set_filename</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="ClutterMedia.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><span class="type">gdouble</span></td>
<td class="property_name"><a class="link" href="ClutterMedia.html#ClutterMedia--audio-volume" title="The “audio-volume” property">audio-volume</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gdouble</span></td>
<td class="property_name"><a class="link" href="ClutterMedia.html#ClutterMedia--buffer-fill" title="The “buffer-fill” property">buffer-fill</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="ClutterMedia.html#ClutterMedia--can-seek" title="The “can-seek” property">can-seek</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gdouble</span></td>
<td class="property_name"><a class="link" href="ClutterMedia.html#ClutterMedia--duration" title="The “duration” property">duration</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="ClutterMedia.html#ClutterMedia--playing" title="The “playing” property">playing</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gdouble</span></td>
<td class="property_name"><a class="link" href="ClutterMedia.html#ClutterMedia--progress" title="The “progress” property">progress</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="ClutterMedia.html#ClutterMedia--subtitle-font-name" title="The “subtitle-font-name” property">subtitle-font-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="ClutterMedia.html#ClutterMedia--subtitle-uri" title="The “subtitle-uri” property">subtitle-uri</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="ClutterMedia.html#ClutterMedia--uri" title="The “uri” property">uri</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="ClutterMedia.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signals_return">
<col width="300px" class="signals_name">
<col width="200px" class="signals_flags">
</colgroup>
<tbody>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="ClutterMedia.html#ClutterMedia-eos" title="The “eos” signal">eos</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="ClutterMedia.html#ClutterMedia-error" title="The “error” signal">error</a></td>
<td class="signal_flags">Run Last</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="ClutterMedia.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="ClutterMedia.html#ClutterMedia-struct" title="ClutterMedia">ClutterMedia</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="ClutterMedia.html#ClutterMediaIface" title="struct ClutterMediaIface">ClutterMediaIface</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="ClutterMedia.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    <a href="/home/ebassi/gnome/install/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
    <span class="lineart">╰──</span> ClutterMedia
</pre>
</div>
<div class="refsect1">
<a name="ClutterMedia.prerequisites"></a><h2>Prerequisites</h2>
<p>
ClutterMedia requires
 GObject.</p>
</div>
<div class="refsect1">
<a name="ClutterMedia.description"></a><h2>Description</h2>
<p><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> is an interface for controlling playback of media sources.</p>
<p>Clutter core does not provide an implementation of this interface, but
other integration libraries like Clutter-GStreamer implement it to offer
a uniform API for applications.</p>
<p><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> is available since Clutter 0.2</p>
<p><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> is deprecated since Clutter 1.12. Use the Clutter-GStreamer
API directly instead.</p>
</div>
<div class="refsect1">
<a name="ClutterMedia.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="clutter-media-set-uri"></a><h3>clutter_media_set_uri ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_media_set_uri (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>,
                       <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_set_uri</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Sets the URI of <em class="parameter"><code>media</code></em>
 to <em class="parameter"><code>uri</code></em>
.</p>
<div class="refsect3">
<a name="clutter-media-set-uri.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>uri</p></td>
<td class="parameter_description"><p>the URI of the media stream</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-get-uri"></a><h3>clutter_media_get_uri ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
clutter_media_get_uri (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_get_uri</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Retrieves the URI from <em class="parameter"><code>media</code></em>
.</p>
<div class="refsect3">
<a name="clutter-media-get-uri.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-media-get-uri.returns"></a><h4>Returns</h4>
<p> the URI of the media stream. Use <code class="function">g_free()</code>
to free the returned string</p>
</div>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-set-playing"></a><h3>clutter_media_set_playing ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_media_set_playing (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>,
                           <em class="parameter"><code><span class="type">gboolean</span> playing</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_set_playing</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Starts or stops playing of <em class="parameter"><code>media</code></em>
. </p>
<p>The implementation might be asynchronous, so the way to know whether
the actual playing state of the <em class="parameter"><code>media</code></em>
 is to use the <span class="type">“notify”</span>
signal on the <a class="link" href="ClutterMedia.html#ClutterMedia--playing" title="The “playing” property"><span class="type">“playing”</span></a> property and then retrieve the
current state with <a class="link" href="ClutterMedia.html#clutter-media-get-playing" title="clutter_media_get_playing ()"><code class="function">clutter_media_get_playing()</code></a>. ClutterGstVideoTexture
in clutter-gst is an example of such an asynchronous implementation.</p>
<div class="refsect3">
<a name="clutter-media-set-playing.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>playing</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> to start playing</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-get-playing"></a><h3>clutter_media_get_playing ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
clutter_media_get_playing (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_get_playing</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Retrieves the playing status of <em class="parameter"><code>media</code></em>
.</p>
<div class="refsect3">
<a name="clutter-media-get-playing.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>A <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-media-get-playing.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if playing, <code class="literal">FALSE</code> if stopped.</p>
</div>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-set-progress"></a><h3>clutter_media_set_progress ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_media_set_progress (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>,
                            <em class="parameter"><code><span class="type">gdouble</span> progress</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_set_progress</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Sets the playback progress of <em class="parameter"><code>media</code></em>
. The <em class="parameter"><code>progress</code></em>
 is
a normalized value between 0.0 (begin) and 1.0 (end).</p>
<div class="refsect3">
<a name="clutter-media-set-progress.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>progress</p></td>
<td class="parameter_description"><p>the progress of the playback, between 0.0 and 1.0</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-get-progress"></a><h3>clutter_media_get_progress ()</h3>
<pre class="programlisting"><span class="returnvalue">gdouble</span>
clutter_media_get_progress (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_get_progress</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Retrieves the playback progress of <em class="parameter"><code>media</code></em>
.</p>
<div class="refsect3">
<a name="clutter-media-get-progress.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-media-get-progress.returns"></a><h4>Returns</h4>
<p> the playback progress, between 0.0 and 1.0</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-set-subtitle-uri"></a><h3>clutter_media_set_subtitle_uri ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_media_set_subtitle_uri (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>,
                                <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_set_subtitle_uri</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Sets the location of a subtitle file to display while playing <em class="parameter"><code>media</code></em>
.</p>
<div class="refsect3">
<a name="clutter-media-set-subtitle-uri.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>uri</p></td>
<td class="parameter_description"><p>the URI of a subtitle file</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix08.html#api-index-1.2">1.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-get-subtitle-uri"></a><h3>clutter_media_get_subtitle_uri ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
clutter_media_get_subtitle_uri (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_get_subtitle_uri</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Retrieves the URI of the subtitle file in use.</p>
<div class="refsect3">
<a name="clutter-media-get-subtitle-uri.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-media-get-subtitle-uri.returns"></a><h4>Returns</h4>
<p> the URI of the subtitle file. Use <code class="function">g_free()</code>
to free the returned string</p>
</div>
<p class="since">Since: <a class="link" href="ix08.html#api-index-1.2">1.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-set-subtitle-font-name"></a><h3>clutter_media_set_subtitle_font_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_media_set_subtitle_font_name (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>,
                                      <em class="parameter"><code>const <span class="type">char</span> *font_name</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_set_subtitle_font_name</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Sets the font used by the subtitle renderer. The <em class="parameter"><code>font_name</code></em>
 string must be
either <code class="literal">NULL</code>, which means that the default font name of the underlying
implementation will be used; or must follow the grammar recognized by
<code class="function">pango_font_description_from_string()</code> like:</p>
<div class="informalexample">
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
    <tbody>
      <tr>
        <td class="listing_lines" align="right"><pre>1</pre></td>
        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="ClutterMedia.html#clutter-media-set-subtitle-font-name">clutter_media_set_subtitle_font_name</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">media</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Sans 24pt"</span><span class="symbol">);</span></pre></td>
      </tr>
    </tbody>
  </table>
</div>

<p></p>
<div class="refsect3">
<a name="clutter-media-set-subtitle-font-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>font_name</p></td>
<td class="parameter_description"><p>a font name, or <code class="literal">NULL</code> to set the default font name</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix08.html#api-index-1.2">1.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-get-subtitle-font-name"></a><h3>clutter_media_get_subtitle_font_name ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
clutter_media_get_subtitle_font_name (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_get_subtitle_font_name</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Retrieves the font name currently used.</p>
<div class="refsect3">
<a name="clutter-media-get-subtitle-font-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-media-get-subtitle-font-name.returns"></a><h4>Returns</h4>
<p> a string containing the font name. Use <code class="function">g_free()</code>
to free the returned string</p>
</div>
<p class="since">Since: <a class="link" href="ix08.html#api-index-1.2">1.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-set-audio-volume"></a><h3>clutter_media_set_audio_volume ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_media_set_audio_volume (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>,
                                <em class="parameter"><code><span class="type">gdouble</span> volume</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_set_audio_volume</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Sets the playback volume of <em class="parameter"><code>media</code></em>
 to <em class="parameter"><code>volume</code></em>
.</p>
<div class="refsect3">
<a name="clutter-media-set-audio-volume.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>volume</p></td>
<td class="parameter_description"><p>the volume as a double between 0.0 and 1.0</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-get-audio-volume"></a><h3>clutter_media_get_audio_volume ()</h3>
<pre class="programlisting"><span class="returnvalue">gdouble</span>
clutter_media_get_audio_volume (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_get_audio_volume</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Retrieves the playback volume of <em class="parameter"><code>media</code></em>
.</p>
<div class="refsect3">
<a name="clutter-media-get-audio-volume.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-media-get-audio-volume.returns"></a><h4>Returns</h4>
<p> The playback volume between 0.0 and 1.0</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-get-can-seek"></a><h3>clutter_media_get_can_seek ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
clutter_media_get_can_seek (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_get_can_seek</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Retrieves whether <em class="parameter"><code>media</code></em>
 is seekable or not.</p>
<div class="refsect3">
<a name="clutter-media-get-can-seek.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-media-get-can-seek.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>media</code></em>
can seek, <code class="literal">FALSE</code> otherwise.</p>
</div>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-get-buffer-fill"></a><h3>clutter_media_get_buffer_fill ()</h3>
<pre class="programlisting"><span class="returnvalue">gdouble</span>
clutter_media_get_buffer_fill (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_get_buffer_fill</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Retrieves the amount of the stream that is buffered.</p>
<div class="refsect3">
<a name="clutter-media-get-buffer-fill.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-media-get-buffer-fill.returns"></a><h4>Returns</h4>
<p> the fill level, between 0.0 and 1.0</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-get-duration"></a><h3>clutter_media_get_duration ()</h3>
<pre class="programlisting"><span class="returnvalue">gdouble</span>
clutter_media_get_duration (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_get_duration</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Retrieves the duration of the media stream that <em class="parameter"><code>media</code></em>
 represents.</p>
<div class="refsect3">
<a name="clutter-media-get-duration.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-media-get-duration.returns"></a><h4>Returns</h4>
<p> the duration of the media stream, in seconds</p>
</div>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-media-set-filename"></a><h3>clutter_media_set_filename ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
clutter_media_set_filename (<em class="parameter"><code><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media</code></em>,
                            <em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>);</pre>
<div class="warning"><p><code class="literal">clutter_media_set_filename</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Sets the source of <em class="parameter"><code>media</code></em>
 using a file path.</p>
<div class="refsect3">
<a name="clutter-media-set-filename.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>filename</p></td>
<td class="parameter_description"><p>A filename</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
</div>
<div class="refsect1">
<a name="ClutterMedia.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="ClutterMedia-struct"></a><h3>ClutterMedia</h3>
<pre class="programlisting">typedef struct _ClutterMedia ClutterMedia;</pre>
<p><a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> is an opaque structure whose members cannot be directly
accessed</p>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterMediaIface"></a><h3>struct ClutterMediaIface</h3>
<pre class="programlisting">struct ClutterMediaIface {
  /* signals */
  void (* eos)   (ClutterMedia *media);
  void (* error) (ClutterMedia *media,
		  const GError *error);
};
</pre>
<p>Interface vtable for <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> implementations</p>
<div class="refsect3">
<a name="ClutterMediaIface.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="ClutterMediaIface.eos"></a>eos</code></em> ()</p></td>
<td class="struct_member_description"><p>handler for the <a class="link" href="ClutterMedia.html#ClutterMedia-eos" title="The “eos” signal"><span class="type">“eos”</span></a> signal</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="ClutterMediaIface.error"></a>error</code></em> ()</p></td>
<td class="struct_member_description"><p>handler for the <a class="link" href="ClutterMedia.html#ClutterMedia-error" title="The “error” signal"><span class="type">“error”</span></a> signal</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
</div>
<div class="refsect1">
<a name="ClutterMedia.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="ClutterMedia--audio-volume"></a><h3>The <code class="literal">“audio-volume”</code> property</h3>
<pre class="programlisting">  “audio-volume”             <span class="type">gdouble</span></pre>
<p>The volume of the audio, as a normalized value between
0.0 and 1.0.</p>
<div class="warning"><p><code class="literal">ClutterMedia:audio-volume</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read / Write</p>
<p>Allowed values: [0,1]</p>
<p>Default value: 0.5</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterMedia--buffer-fill"></a><h3>The <code class="literal">“buffer-fill”</code> property</h3>
<pre class="programlisting">  “buffer-fill”              <span class="type">gdouble</span></pre>
<p>The fill level of the buffer for the current stream,
as a value between 0.0 and 1.0.</p>
<div class="warning"><p><code class="literal">ClutterMedia:buffer-fill</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read</p>
<p>Allowed values: [0,1]</p>
<p>Default value: 0</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterMedia--can-seek"></a><h3>The <code class="literal">“can-seek”</code> property</h3>
<pre class="programlisting">  “can-seek”                 <span class="type">gboolean</span></pre>
<p>Whether the current stream is seekable.</p>
<div class="warning"><p><code class="literal">ClutterMedia:can-seek</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read</p>
<p>Default value: FALSE</p>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterMedia--duration"></a><h3>The <code class="literal">“duration”</code> property</h3>
<pre class="programlisting">  “duration”                 <span class="type">gdouble</span></pre>
<p>The duration of the current stream, in seconds</p>
<div class="warning"><p><code class="literal">ClutterMedia:duration</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterMedia--playing"></a><h3>The <code class="literal">“playing”</code> property</h3>
<pre class="programlisting">  “playing”                  <span class="type">gboolean</span></pre>
<p>Whether the <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> actor is playing.</p>
<div class="warning"><p><code class="literal">ClutterMedia:playing</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterMedia--progress"></a><h3>The <code class="literal">“progress”</code> property</h3>
<pre class="programlisting">  “progress”                 <span class="type">gdouble</span></pre>
<p>The current progress of the playback, as a normalized
value between 0.0 and 1.0.</p>
<div class="warning"><p><code class="literal">ClutterMedia:progress</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read / Write</p>
<p>Allowed values: [0,1]</p>
<p>Default value: 0</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterMedia--subtitle-font-name"></a><h3>The <code class="literal">“subtitle-font-name”</code> property</h3>
<pre class="programlisting">  “subtitle-font-name”       <span class="type">gchar</span> *</pre>
<p>The font used to display subtitles. The font description has to
follow the same grammar as the one recognized by
<code class="function">pango_font_description_from_string()</code>.</p>
<div class="warning"><p><code class="literal">ClutterMedia:subtitle-font-name</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix08.html#api-index-1.2">1.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterMedia--subtitle-uri"></a><h3>The <code class="literal">“subtitle-uri”</code> property</h3>
<pre class="programlisting">  “subtitle-uri”             <span class="type">gchar</span> *</pre>
<p>The location of a subtitle file, expressed as a valid URI.</p>
<div class="warning"><p><code class="literal">ClutterMedia:subtitle-uri</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix08.html#api-index-1.2">1.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterMedia--uri"></a><h3>The <code class="literal">“uri”</code> property</h3>
<pre class="programlisting">  “uri”                      <span class="type">gchar</span> *</pre>
<p>The location of a media file, expressed as a valid URI.</p>
<div class="warning"><p><code class="literal">ClutterMedia:uri</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
</div>
<div class="refsect1">
<a name="ClutterMedia.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="ClutterMedia-eos"></a><h3>The <code class="literal">“eos”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media,
               <span class="type">gpointer</span>      user_data)</pre>
<p>The ::eos signal is emitted each time the media stream ends.</p>
<div class="warning"><p><code class="literal">ClutterMedia::eos</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<div class="refsect3">
<a name="ClutterMedia-eos.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>the <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> instance that received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterMedia-error"></a><h3>The <code class="literal">“error”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> *media,
               <span class="type">GError</span>       *error,
               <span class="type">gpointer</span>      user_data)</pre>
<p>The ::error signal is emitted each time an error occurred.</p>
<div class="warning"><p><code class="literal">ClutterMedia::error</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p></div>
<div class="refsect3">
<a name="ClutterMedia-error.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>media</p></td>
<td class="parameter_description"><p>the <a class="link" href="ClutterMedia.html" title="ClutterMedia"><span class="type">ClutterMedia</span></a> instance that received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>the <span class="type">GError</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: <a class="link" href="ix03.html#api-index-0.2">0.2</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
</body>
</html>