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="rhythmbox-rb-player">
6
<refentrytitle>rb-player</refentrytitle>
7
<manvolnum>3</manvolnum>
8
<refmiscinfo>RHYTHMBOX Library</refmiscinfo>
12
<refname>rb-player</refname><refpurpose></refpurpose>
15
<refsynopsisdiv><title>Synopsis</title>
21
enum <link linkend="RBPlayerError">RBPlayerError</link>;
22
#define <link linkend="RB-PLAYER-TICK-HZ:CAPS">RB_PLAYER_TICK_HZ</link>
23
#define <link linkend="RB-PLAYER-ERROR:CAPS">RB_PLAYER_ERROR</link>
24
<link linkend="GQuark">GQuark</link> <link linkend="rb-player-error-quark">rb_player_error_quark</link> (void);
25
typedef <link linkend="RBPlayerPrivate">RBPlayerPrivate</link>;
26
<link linkend="RBPlayer">RBPlayer</link>* <link linkend="rb-player-new">rb_player_new</link> (<link linkend="GError">GError</link> **error);
27
<link linkend="gboolean">gboolean</link> <link linkend="rb-player-open">rb_player_open</link> (<link linkend="RBPlayer">RBPlayer</link> *mp,
28
const <link linkend="char">char</link> *uri,
29
<link linkend="GError">GError</link> **error);
30
<link linkend="gboolean">gboolean</link> <link linkend="rb-player-opened">rb_player_opened</link> (<link linkend="RBPlayer">RBPlayer</link> *mp);
31
<link linkend="gboolean">gboolean</link> <link linkend="rb-player-close">rb_player_close</link> (<link linkend="RBPlayer">RBPlayer</link> *mp,
32
<link linkend="GError">GError</link> **error);
33
<link linkend="gboolean">gboolean</link> <link linkend="rb-player-play">rb_player_play</link> (<link linkend="RBPlayer">RBPlayer</link> *mp,
34
<link linkend="GError">GError</link> **error);
35
<link linkend="void">void</link> <link linkend="rb-player-pause">rb_player_pause</link> (<link linkend="RBPlayer">RBPlayer</link> *mp);
36
<link linkend="gboolean">gboolean</link> <link linkend="rb-player-playing">rb_player_playing</link> (<link linkend="RBPlayer">RBPlayer</link> *mp);
37
<link linkend="void">void</link> <link linkend="rb-player-set-volume">rb_player_set_volume</link> (<link linkend="RBPlayer">RBPlayer</link> *mp,
38
<link linkend="float">float</link> volume);
39
<link linkend="float">float</link> <link linkend="rb-player-get-volume">rb_player_get_volume</link> (<link linkend="RBPlayer">RBPlayer</link> *mp);
40
<link linkend="void">void</link> <link linkend="rb-player-set-replaygain">rb_player_set_replaygain</link> (<link linkend="RBPlayer">RBPlayer</link> *mp,
41
<link linkend="double">double</link> track_gain,
42
<link linkend="double">double</link> track_peak,
43
<link linkend="double">double</link> album_gain,
44
<link linkend="double">double</link> album_peak);
45
<link linkend="gboolean">gboolean</link> <link linkend="rb-player-seekable">rb_player_seekable</link> (<link linkend="RBPlayer">RBPlayer</link> *mp);
46
<link linkend="void">void</link> <link linkend="rb-player-set-time">rb_player_set_time</link> (<link linkend="RBPlayer">RBPlayer</link> *mp,
47
<link linkend="long-time">long time</link>);
48
<link linkend="long">long</link> <link linkend="rb-player-get-time">rb_player_get_time</link> (<link linkend="RBPlayer">RBPlayer</link> *mp);
62
<title>Description</title>
69
<title>Details</title>
71
<title><anchor id="RBPlayerError"/>enum RBPlayerError</title>
72
<indexterm><primary>RBPlayerError</primary></indexterm><programlisting>typedef enum
74
RB_PLAYER_ERROR_NO_INPUT_PLUGIN,
75
RB_PLAYER_ERROR_NO_QUEUE_PLUGIN,
76
RB_PLAYER_ERROR_NO_TYPEFIND_PLUGIN,
77
RB_PLAYER_ERROR_NO_DEMUX_PLUGIN,
78
RB_PLAYER_ERROR_NO_VOLUME_PLUGIN,
79
RB_PLAYER_ERROR_DEMUX_FAILED,
80
RB_PLAYER_ERROR_NO_AUDIO,
81
RB_PLAYER_ERROR_GENERAL,
82
RB_PLAYER_ERROR_INTERNAL
89
<title><anchor id="RB-PLAYER-TICK-HZ:CAPS"/>RB_PLAYER_TICK_HZ</title>
90
<indexterm><primary>RB_PLAYER_TICK_HZ</primary></indexterm><programlisting>#define RB_PLAYER_TICK_HZ 5
96
<title><anchor id="RB-PLAYER-ERROR:CAPS"/>RB_PLAYER_ERROR</title>
97
<indexterm><primary>RB_PLAYER_ERROR</primary></indexterm><programlisting>#define RB_PLAYER_ERROR rb_player_error_quark ()
103
<title><anchor id="rb-player-error-quark"/>rb_player_error_quark ()</title>
104
<indexterm><primary>rb_player_error_quark</primary></indexterm><programlisting><link linkend="GQuark">GQuark</link> rb_player_error_quark (void);</programlisting>
107
</para><variablelist role="params">
108
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
111
</simpara></listitem></varlistentry>
112
</variablelist></refsect2>
114
<title><anchor id="RBPlayerPrivate"/>RBPlayerPrivate</title>
115
<indexterm><primary>RBPlayerPrivate</primary></indexterm><programlisting>typedef struct RBPlayerPrivate RBPlayerPrivate;
121
<title><anchor id="rb-player-new"/>rb_player_new ()</title>
122
<indexterm><primary>rb_player_new</primary></indexterm><programlisting><link linkend="RBPlayer">RBPlayer</link>* rb_player_new (<link linkend="GError">GError</link> **error);</programlisting>
125
</para><variablelist role="params">
126
<varlistentry><term><parameter>error</parameter> :</term>
128
</simpara></listitem></varlistentry>
129
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
132
</simpara></listitem></varlistentry>
133
</variablelist></refsect2>
135
<title><anchor id="rb-player-open"/>rb_player_open ()</title>
136
<indexterm><primary>rb_player_open</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> rb_player_open (<link linkend="RBPlayer">RBPlayer</link> *mp,
137
const <link linkend="char">char</link> *uri,
138
<link linkend="GError">GError</link> **error);</programlisting>
141
</para><variablelist role="params">
142
<varlistentry><term><parameter>mp</parameter> :</term>
144
</simpara></listitem></varlistentry>
145
<varlistentry><term><parameter>uri</parameter> :</term>
147
</simpara></listitem></varlistentry>
148
<varlistentry><term><parameter>error</parameter> :</term>
150
</simpara></listitem></varlistentry>
151
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
154
</simpara></listitem></varlistentry>
155
</variablelist></refsect2>
157
<title><anchor id="rb-player-opened"/>rb_player_opened ()</title>
158
<indexterm><primary>rb_player_opened</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> rb_player_opened (<link linkend="RBPlayer">RBPlayer</link> *mp);</programlisting>
161
</para><variablelist role="params">
162
<varlistentry><term><parameter>mp</parameter> :</term>
164
</simpara></listitem></varlistentry>
165
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
168
</simpara></listitem></varlistentry>
169
</variablelist></refsect2>
171
<title><anchor id="rb-player-close"/>rb_player_close ()</title>
172
<indexterm><primary>rb_player_close</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> rb_player_close (<link linkend="RBPlayer">RBPlayer</link> *mp,
173
<link linkend="GError">GError</link> **error);</programlisting>
176
</para><variablelist role="params">
177
<varlistentry><term><parameter>mp</parameter> :</term>
179
</simpara></listitem></varlistentry>
180
<varlistentry><term><parameter>error</parameter> :</term>
182
</simpara></listitem></varlistentry>
183
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
186
</simpara></listitem></varlistentry>
187
</variablelist></refsect2>
189
<title><anchor id="rb-player-play"/>rb_player_play ()</title>
190
<indexterm><primary>rb_player_play</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> rb_player_play (<link linkend="RBPlayer">RBPlayer</link> *mp,
191
<link linkend="GError">GError</link> **error);</programlisting>
194
</para><variablelist role="params">
195
<varlistentry><term><parameter>mp</parameter> :</term>
197
</simpara></listitem></varlistentry>
198
<varlistentry><term><parameter>error</parameter> :</term>
200
</simpara></listitem></varlistentry>
201
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
204
</simpara></listitem></varlistentry>
205
</variablelist></refsect2>
207
<title><anchor id="rb-player-pause"/>rb_player_pause ()</title>
208
<indexterm><primary>rb_player_pause</primary></indexterm><programlisting><link linkend="void">void</link> rb_player_pause (<link linkend="RBPlayer">RBPlayer</link> *mp);</programlisting>
211
</para><variablelist role="params">
212
<varlistentry><term><parameter>mp</parameter> :</term>
216
</simpara></listitem></varlistentry>
217
</variablelist></refsect2>
219
<title><anchor id="rb-player-playing"/>rb_player_playing ()</title>
220
<indexterm><primary>rb_player_playing</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> rb_player_playing (<link linkend="RBPlayer">RBPlayer</link> *mp);</programlisting>
223
</para><variablelist role="params">
224
<varlistentry><term><parameter>mp</parameter> :</term>
226
</simpara></listitem></varlistentry>
227
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
230
</simpara></listitem></varlistentry>
231
</variablelist></refsect2>
233
<title><anchor id="rb-player-set-volume"/>rb_player_set_volume ()</title>
234
<indexterm><primary>rb_player_set_volume</primary></indexterm><programlisting><link linkend="void">void</link> rb_player_set_volume (<link linkend="RBPlayer">RBPlayer</link> *mp,
235
<link linkend="float">float</link> volume);</programlisting>
238
</para><variablelist role="params">
239
<varlistentry><term><parameter>mp</parameter> :</term>
241
</simpara></listitem></varlistentry>
242
<varlistentry><term><parameter>volume</parameter> :</term>
246
</simpara></listitem></varlistentry>
247
</variablelist></refsect2>
249
<title><anchor id="rb-player-get-volume"/>rb_player_get_volume ()</title>
250
<indexterm><primary>rb_player_get_volume</primary></indexterm><programlisting><link linkend="float">float</link> rb_player_get_volume (<link linkend="RBPlayer">RBPlayer</link> *mp);</programlisting>
253
</para><variablelist role="params">
254
<varlistentry><term><parameter>mp</parameter> :</term>
256
</simpara></listitem></varlistentry>
257
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
260
</simpara></listitem></varlistentry>
261
</variablelist></refsect2>
263
<title><anchor id="rb-player-set-replaygain"/>rb_player_set_replaygain ()</title>
264
<indexterm><primary>rb_player_set_replaygain</primary></indexterm><programlisting><link linkend="void">void</link> rb_player_set_replaygain (<link linkend="RBPlayer">RBPlayer</link> *mp,
265
<link linkend="double">double</link> track_gain,
266
<link linkend="double">double</link> track_peak,
267
<link linkend="double">double</link> album_gain,
268
<link linkend="double">double</link> album_peak);</programlisting>
271
</para><variablelist role="params">
272
<varlistentry><term><parameter>mp</parameter> :</term>
274
</simpara></listitem></varlistentry>
275
<varlistentry><term><parameter>track_gain</parameter> :</term>
277
</simpara></listitem></varlistentry>
278
<varlistentry><term><parameter>track_peak</parameter> :</term>
280
</simpara></listitem></varlistentry>
281
<varlistentry><term><parameter>album_gain</parameter> :</term>
283
</simpara></listitem></varlistentry>
284
<varlistentry><term><parameter>album_peak</parameter> :</term>
288
</simpara></listitem></varlistentry>
289
</variablelist></refsect2>
291
<title><anchor id="rb-player-seekable"/>rb_player_seekable ()</title>
292
<indexterm><primary>rb_player_seekable</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> rb_player_seekable (<link linkend="RBPlayer">RBPlayer</link> *mp);</programlisting>
295
</para><variablelist role="params">
296
<varlistentry><term><parameter>mp</parameter> :</term>
298
</simpara></listitem></varlistentry>
299
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
302
</simpara></listitem></varlistentry>
303
</variablelist></refsect2>
305
<title><anchor id="rb-player-set-time"/>rb_player_set_time ()</title>
306
<indexterm><primary>rb_player_set_time</primary></indexterm><programlisting><link linkend="void">void</link> rb_player_set_time (<link linkend="RBPlayer">RBPlayer</link> *mp,
307
<link linkend="long-time">long time</link>);</programlisting>
310
</para><variablelist role="params">
311
<varlistentry><term><parameter>mp</parameter> :</term>
313
</simpara></listitem></varlistentry>
314
<varlistentry><term><parameter>Param2</parameter> :</term>
318
</simpara></listitem></varlistentry>
319
</variablelist></refsect2>
321
<title><anchor id="rb-player-get-time"/>rb_player_get_time ()</title>
322
<indexterm><primary>rb_player_get_time</primary></indexterm><programlisting><link linkend="long">long</link> rb_player_get_time (<link linkend="RBPlayer">RBPlayer</link> *mp);</programlisting>
325
</para><variablelist role="params">
326
<varlistentry><term><parameter>mp</parameter> :</term>
328
</simpara></listitem></varlistentry>
329
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
332
</simpara></listitem></varlistentry>
333
</variablelist></refsect2>