<!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: >= 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>