<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkMediaStream">
<refmeta>
<refentrytitle role="top_of_page" id="GtkMediaStream.top_of_page">GtkMediaStream</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkMediaStream</refname>
<refpurpose>Display media in GTK</refpurpose>
</refnamediv>

<refsect1 id="GtkMediaStream.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-is-prepared">gtk_media_stream_is_prepared</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="GError"><returnvalue>GError</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-media-stream-get-error">gtk_media_stream_get_error</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-has-audio">gtk_media_stream_has_audio</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-has-video">gtk_media_stream_has_video</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-play">gtk_media_stream_play</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-pause">gtk_media_stream_pause</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-get-playing">gtk_media_stream_get_playing</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-set-playing">gtk_media_stream_set_playing</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-get-ended">gtk_media_stream_get_ended</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint64"><returnvalue>gint64</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-get-timestamp">gtk_media_stream_get_timestamp</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint64"><returnvalue>gint64</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-get-duration">gtk_media_stream_get_duration</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-is-seekable">gtk_media_stream_is_seekable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-is-seeking">gtk_media_stream_is_seeking</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-seek">gtk_media_stream_seek</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-get-loop">gtk_media_stream_get_loop</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-set-loop">gtk_media_stream_set_loop</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-get-muted">gtk_media_stream_get_muted</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-set-muted">gtk_media_stream_set_muted</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="double"><returnvalue>double</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-get-volume">gtk_media_stream_get_volume</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-set-volume">gtk_media_stream_set_volume</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-realize">gtk_media_stream_realize</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-unrealize">gtk_media_stream_unrealize</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-prepared">gtk_media_stream_prepared</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-unprepared">gtk_media_stream_unprepared</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-update">gtk_media_stream_update</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-ended">gtk_media_stream_ended</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-seek-success">gtk_media_stream_seek_success</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-seek-failed">gtk_media_stream_seek_failed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-gerror">gtk_media_stream_gerror</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-error">gtk_media_stream_error</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-media-stream-error-valist">gtk_media_stream_error_valist</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkMediaStream.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gint64"><type>gint64</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--duration">duration</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--ended">ended</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="GError"><type>GError</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkMediaStream--error">error</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--has-audio">has-audio</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--has-video">has-video</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--loop">loop</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--muted">muted</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--playing">playing</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--prepared">prepared</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--seekable">seekable</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--seeking">seeking</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gint64"><type>gint64</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--timestamp">timestamp</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkMediaStream--volume">volume</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkMediaStream.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkMediaStream-struct">GtkMediaStream</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GtkMediaStreamClass">GtkMediaStreamClass</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkMediaStream.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkMediaStream
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkMediaFile">GtkMediaFile</link>
</screen>
</refsect1>
<refsect1 id="GtkMediaStream.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkMediaStream implements
 <link linkend="GdkPaintable">GdkPaintable</link>.</para>

</refsect1>

<refsect1 id="GtkMediaStream.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkMediaStream.description" role="desc">
<title role="desc.title">Description</title>
<para><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> is the integration point for media playback inside GTK.</para>
<para>Apart from application-facing API for stream playback, <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link>
has a number of APIs that are only useful for implementations and should
not be used in applications:
<link linkend="gtk-media-stream-prepared"><function>gtk_media_stream_prepared()</function></link>,
<link linkend="gtk-media-stream-unprepared"><function>gtk_media_stream_unprepared()</function></link>,
<link linkend="gtk-media-stream-update"><function>gtk_media_stream_update()</function></link>,
<link linkend="gtk-media-stream-ended"><function>gtk_media_stream_ended()</function></link>,
<link linkend="gtk-media-stream-seek-success"><function>gtk_media_stream_seek_success()</function></link>,
<link linkend="gtk-media-stream-seek-failed"><function>gtk_media_stream_seek_failed()</function></link>,
<link linkend="gtk-media-stream-gerror"><function>gtk_media_stream_gerror()</function></link>,
<link linkend="gtk-media-stream-error"><function>gtk_media_stream_error()</function></link>,
<link linkend="gtk-media-stream-error-valist"><function>gtk_media_stream_error_valist()</function></link>.</para>

</refsect1>
<refsect1 id="GtkMediaStream.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-media-stream-is-prepared" role="function">
<title>gtk_media_stream_is_prepared&#160;()</title>
<indexterm zone="gtk-media-stream-is-prepared"><primary>gtk_media_stream_is_prepared</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_media_stream_is_prepared (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Returns whether the stream has finished initializing and existence of
audio and video is known.</para>
<refsect3 id="gtk-media-stream-is-prepared.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-is-prepared.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream is prepared</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-get-error" role="function">
<title>gtk_media_stream_get_error&#160;()</title>
<indexterm zone="gtk-media-stream-get-error"><primary>gtk_media_stream_get_error</primary></indexterm>
<programlisting language="C">const <link linkend="GError"><returnvalue>GError</returnvalue></link>&#160;*
gtk_media_stream_get_error (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>If the stream is in an error state, returns the <link linkend="GError"><type>GError</type></link> explaining that state.
Any type of error can be reported here depending on the implementation of the
media stream.</para>
<para>A media stream in an error cannot be operated on, calls like
<link linkend="gtk-media-stream-play"><function>gtk_media_stream_play()</function></link> or <link linkend="gtk-media-stream-seek"><function>gtk_media_stream_seek()</function></link> will not have any effect.</para>
<para><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> itself does not provide a way to unset an error, but
implementations may provide options. For example, a <link linkend="GtkMediaFile"><type>GtkMediaFile</type></link> will unset
errors when a new source is set with ie <link linkend="gtk-media-file-set-file"><function>gtk_media_file_set_file()</function></link>.</para>
<refsect3 id="gtk-media-stream-get-error.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-get-error.returns" role="returns">
<title>Returns</title>
<para><link linkend="NULL:CAPS"><literal>NULL</literal></link> if not in an error state or
the <link linkend="GError"><type>GError</type></link> of the stream. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-has-audio" role="function">
<title>gtk_media_stream_has_audio&#160;()</title>
<indexterm zone="gtk-media-stream-has-audio"><primary>gtk_media_stream_has_audio</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_media_stream_has_audio (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Returns whether the stream has audio.</para>
<refsect3 id="gtk-media-stream-has-audio.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-has-audio.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream has audio</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-has-video" role="function">
<title>gtk_media_stream_has_video&#160;()</title>
<indexterm zone="gtk-media-stream-has-video"><primary>gtk_media_stream_has_video</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_media_stream_has_video (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Returns whether the stream has video.</para>
<refsect3 id="gtk-media-stream-has-video.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-has-video.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream has video</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-play" role="function">
<title>gtk_media_stream_play&#160;()</title>
<indexterm zone="gtk-media-stream-play"><primary>gtk_media_stream_play</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_play (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Starts playing the stream. If the stream
is in error or already playing, do nothing.</para>
<refsect3 id="gtk-media-stream-play.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-pause" role="function">
<title>gtk_media_stream_pause&#160;()</title>
<indexterm zone="gtk-media-stream-pause"><primary>gtk_media_stream_pause</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_pause (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Pauses playback of the stream. If the stream
is not playing, do nothing.</para>
<refsect3 id="gtk-media-stream-pause.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-get-playing" role="function">
<title>gtk_media_stream_get_playing&#160;()</title>
<indexterm zone="gtk-media-stream-get-playing"><primary>gtk_media_stream_get_playing</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_media_stream_get_playing (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Return whether the stream is currently playing.</para>
<refsect3 id="gtk-media-stream-get-playing.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-get-playing.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream is playing</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-set-playing" role="function">
<title>gtk_media_stream_set_playing&#160;()</title>
<indexterm zone="gtk-media-stream-set-playing"><primary>gtk_media_stream_set_playing</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_set_playing (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                              <parameter><link linkend="gboolean"><type>gboolean</type></link> playing</parameter>);</programlisting>
<para>Starts or pauses playback of the stream.</para>
<refsect3 id="gtk-media-stream-set-playing.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>playing</para></entry>
<entry role="parameter_description"><para>whether to start or pause playback</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-get-ended" role="function">
<title>gtk_media_stream_get_ended&#160;()</title>
<indexterm zone="gtk-media-stream-get-ended"><primary>gtk_media_stream_get_ended</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_media_stream_get_ended (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Returns whether the streams playback is finished.</para>
<refsect3 id="gtk-media-stream-get-ended.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-get-ended.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if playback is finished</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-get-timestamp" role="function">
<title>gtk_media_stream_get_timestamp&#160;()</title>
<indexterm zone="gtk-media-stream-get-timestamp"><primary>gtk_media_stream_get_timestamp</primary></indexterm>
<programlisting language="C"><link linkend="gint64"><returnvalue>gint64</returnvalue></link>
gtk_media_stream_get_timestamp (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Returns the current presentation timestamp in microseconds.</para>
<refsect3 id="gtk-media-stream-get-timestamp.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-get-timestamp.returns" role="returns">
<title>Returns</title>
<para> the timestamp in microseconds</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-get-duration" role="function">
<title>gtk_media_stream_get_duration&#160;()</title>
<indexterm zone="gtk-media-stream-get-duration"><primary>gtk_media_stream_get_duration</primary></indexterm>
<programlisting language="C"><link linkend="gint64"><returnvalue>gint64</returnvalue></link>
gtk_media_stream_get_duration (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Gets the duration of the stream. If the duration is not known,
0 will be returned.</para>
<refsect3 id="gtk-media-stream-get-duration.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-get-duration.returns" role="returns">
<title>Returns</title>
<para> the duration of the stream or 0 if not known.</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-is-seekable" role="function">
<title>gtk_media_stream_is_seekable&#160;()</title>
<indexterm zone="gtk-media-stream-is-seekable"><primary>gtk_media_stream_is_seekable</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_media_stream_is_seekable (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Checks if a stream may be seekable.</para>
<para>This is meant to be a hint. Streams may not allow seeking even if
this function returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>. However, if this function returns
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link>, streams are guaranteed to not be seekable and user interfaces
may hide controls that allow seeking.</para>
<para>It is allowed to call <link linkend="gtk-media-stream-seek"><function>gtk_media_stream_seek()</function></link> on a non-seekable
stream, though it will not do anything.</para>
<refsect3 id="gtk-media-stream-is-seekable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-is-seekable.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream may support seeking</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-is-seeking" role="function">
<title>gtk_media_stream_is_seeking&#160;()</title>
<indexterm zone="gtk-media-stream-is-seeking"><primary>gtk_media_stream_is_seeking</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_media_stream_is_seeking (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Checks if there is currently a seek operation going on.</para>
<refsect3 id="gtk-media-stream-is-seeking.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-is-seeking.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if a seek operation is ongoing.</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-seek" role="function">
<title>gtk_media_stream_seek&#160;()</title>
<indexterm zone="gtk-media-stream-seek"><primary>gtk_media_stream_seek</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_seek (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                       <parameter><link linkend="gint64"><type>gint64</type></link> timestamp</parameter>);</programlisting>
<para>Start a seek operation on <parameter>self</parameter>
 to <parameter>timestamp</parameter>
. If <parameter>timestamp</parameter>
 is out of range,
it will be clamped.</para>
<para>Seek operations may not finish instantly. While a seek operation is
in process, the GtkMediaStream:seeking property will be set.</para>
<para>When calling <link linkend="gtk-media-stream-seek"><function>gtk_media_stream_seek()</function></link> during an ongoing seek operation,
the new seek wil override any pending seek.</para>
<refsect3 id="gtk-media-stream-seek.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>timestamp</para></entry>
<entry role="parameter_description"><para>timestamp to seek to.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-get-loop" role="function">
<title>gtk_media_stream_get_loop&#160;()</title>
<indexterm zone="gtk-media-stream-get-loop"><primary>gtk_media_stream_get_loop</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_media_stream_get_loop (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Returns whether the stream is set to loop. See
<link linkend="gtk-media-stream-set-loop"><function>gtk_media_stream_set_loop()</function></link> for details.</para>
<refsect3 id="gtk-media-stream-get-loop.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-get-loop.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream should loop</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-set-loop" role="function">
<title>gtk_media_stream_set_loop&#160;()</title>
<indexterm zone="gtk-media-stream-set-loop"><primary>gtk_media_stream_set_loop</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_set_loop (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                           <parameter><link linkend="gboolean"><type>gboolean</type></link> loop</parameter>);</programlisting>
<para>Sets whether the stream should loop, ie restart playback from
the beginning instead of stopping at the end.</para>
<para>Not all streams may support looping, in particular non-seekable
streams. Those streams will ignore the loop setting and just end.</para>
<refsect3 id="gtk-media-stream-set-loop.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>loop</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream should loop</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-get-muted" role="function">
<title>gtk_media_stream_get_muted&#160;()</title>
<indexterm zone="gtk-media-stream-get-muted"><primary>gtk_media_stream_get_muted</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_media_stream_get_muted (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Returns whether the audio for the stream is muted.
See <link linkend="gtk-media-stream-set-muted"><function>gtk_media_stream_set_muted()</function></link> for details.</para>
<refsect3 id="gtk-media-stream-get-muted.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-get-muted.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream is muted</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-set-muted" role="function">
<title>gtk_media_stream_set_muted&#160;()</title>
<indexterm zone="gtk-media-stream-set-muted"><primary>gtk_media_stream_set_muted</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_set_muted (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                            <parameter><link linkend="gboolean"><type>gboolean</type></link> muted</parameter>);</programlisting>
<para>Sets whether the audio stream should be muted. Muting a stream will
cause no audio to be played, but it does not modify the volume.
This means that muting and then unmuting the stream will restore
the volume settings.</para>
<para>If the stream has no audio, calling this function will still work
but it will not have an audible effect.</para>
<refsect3 id="gtk-media-stream-set-muted.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>muted</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream should be muted</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-get-volume" role="function">
<title>gtk_media_stream_get_volume&#160;()</title>
<indexterm zone="gtk-media-stream-get-volume"><primary>gtk_media_stream_get_volume</primary></indexterm>
<programlisting language="C"><link linkend="double"><returnvalue>double</returnvalue></link>
gtk_media_stream_get_volume (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Returns the volume of the audio for the stream.
See <link linkend="gtk-media-stream-set-volume"><function>gtk_media_stream_set_volume()</function></link> for details.</para>
<refsect3 id="gtk-media-stream-get-volume.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-media-stream-get-volume.returns" role="returns">
<title>Returns</title>
<para> volume of the stream from 0.0 to 1.0</para>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-set-volume" role="function">
<title>gtk_media_stream_set_volume&#160;()</title>
<indexterm zone="gtk-media-stream-set-volume"><primary>gtk_media_stream_set_volume</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_set_volume (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                             <parameter><link linkend="double"><type>double</type></link> volume</parameter>);</programlisting>
<para>Sets the volume of the audio stream. This function call will work even if
the stream is muted.</para>
<para>The given <parameter>volume</parameter>
 should range from 0.0 for silence to 1.0 for as loud as
possible. Values outside of this range will be clamped to the nearest
value.</para>
<para>If the stream has no audio or is muted, calling this function will still
work but it will not have an immediate audible effect. When the stream is
unmuted, the new volume setting will take effect.</para>
<refsect3 id="gtk-media-stream-set-volume.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>volume</para></entry>
<entry role="parameter_description"><para>New volume of the stream from 0.0 to 1.0</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-realize" role="function">
<title>gtk_media_stream_realize&#160;()</title>
<indexterm zone="gtk-media-stream-realize"><primary>gtk_media_stream_realize</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_realize (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                          <parameter><link linkend="GdkSurface"><type>GdkSurface</type></link> *surface</parameter>);</programlisting>
<para>Called by users to attach the media stream to a <link linkend="GdkSurface"><type>GdkSurface</type></link> they manage.
The stream can then access the resources of <parameter>surface</parameter>
 for its rendering
purposes. In particular, media streams might want to create
<link linkend="GdkGLContexts"><type>GdkGLContexts</type></link> or sync to the <link linkend="GdkFrameClock"><type>GdkFrameClock</type></link>.</para>
<para>Whoever calls this function is responsible for calling
<link linkend="gtk-media-stream-unrealize"><function>gtk_media_stream_unrealize()</function></link> before either the stream or <parameter>surface</parameter>
 get
destroyed.</para>
<para>Multiple calls to this function may happen from different users of the
video, even with the same <parameter>surface</parameter>
. Each of these calls must be followed
by its own call to <link linkend="gtk-media-stream-unrealize"><function>gtk_media_stream_unrealize()</function></link>.</para>
<para>It is not required to call this function to make a media stream work.</para>
<refsect3 id="gtk-media-stream-realize.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>surface</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkSurface"><type>GdkSurface</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-unrealize" role="function">
<title>gtk_media_stream_unrealize&#160;()</title>
<indexterm zone="gtk-media-stream-unrealize"><primary>gtk_media_stream_unrealize</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_unrealize (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                            <parameter><link linkend="GdkSurface"><type>GdkSurface</type></link> *surface</parameter>);</programlisting>
<para>Undoes a previous call to <link linkend="gtk-media-stream-realize"><function>gtk_media_stream_realize()</function></link> and causes
the stream to release all resources it had allocated from <parameter>surface</parameter>
.</para>
<refsect3 id="gtk-media-stream-unrealize.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> previously realized</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>surface</para></entry>
<entry role="parameter_description"><para>the <link linkend="GdkSurface"><type>GdkSurface</type></link> the stream was realized with</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-prepared" role="function">
<title>gtk_media_stream_prepared&#160;()</title>
<indexterm zone="gtk-media-stream-prepared"><primary>gtk_media_stream_prepared</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_prepared (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                           <parameter><link linkend="gboolean"><type>gboolean</type></link> has_audio</parameter>,
                           <parameter><link linkend="gboolean"><type>gboolean</type></link> has_video</parameter>,
                           <parameter><link linkend="gboolean"><type>gboolean</type></link> seekable</parameter>,
                           <parameter><link linkend="gint64"><type>gint64</type></link> duration</parameter>);</programlisting>
<para>Called by <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> implementations to advertise the stream
being ready to play and providing details about the stream.</para>
<para>Note that the arguments are hints. If the stream implementation
cannot determine the correct values, it is better to err on the
side of caution and return <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>. User interfaces will use those
values to determine what controls to show.</para>
<para>This function may not be called again until the stream has been
reset via <link linkend="gtk-media-stream-unprepared"><function>gtk_media_stream_unprepared()</function></link>.</para>
<refsect3 id="gtk-media-stream-prepared.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>has_audio</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream should advertise audio support</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>has_video</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream should advertise video support</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>seekable</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the stream should advertise seekability</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>duration</para></entry>
<entry role="parameter_description"><para>The duration of the stream or 0 if unknown</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-unprepared" role="function">
<title>gtk_media_stream_unprepared&#160;()</title>
<indexterm zone="gtk-media-stream-unprepared"><primary>gtk_media_stream_unprepared</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_unprepared (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Resets a given media stream implementation. <link linkend="gtk-media-stream-prepared"><function>gtk_media_stream_prepared()</function></link>
can now be called again.</para>
<para>This function will also reset any error state the stream was in.</para>
<refsect3 id="gtk-media-stream-unprepared.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-update" role="function">
<title>gtk_media_stream_update&#160;()</title>
<indexterm zone="gtk-media-stream-update"><primary>gtk_media_stream_update</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_update (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                         <parameter><link linkend="gint64"><type>gint64</type></link> timestamp</parameter>);</programlisting>
<para>Media stream implementations should regularly call this function to
update the timestamp reported by the stream. It is up to
implementations to call this at the frequency they deem appropriate.</para>
<refsect3 id="gtk-media-stream-update.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>timestamp</para></entry>
<entry role="parameter_description"><para>the new timestamp</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-ended" role="function">
<title>gtk_media_stream_ended&#160;()</title>
<indexterm zone="gtk-media-stream-ended"><primary>gtk_media_stream_ended</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_ended (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Pauses the media stream and marks it as ended. This is a hint only, calls
to GtkMediaStream.play() may still happen.</para>
<refsect3 id="gtk-media-stream-ended.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-seek-success" role="function">
<title>gtk_media_stream_seek_success&#160;()</title>
<indexterm zone="gtk-media-stream-seek-success"><primary>gtk_media_stream_seek_success</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_seek_success (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Ends a seek operation started via GtkMediaStream.seek() successfully.
This function will unset the GtkMediaStream:ended property if it was
set.</para>
<para>See <link linkend="gtk-media-stream-seek-failed"><function>gtk_media_stream_seek_failed()</function></link> for the other way of
ending a seek.</para>
<refsect3 id="gtk-media-stream-seek-success.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-seek-failed" role="function">
<title>gtk_media_stream_seek_failed&#160;()</title>
<indexterm zone="gtk-media-stream-seek-failed"><primary>gtk_media_stream_seek_failed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_seek_failed (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>);</programlisting>
<para>Ends a seek operation started via GtkMediaStream.seek() as a failure.
This will not cause an error on the stream and will assume that
playback continues as if no seek had happened.</para>
<para>See <link linkend="gtk-media-stream-seek-success"><function>gtk_media_stream_seek_success()</function></link> for the other way of
ending a seek.</para>
<refsect3 id="gtk-media-stream-seek-failed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-gerror" role="function">
<title>gtk_media_stream_gerror&#160;()</title>
<indexterm zone="gtk-media-stream-gerror"><primary>gtk_media_stream_gerror</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_gerror (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                         <parameter><link linkend="GError"><type>GError</type></link> *error</parameter>);</programlisting>
<para>Sets <parameter>self</parameter>
 into an error state. This will pause the stream
(you can check for an error via <link linkend="gtk-media-stream-get-error"><function>gtk_media_stream_get_error()</function></link> in
your GtkMediaStream.pause() implementation), abort pending seeks
and mark the stream as prepared.</para>
<para>if the stream is already in an error state, this call will be ignored
and the existing error will be retained.
FIXME: Or do we want to set the new error?</para>
<para>To unset an error, the stream must be reset via a call to
<link linkend="gtk-media-stream-unprepared"><function>gtk_media_stream_unprepared()</function></link>.</para>
<refsect3 id="gtk-media-stream-gerror.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>the <link linkend="GError"><type>GError</type></link> to set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-error" role="function">
<title>gtk_media_stream_error&#160;()</title>
<indexterm zone="gtk-media-stream-error"><primary>gtk_media_stream_error</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_error (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                        <parameter><link linkend="GQuark"><type>GQuark</type></link> domain</parameter>,
                        <parameter><link linkend="gint"><type>gint</type></link> code</parameter>,
                        <parameter>const <link linkend="gchar"><type>gchar</type></link> *format</parameter>,
                        <parameter>...</parameter>);</programlisting>
<para>Sets <parameter>self</parameter>
 into an error state using a <link linkend="printf"><function>printf()</function></link>-style format string.</para>
<para>This is a utility function that calls <link linkend="gtk-media-stream-gerror"><function>gtk_media_stream_gerror()</function></link>. See
that function for details.</para>
<refsect3 id="gtk-media-stream-error.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>domain</para></entry>
<entry role="parameter_description"><para>error domain</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>code</para></entry>
<entry role="parameter_description"><para>error code</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>format</para></entry>
<entry role="parameter_description"><para>printf()-style format for error message</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>parameters for message format</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-media-stream-error-valist" role="function">
<title>gtk_media_stream_error_valist&#160;()</title>
<indexterm zone="gtk-media-stream-error-valist"><primary>gtk_media_stream_error_valist</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_media_stream_error_valist (<parameter><link linkend="GtkMediaStream"><type>GtkMediaStream</type></link> *self</parameter>,
                               <parameter><link linkend="GQuark"><type>GQuark</type></link> domain</parameter>,
                               <parameter><link linkend="gint"><type>gint</type></link> code</parameter>,
                               <parameter>const <link linkend="gchar"><type>gchar</type></link> *format</parameter>,
                               <parameter><link linkend="va-list"><type>va_list</type></link> args</parameter>);</programlisting>
<para>Sets <parameter>self</parameter>
 into an error state using a <link linkend="printf"><function>printf()</function></link>-style format string.</para>
<para>This is a utility function that calls <link linkend="gtk-media-stream-gerror"><function>gtk_media_stream_gerror()</function></link>. See
that function for details.</para>
<refsect3 id="gtk-media-stream-error-valist.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMediaStream"><type>GtkMediaStream</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>domain</para></entry>
<entry role="parameter_description"><para>error domain</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>code</para></entry>
<entry role="parameter_description"><para>error code</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>format</para></entry>
<entry role="parameter_description"><para>printf()-style format for error message</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>args</para></entry>
<entry role="parameter_description"><para><link linkend="va-list"><type>va_list</type></link> of parameters for the message format</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkMediaStream.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkMediaStream-struct" role="struct">
<title>GtkMediaStream</title>
<indexterm zone="GtkMediaStream-struct"><primary>GtkMediaStream</primary></indexterm>
<programlisting language="C">typedef struct _GtkMediaStream GtkMediaStream;</programlisting>
</refsect2>
<refsect2 id="GtkMediaStreamClass" role="struct">
<title>struct GtkMediaStreamClass</title>
<indexterm zone="GtkMediaStreamClass"><primary>GtkMediaStreamClass</primary></indexterm>
<programlisting language="C">struct GtkMediaStreamClass {
  GObjectClass parent_class;

  gboolean              (* play)                                (GtkMediaStream *self);
  void                  (* pause)                               (GtkMediaStream *self);
  void                  (* seek)                                (GtkMediaStream *self,
                                                                 gint64          timestamp);
  void                  (* update_audio)                        (GtkMediaStream *self,
                                                                 gboolean        muted,
                                                                 double          volume);
  void                  (* realize)                             (GtkMediaStream *self,
                                                                 GdkSurface      *surface);
  void                  (* unrealize)                           (GtkMediaStream *self,
                                                                 GdkSurface      *surface);

  /* Padding for future expansion */
  void (*_gtk_reserved1) (void);
  void (*_gtk_reserved2) (void);
  void (*_gtk_reserved3) (void);
  void (*_gtk_reserved4) (void);
  void (*_gtk_reserved5) (void);
  void (*_gtk_reserved6) (void);
  void (*_gtk_reserved7) (void);
  void (*_gtk_reserved8) (void);
};
</programlisting>
</refsect2>

</refsect1>
<refsect1 id="GtkMediaStream.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkMediaStream--duration" role="property"><title>The <literal>“duration”</literal> property</title>
<indexterm zone="GtkMediaStream--duration"><primary>GtkMediaStream:duration</primary></indexterm>
<programlisting>  “duration”                 <link linkend="gint64"><type>gint64</type></link></programlisting>
<para>The stream's duration in microseconds or 0 if unknown.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkMediaStream--ended" role="property"><title>The <literal>“ended”</literal> property</title>
<indexterm zone="GtkMediaStream--ended"><primary>GtkMediaStream:ended</primary></indexterm>
<programlisting>  “ended”                    <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Set when playback has finished.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkMediaStream--error" role="property"><title>The <literal>“error”</literal> property</title>
<indexterm zone="GtkMediaStream--error"><primary>GtkMediaStream:error</primary></indexterm>
<programlisting>  “error”                    <link linkend="GError"><type>GError</type></link>&#160;*</programlisting>
<para><link linkend="NULL:CAPS"><literal>NULL</literal></link> for a properly working stream or the <link linkend="GError"><type>GError</type></link> that the stream is in.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkMediaStream--has-audio" role="property"><title>The <literal>“has-audio”</literal> property</title>
<indexterm zone="GtkMediaStream--has-audio"><primary>GtkMediaStream:has-audio</primary></indexterm>
<programlisting>  “has-audio”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the stream contains audio</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkMediaStream--has-video" role="property"><title>The <literal>“has-video”</literal> property</title>
<indexterm zone="GtkMediaStream--has-video"><primary>GtkMediaStream:has-video</primary></indexterm>
<programlisting>  “has-video”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the stream contains video</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkMediaStream--loop" role="property"><title>The <literal>“loop”</literal> property</title>
<indexterm zone="GtkMediaStream--loop"><primary>GtkMediaStream:loop</primary></indexterm>
<programlisting>  “loop”                     <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Try to restart the media from the beginning once it ended.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkMediaStream--muted" role="property"><title>The <literal>“muted”</literal> property</title>
<indexterm zone="GtkMediaStream--muted"><primary>GtkMediaStream:muted</primary></indexterm>
<programlisting>  “muted”                    <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the audio stream should be muted.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkMediaStream--playing" role="property"><title>The <literal>“playing”</literal> property</title>
<indexterm zone="GtkMediaStream--playing"><primary>GtkMediaStream:playing</primary></indexterm>
<programlisting>  “playing”                  <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the stream is currently playing.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkMediaStream--prepared" role="property"><title>The <literal>“prepared”</literal> property</title>
<indexterm zone="GtkMediaStream--prepared"><primary>GtkMediaStream:prepared</primary></indexterm>
<programlisting>  “prepared”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the stream has finished initializing and existence of
audio and video is known.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkMediaStream--seekable" role="property"><title>The <literal>“seekable”</literal> property</title>
<indexterm zone="GtkMediaStream--seekable"><primary>GtkMediaStream:seekable</primary></indexterm>
<programlisting>  “seekable”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Set unless the stream is known to not support seeking.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkMediaStream--seeking" role="property"><title>The <literal>“seeking”</literal> property</title>
<indexterm zone="GtkMediaStream--seeking"><primary>GtkMediaStream:seeking</primary></indexterm>
<programlisting>  “seeking”                  <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Set while a seek is in progress.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkMediaStream--timestamp" role="property"><title>The <literal>“timestamp”</literal> property</title>
<indexterm zone="GtkMediaStream--timestamp"><primary>GtkMediaStream:timestamp</primary></indexterm>
<programlisting>  “timestamp”                <link linkend="gint64"><type>gint64</type></link></programlisting>
<para>The current presentation timestamp in microseconds.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkMediaStream--volume" role="property"><title>The <literal>“volume”</literal> property</title>
<indexterm zone="GtkMediaStream--volume"><primary>GtkMediaStream:volume</primary></indexterm>
<programlisting>  “volume”                   <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Volume of the audio stream.</para>
<para>Owner: GtkMediaStream</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>

</refsect1>
<refsect1 id="GtkMediaStream.see-also">
<title>See Also</title>
<para><link linkend="GdkPaintable"><type>GdkPaintable</type></link></para>

</refsect1>

</refentry>
