2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
4
<refentry id="RBStreamingSource">
6
<refentrytitle role="top_of_page" id="RBStreamingSource.top_of_page">RBStreamingSource</refentrytitle>
7
<manvolnum>3</manvolnum>
8
<refmiscinfo>RHYTHMBOX Library</refmiscinfo>
12
<refname>RBStreamingSource</refname>
13
<refpurpose>Base class for streaming sources such as internet radio</refpurpose>
16
<refsynopsisdiv id="RBStreamingSource.synopsis" role="synopsis">
17
<title role="synopsis.title">Synopsis</title>
20
<link linkend="RBStreamingSource-struct">RBStreamingSource</link>;
21
<link linkend="RBStreamingSourceClass">RBStreamingSourceClass</link>;
22
<link linkend="void">void</link> <link linkend="rb-streaming-source-get-progress">rb_streaming_source_get_progress</link> (<link linkend="RBStreamingSource">RBStreamingSource</link> *source,
23
<link linkend="char">char</link> **text,
24
<link linkend="float">float</link> *progress);
25
<link linkend="void">void</link> <link linkend="rb-streaming-source-set-streaming-title">rb_streaming_source_set_streaming_title</link>
26
(<link linkend="RBStreamingSource">RBStreamingSource</link> *source,
27
const <link linkend="char">char</link> *title);
28
<link linkend="void">void</link> <link linkend="rb-streaming-source-set-streaming-artist">rb_streaming_source_set_streaming_artist</link>
29
(<link linkend="RBStreamingSource">RBStreamingSource</link> *source,
30
const <link linkend="char">char</link> *artist);
31
<link linkend="void">void</link> <link linkend="rb-streaming-source-set-streaming-album">rb_streaming_source_set_streaming_album</link>
32
(<link linkend="RBStreamingSource">RBStreamingSource</link> *source,
33
const <link linkend="char">char</link> *album);
37
<refsect1 id="RBStreamingSource.object-hierarchy" role="object_hierarchy">
38
<title role="object_hierarchy.title">Object Hierarchy</title>
40
<link linkend="GObject">GObject</link>
41
+----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
42
+----<link linkend="GtkObject">GtkObject</link>
43
+----<link linkend="GtkWidget">GtkWidget</link>
44
+----<link linkend="GtkContainer">GtkContainer</link>
45
+----<link linkend="GtkBox">GtkBox</link>
46
+----<link linkend="GtkHBox">GtkHBox</link>
47
+----<link linkend="RBSource">RBSource</link>
48
+----RBStreamingSource
54
<refsect1 id="RBStreamingSource.implemented-interfaces" role="impl_interfaces">
55
<title role="impl_interfaces.title">Implemented Interfaces</title>
57
RBStreamingSource implements
58
<link linkend="AtkImplementorIface">AtkImplementorIface</link>, <link linkend="GtkBuildable">GtkBuildable</link> and <link linkend="GtkOrientable">GtkOrientable</link>.</para>
65
<refsect1 id="RBStreamingSource.description" role="desc">
66
<title role="desc.title">Description</title>
68
This class provides handling of buffering signals and streaming song metadata
69
common to different types of sources that play continuous streaming media.</para>
74
<refsect1 id="RBStreamingSource.details" role="details">
75
<title role="details.title">Details</title>
76
<refsect2 id="RBStreamingSource-struct" role="struct">
77
<title>RBStreamingSource</title>
78
<indexterm zone="RBStreamingSource-struct"><primary sortas="RBStreamingSource">RBStreamingSource</primary></indexterm><programlisting>typedef struct _RBStreamingSource RBStreamingSource;</programlisting>
81
<refsect2 id="RBStreamingSourceClass" role="struct">
82
<title>RBStreamingSourceClass</title>
83
<indexterm zone="RBStreamingSourceClass"><primary sortas="RBStreamingSourceClass">RBStreamingSourceClass</primary></indexterm><programlisting>typedef struct {
85
} RBStreamingSourceClass;
89
<refsect2 id="rb-streaming-source-get-progress" role="function">
90
<title>rb_streaming_source_get_progress ()</title>
91
<indexterm zone="rb-streaming-source-get-progress"><primary sortas="rb_streaming_source_get_progress">rb_streaming_source_get_progress</primary></indexterm><programlisting><link linkend="void">void</link> rb_streaming_source_get_progress (<link linkend="RBStreamingSource">RBStreamingSource</link> *source,
92
<link linkend="char">char</link> **text,
93
<link linkend="float">float</link> *progress);</programlisting>
95
Provides status text and progress fraction suitable for use in
96
a streaming source's <parameter>rb_source_get_status</parameter> method.</para>
98
</para><variablelist role="params">
99
<varlistentry><term><parameter>source</parameter> :</term>
100
<listitem><simpara> a <link linkend="RBStreamingSource"><type>RBStreamingSource</type></link>
101
</simpara></listitem></varlistentry>
102
<varlistentry><term><parameter>text</parameter> :</term>
103
<listitem><simpara> returns buffering status text
104
</simpara></listitem></varlistentry>
105
<varlistentry><term><parameter>progress</parameter> :</term>
106
<listitem><simpara> returns buffering progress fraction
107
</simpara></listitem></varlistentry>
108
</variablelist></refsect2>
109
<refsect2 id="rb-streaming-source-set-streaming-title" role="function">
110
<title>rb_streaming_source_set_streaming_title ()</title>
111
<indexterm zone="rb-streaming-source-set-streaming-title"><primary sortas="rb_streaming_source_set_streaming_title">rb_streaming_source_set_streaming_title</primary></indexterm><programlisting><link linkend="void">void</link> rb_streaming_source_set_streaming_title
112
(<link linkend="RBStreamingSource">RBStreamingSource</link> *source,
113
const <link linkend="char">char</link> *title);</programlisting>
115
Updates the streaming song title. Call this when an updated
116
streaming song title is received from the stream.</para>
118
</para><variablelist role="params">
119
<varlistentry><term><parameter>source</parameter> :</term>
120
<listitem><simpara> a <link linkend="RBStreamingSource"><type>RBStreamingSource</type></link>
121
</simpara></listitem></varlistentry>
122
<varlistentry><term><parameter>title</parameter> :</term>
123
<listitem><simpara> the new streaming song title
124
</simpara></listitem></varlistentry>
125
</variablelist></refsect2>
126
<refsect2 id="rb-streaming-source-set-streaming-artist" role="function">
127
<title>rb_streaming_source_set_streaming_artist ()</title>
128
<indexterm zone="rb-streaming-source-set-streaming-artist"><primary sortas="rb_streaming_source_set_streaming_artist">rb_streaming_source_set_streaming_artist</primary></indexterm><programlisting><link linkend="void">void</link> rb_streaming_source_set_streaming_artist
129
(<link linkend="RBStreamingSource">RBStreamingSource</link> *source,
130
const <link linkend="char">char</link> *artist);</programlisting>
132
Updates the streaming song artist name. Call this when an updated
133
streaming song artist name is received from the stream.</para>
135
</para><variablelist role="params">
136
<varlistentry><term><parameter>source</parameter> :</term>
137
<listitem><simpara> a <link linkend="RBStreamingSource"><type>RBStreamingSource</type></link>
138
</simpara></listitem></varlistentry>
139
<varlistentry><term><parameter>artist</parameter> :</term>
140
<listitem><simpara> the new streaming song artist name
141
</simpara></listitem></varlistentry>
142
</variablelist></refsect2>
143
<refsect2 id="rb-streaming-source-set-streaming-album" role="function">
144
<title>rb_streaming_source_set_streaming_album ()</title>
145
<indexterm zone="rb-streaming-source-set-streaming-album"><primary sortas="rb_streaming_source_set_streaming_album">rb_streaming_source_set_streaming_album</primary></indexterm><programlisting><link linkend="void">void</link> rb_streaming_source_set_streaming_album
146
(<link linkend="RBStreamingSource">RBStreamingSource</link> *source,
147
const <link linkend="char">char</link> *album);</programlisting>
149
Updates the streaming song album name. Call this when an updated
150
streaming song album name is received from the stream.</para>
152
</para><variablelist role="params">
153
<varlistentry><term><parameter>source</parameter> :</term>
154
<listitem><simpara> a <link linkend="RBStreamingSource"><type>RBStreamingSource</type></link>
155
</simpara></listitem></varlistentry>
156
<varlistentry><term><parameter>album</parameter> :</term>
157
<listitem><simpara> the new streaming song album name
158
</simpara></listitem></varlistentry>
159
</variablelist></refsect2>