docs/libs/html/gst-plugins-base-libs-gsttuner.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>gsttuner</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GStreamer Base Plugins 0.10 Library Reference Manual">
   8 <link rel="up" href="gstreamer-interfaces.html" title="Interfaces Library">
   9 <link rel="prev" href="gst-plugins-base-libs-gststreamvolume.html" title="gststreamvolume">
  10 <link rel="next" href="gst-plugins-base-libs-gsttunerchannel.html" title="gsttunerchannel">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="gst-plugins-base-libs-gststreamvolume.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="gstreamer-interfaces.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GStreamer Base Plugins 0.10 Library Reference Manual</th>
  21 <td><a accesskey="n" href="gst-plugins-base-libs-gsttunerchannel.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#gst-plugins-base-libs-gsttuner.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gst-plugins-base-libs-gsttuner.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#gst-plugins-base-libs-gsttuner.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#gst-plugins-base-libs-gsttuner.prerequisites" class="shortcut">Prerequisites</a>
  31                    |
  32                   <a href="#gst-plugins-base-libs-gsttuner.signals" class="shortcut">Signals</a>
  33 </td></tr>
  34 </table>
  35 <div class="refentry">
  36 <a name="gst-plugins-base-libs-gsttuner"></a><div class="titlepage"></div>
  37 <div class="refnamediv"><table width="100%"><tr>
  38 <td valign="top">
  39 <h2><span class="refentrytitle"><a name="gst-plugins-base-libs-gsttuner.top_of_page"></a>gsttuner</span></h2>
  40 <p>gsttuner — Interface for elements providing tuner operations</p>
  41 </td>
  42 <td valign="top" align="right"></td>
  43 </tr></table></div>
  44 <div class="refsynopsisdiv">
  45 <a name="gst-plugins-base-libs-gsttuner.synopsis"></a><h2>Synopsis</h2>
  46 <a name="GstTuner"></a><pre class="synopsis">
  47 #include &lt;gst/interfaces/tuner.h&gt;
  48
  49                     <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner-struct" title="GstTuner">GstTuner</a>;
  50 struct              <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTunerClass" title="struct GstTunerClass">GstTunerClass</a>;
  51 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *       <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-list-channels" title="gst_tuner_list_channels ()">gst_tuner_list_channels</a>             (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>);
  52 <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="returnvalue">GstTunerChannel</span></a> *   <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-get-channel" title="gst_tuner_get_channel ()">gst_tuner_get_channel</a>               (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>);
  53 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-set-channel" title="gst_tuner_set_channel ()">gst_tuner_set_channel</a>               (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  54                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>);
  55 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *       <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-list-norms" title="gst_tuner_list_norms ()">gst_tuner_list_norms</a>                (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>);
  56 <a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="returnvalue">GstTunerNorm</span></a> *      <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-get-norm" title="gst_tuner_get_norm ()">gst_tuner_get_norm</a>                  (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>);
  57 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-set-norm" title="gst_tuner_set_norm ()">gst_tuner_set_norm</a>                  (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  58                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a> *norm</code></em>);
  59 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a>              <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-get-frequency" title="gst_tuner_get_frequency ()">gst_tuner_get_frequency</a>             (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  60                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>);
  61 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-set-frequency" title="gst_tuner_set_frequency ()">gst_tuner_set_frequency</a>             (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  62                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>,
  63                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> frequency</code></em>);
  64 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-signal-strength" title="gst_tuner_signal_strength ()">gst_tuner_signal_strength</a>           (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  65                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>);
  66 <a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="returnvalue">GstTunerNorm</span></a> *      <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-find-norm-by-name" title="gst_tuner_find_norm_by_name ()">gst_tuner_find_norm_by_name</a>         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  67                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *norm</code></em>);
  68 <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="returnvalue">GstTunerChannel</span></a> *   <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-find-channel-by-name" title="gst_tuner_find_channel_by_name ()">gst_tuner_find_channel_by_name</a>      (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  69                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *channel</code></em>);
  70 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-channel-changed" title="gst_tuner_channel_changed ()">gst_tuner_channel_changed</a>           (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  71                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>);
  72 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-norm-changed" title="gst_tuner_norm_changed ()">gst_tuner_norm_changed</a>              (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  73                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a> *norm</code></em>);
  74 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-frequency-changed" title="gst_tuner_frequency_changed ()">gst_tuner_frequency_changed</a>         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  75                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>,
  76                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> frequency</code></em>);
  77 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-signal-changed" title="gst_tuner_signal_changed ()">gst_tuner_signal_changed</a>            (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
  78                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>,
  79                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> signal</code></em>);
  80 </pre>
  81 </div>
  82 <div class="refsect1">
  83 <a name="gst-plugins-base-libs-gsttuner.object-hierarchy"></a><h2>Object Hierarchy</h2>
  84 <pre class="synopsis">
  85   GInterface
  86    +----GstTuner
  87 </pre>
  88 </div>
  89 <div class="refsect1">
  90 <a name="gst-plugins-base-libs-gsttuner.prerequisites"></a><h2>Prerequisites</h2>
  91 <p>
  92 GstTuner requires
  93  <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstImplementsInterface.html">GstImplementsInterface</a> and  <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html">GstElement</a>.</p>
  94 </div>
  95 <div class="refsect1">
  96 <a name="gst-plugins-base-libs-gsttuner.signals"></a><h2>Signals</h2>
  97 <pre class="synopsis">
  98   "<a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner-channel-changed" title='The "channel-changed" signal'>channel-changed</a>"                                : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  99   "<a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner-frequency-changed" title='The "frequency-changed" signal'>frequency-changed</a>"                              : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 100   "<a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner-norm-changed" title='The "norm-changed" signal'>norm-changed</a>"                                   : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 101   "<a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner-signal-changed" title='The "signal-changed" signal'>signal-changed</a>"                                 : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 102 </pre>
 103 </div>
 104 <div class="refsect1">
 105 <a name="gst-plugins-base-libs-gsttuner.description"></a><h2>Description</h2>
 106 <p>
 107 </p>
 108 <div class="refsect2">
 109 <a name="idp17049216"></a><p>
 110 The GstTuner interface is provided by elements that have the ability to
 111 tune into multiple input signals, for example TV or radio capture cards.
 112 </p>
 113 <p>
 114 The interpretation of 'tuning into' an input stream depends on the element
 115 implementing the interface. For v4lsrc, it might imply selection of an
 116 input source and/or frequency to be configured on a TV card. Another
 117 GstTuner implementation might be to allow selection of an active input pad
 118 from multiple input pads.
 119 </p>
 120 <p>
 121 That said, the GstTuner interface functions are biased toward the
 122 TV capture scenario.
 123 </p>
 124 <p>
 125 The general parameters provided are for configuration are:
 126 </p>
 127 <div class="itemizedlist"><ul class="itemizedlist" type="disc">
 128 <li class="listitem">Selection of a current <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a>. The current channel
 129 represents the input source (e.g. Composite, S-Video etc for TV capture).
 130 </li>
 131 <li class="listitem">The <a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a> for the channel. The norm chooses the
 132 interpretation of the incoming signal for the current channel. For example,
 133 PAL or NTSC, or more specific variants there-of.
 134 </li>
 135 <li class="listitem">Channel frequency. If the current channel has the ability to tune
 136 between multiple frequencies (if it has the GST_TUNER_CHANNEL_FREQUENCY flag)
 137 then the frequency can be changed/retrieved via the
 138 <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-set-frequency" title="gst_tuner_set_frequency ()"><code class="function">gst_tuner_set_frequency()</code></a> and <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-get-frequency" title="gst_tuner_get_frequency ()"><code class="function">gst_tuner_get_frequency()</code></a> methods.
 139 </li>
 140 </ul></div>
 141 <p>
 142 </p>
 143 <p>
 144 Where applicable, the signal strength can be retrieved and/or monitored
 145 via a signal.
 146 </p>
 147 </div>
 148 <p>
 149 </p>
 150 </div>
 151 <div class="refsect1">
 152 <a name="gst-plugins-base-libs-gsttuner.details"></a><h2>Details</h2>
 153 <div class="refsect2">
 154 <a name="GstTuner-struct"></a><h3>GstTuner</h3>
 155 <pre class="programlisting">typedef struct _GstTuner GstTuner;</pre>
 156 </div>
 157 <hr>
 158 <div class="refsect2">
 159 <a name="GstTunerClass"></a><h3>struct GstTunerClass</h3>
 160 <pre class="programlisting">struct GstTunerClass {
 161   GTypeInterface klass;
 162
 163   /* virtual functions */
 164   const GList * (* list_channels)   (GstTuner        *tuner);
 165   void          (* set_channel)     (GstTuner        *tuner,
 166                                      GstTunerChannel *channel);
 167   GstTunerChannel *
 168                 (* get_channel)     (GstTuner        *tuner);
 169
 170   const GList * (* list_norms)      (GstTuner        *tuner);
 171   void          (* set_norm)        (GstTuner        *tuner,
 172                                      GstTunerNorm    *norm);
 173   GstTunerNorm *(* get_norm)        (GstTuner        *tuner);
 174
 175   void          (* set_frequency)   (GstTuner        *tuner,
 176                                      GstTunerChannel *channel,
 177                                      gulong           frequency);
 178   gulong        (* get_frequency)   (GstTuner        *tuner,
 179                                      GstTunerChannel *channel);
 180   gint          (* signal_strength) (GstTuner        *tuner,
 181                                      GstTunerChannel *channel);
 182
 183   /* signals */
 184   void (*channel_changed)   (GstTuner        *tuner,
 185                              GstTunerChannel *channel);
 186   void (*norm_changed)      (GstTuner        *tuner,
 187                              GstTunerNorm    *norm);
 188   void (*frequency_changed) (GstTuner        *tuner,
 189                              GstTunerChannel *channel,
 190                              gulong           frequency);
 191   void (*signal_changed)    (GstTuner        *tuner,
 192                              GstTunerChannel *channel,
 193                              gint             signal);
 194 };
 195 </pre>
 196 <p>
 197 Tuner interface.
 198 </p>
 199 <div class="variablelist"><table border="0">
 200 <col align="left" valign="top">
 201 <tbody>
 202 <tr>
 203 <td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="GstTunerClass.klass"></a>klass</code></em>;</span></p></td>
 204 <td>the parent interface</td>
 205 </tr>
 206 <tr>
 207 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.list-channels"></a>list_channels</code></em> ()</span></p></td>
 208 <td>list available channels</td>
 209 </tr>
 210 <tr>
 211 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.set-channel"></a>set_channel</code></em> ()</span></p></td>
 212 <td>set to a channel</td>
 213 </tr>
 214 <tr>
 215 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.get-channel"></a>get_channel</code></em> ()</span></p></td>
 216 <td>return the current channel</td>
 217 </tr>
 218 <tr>
 219 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.list-norms"></a>list_norms</code></em> ()</span></p></td>
 220 <td>list available norms</td>
 221 </tr>
 222 <tr>
 223 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.set-norm"></a>set_norm</code></em> ()</span></p></td>
 224 <td>set a norm</td>
 225 </tr>
 226 <tr>
 227 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.get-norm"></a>get_norm</code></em> ()</span></p></td>
 228 <td>return the current norm</td>
 229 </tr>
 230 <tr>
 231 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.set-frequency"></a>set_frequency</code></em> ()</span></p></td>
 232 <td>set the frequency</td>
 233 </tr>
 234 <tr>
 235 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.get-frequency"></a>get_frequency</code></em> ()</span></p></td>
 236 <td>return the current frequency</td>
 237 </tr>
 238 <tr>
 239 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.signal-strength"></a>signal_strength</code></em> ()</span></p></td>
 240 <td>get the signal strength</td>
 241 </tr>
 242 <tr>
 243 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.channel-changed"></a>channel_changed</code></em> ()</span></p></td>
 244 <td>default handler for channel changed notification</td>
 245 </tr>
 246 <tr>
 247 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.norm-changed"></a>norm_changed</code></em> ()</span></p></td>
 248 <td>default handler for norm changed notification</td>
 249 </tr>
 250 <tr>
 251 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.frequency-changed"></a>frequency_changed</code></em> ()</span></p></td>
 252 <td>default handler for frequency changed notification</td>
 253 </tr>
 254 <tr>
 255 <td><p><span class="term"><em class="structfield"><code><a name="GstTunerClass.signal-changed"></a>signal_changed</code></em> ()</span></p></td>
 256 <td>default handler for signal-strength changed notification</td>
 257 </tr>
 258 </tbody>
 259 </table></div>
 260 </div>
 261 <hr>
 262 <div class="refsect2">
 263 <a name="gst-tuner-list-channels"></a><h3>gst_tuner_list_channels ()</h3>
 264 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *       gst_tuner_list_channels             (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>);</pre>
 265 <p>
 266 Retrieve a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannels</span></a> available
 267 (e.g. 'composite', 's-video', ...) from the given tuner object.
 268 </p>
 269 <div class="variablelist"><table border="0">
 270 <col align="left" valign="top">
 271 <tbody>
 272 <tr>
 273 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 274 <td>the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> (a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>) to get the channels from.</td>
 275 </tr>
 276 <tr>
 277 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 278 <td>A list of channels available on this tuner. The list is
 279 owned by the GstTuner and must not be freed.</td>
 280 </tr>
 281 </tbody>
 282 </table></div>
 283 </div>
 284 <hr>
 285 <div class="refsect2">
 286 <a name="gst-tuner-get-channel"></a><h3>gst_tuner_get_channel ()</h3>
 287 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="returnvalue">GstTunerChannel</span></a> *   gst_tuner_get_channel               (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>);</pre>
 288 <p>
 289 Retrieve the current channel from the tuner.
 290 </p>
 291 <div class="variablelist"><table border="0">
 292 <col align="left" valign="top">
 293 <tbody>
 294 <tr>
 295 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 296 <td>the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> (a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>) to get the current channel from.</td>
 297 </tr>
 298 <tr>
 299 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 300 <td>the current channel of the tuner object.</td>
 301 </tr>
 302 </tbody>
 303 </table></div>
 304 </div>
 305 <hr>
 306 <div class="refsect2">
 307 <a name="gst-tuner-set-channel"></a><h3>gst_tuner_set_channel ()</h3>
 308 <pre class="programlisting"><span class="returnvalue">void</span>                gst_tuner_set_channel               (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 309                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>);</pre>
 310 <p>
 311 Tunes the object to the given channel, which should be one of the
 312 channels returned by <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-list-channels" title="gst_tuner_list_channels ()"><code class="function">gst_tuner_list_channels()</code></a>.
 313 </p>
 314 <div class="variablelist"><table border="0">
 315 <col align="left" valign="top">
 316 <tbody>
 317 <tr>
 318 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 319 <td>the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> (a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>) that owns the channel.</td>
 320 </tr>
 321 <tr>
 322 <td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 323 <td>the channel to tune to.</td>
 324 </tr>
 325 </tbody>
 326 </table></div>
 327 </div>
 328 <hr>
 329 <div class="refsect2">
 330 <a name="gst-tuner-list-norms"></a><h3>gst_tuner_list_norms ()</h3>
 331 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *       gst_tuner_list_norms                (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>);</pre>
 332 <p>
 333 Retrieve a GList of available <a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a> settings for the currently
 334 tuned channel on the given tuner object.
 335 </p>
 336 <div class="variablelist"><table border="0">
 337 <col align="left" valign="top">
 338 <tbody>
 339 <tr>
 340 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 341 <td>the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> (*a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>) to get the list of norms from.</td>
 342 </tr>
 343 <tr>
 344 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 345 <td>A list of norms available on the current channel for this
 346 tuner object. The list is owned by the GstTuner and must not
 347 be freed.</td>
 348 </tr>
 349 </tbody>
 350 </table></div>
 351 </div>
 352 <hr>
 353 <div class="refsect2">
 354 <a name="gst-tuner-get-norm"></a><h3>gst_tuner_get_norm ()</h3>
 355 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="returnvalue">GstTunerNorm</span></a> *      gst_tuner_get_norm                  (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>);</pre>
 356 <p>
 357 Get the current video norm from the given tuner object for the
 358 currently selected channel.
 359 </p>
 360 <div class="variablelist"><table border="0">
 361 <col align="left" valign="top">
 362 <tbody>
 363 <tr>
 364 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 365 <td>the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> (a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>) to get the current norm from.</td>
 366 </tr>
 367 <tr>
 368 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 369 <td>the current norm.</td>
 370 </tr>
 371 </tbody>
 372 </table></div>
 373 </div>
 374 <hr>
 375 <div class="refsect2">
 376 <a name="gst-tuner-set-norm"></a><h3>gst_tuner_set_norm ()</h3>
 377 <pre class="programlisting"><span class="returnvalue">void</span>                gst_tuner_set_norm                  (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 378                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a> *norm</code></em>);</pre>
 379 <p>
 380 Changes the video norm on this tuner to the given norm, which should be
 381 one of the norms returned by <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-list-norms" title="gst_tuner_list_norms ()"><code class="function">gst_tuner_list_norms()</code></a>.
 382 </p>
 383 <div class="variablelist"><table border="0">
 384 <col align="left" valign="top">
 385 <tbody>
 386 <tr>
 387 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 388 <td>the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> (a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>) to set the norm on.</td>
 389 </tr>
 390 <tr>
 391 <td><p><span class="term"><em class="parameter"><code>norm</code></em> :</span></p></td>
 392 <td>the norm to use for the current channel.</td>
 393 </tr>
 394 </tbody>
 395 </table></div>
 396 </div>
 397 <hr>
 398 <div class="refsect2">
 399 <a name="gst-tuner-get-frequency"></a><h3>gst_tuner_get_frequency ()</h3>
 400 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a>              gst_tuner_get_frequency             (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 401                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>);</pre>
 402 <p>
 403 Retrieve the current frequency from the given channel. As for
 404 <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-set-frequency" title="gst_tuner_set_frequency ()"><code class="function">gst_tuner_set_frequency()</code></a>, the <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> must support frequency
 405 operations, as indicated by the GST_TUNER_CHANNEL_FREQUENCY flag.
 406 </p>
 407 <div class="variablelist"><table border="0">
 408 <col align="left" valign="top">
 409 <tbody>
 410 <tr>
 411 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 412 <td>The <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> (a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>) that owns the given channel.</td>
 413 </tr>
 414 <tr>
 415 <td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 416 <td>The <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> to retrieve the frequency from.</td>
 417 </tr>
 418 <tr>
 419 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 420 <td>The current frequency, or 0 on error.</td>
 421 </tr>
 422 </tbody>
 423 </table></div>
 424 </div>
 425 <hr>
 426 <div class="refsect2">
 427 <a name="gst-tuner-set-frequency"></a><h3>gst_tuner_set_frequency ()</h3>
 428 <pre class="programlisting"><span class="returnvalue">void</span>                gst_tuner_set_frequency             (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 429                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>,
 430                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> frequency</code></em>);</pre>
 431 <p>
 432 Sets a tuning frequency on the given tuner/channel. Note that this
 433 requires the given channel to be a "tuning" channel, which can be
 434 checked using <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GST-TUNER-CHANNEL-HAS-FLAG:CAPS" title="GST_TUNER_CHANNEL_HAS_FLAG()"><code class="function">GST_TUNER_CHANNEL_HAS_FLAG()</code></a>, with the proper flag
 435 being GST_TUNER_CHANNEL_FREQUENCY.
 436 </p>
 437 <p>
 438 The frequency is in Hz, with minimum steps indicated by the
 439 frequency_multiplicator provided in the <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a>. The
 440 valid range is provided in the min_frequency and max_frequency properties
 441 of the <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a>.
 442 </p>
 443 <div class="variablelist"><table border="0">
 444 <col align="left" valign="top">
 445 <tbody>
 446 <tr>
 447 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 448 <td>The <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> (a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>) that owns the given channel.</td>
 449 </tr>
 450 <tr>
 451 <td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 452 <td>The <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> to set the frequency on.</td>
 453 </tr>
 454 <tr>
 455 <td><p><span class="term"><em class="parameter"><code>frequency</code></em> :</span></p></td>
 456 <td>The frequency to tune in to.</td>
 457 </tr>
 458 </tbody>
 459 </table></div>
 460 </div>
 461 <hr>
 462 <div class="refsect2">
 463 <a name="gst-tuner-signal-strength"></a><h3>gst_tuner_signal_strength ()</h3>
 464 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gst_tuner_signal_strength           (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 465                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>);</pre>
 466 <p>
 467 Get the strength of the signal on this channel. Note that this
 468 requires the current channel to be a "tuning" channel, i.e. a
 469 channel on which frequency can be set. This can be checked using
 470 <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GST-TUNER-CHANNEL-HAS-FLAG:CAPS" title="GST_TUNER_CHANNEL_HAS_FLAG()"><code class="function">GST_TUNER_CHANNEL_HAS_FLAG()</code></a>, and the appropriate flag to check
 471 for is GST_TUNER_CHANNEL_FREQUENCY.
 472 </p>
 473 <p>
 474 The valid range of the signal strength is indicated in the
 475 min_signal and max_signal properties of the <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a>.
 476 </p>
 477 <div class="variablelist"><table border="0">
 478 <col align="left" valign="top">
 479 <tbody>
 480 <tr>
 481 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 482 <td>the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> (a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>) that owns the given channel.</td>
 483 </tr>
 484 <tr>
 485 <td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 486 <td>the <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> to get the signal strength from.</td>
 487 </tr>
 488 <tr>
 489 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 490 <td>Signal strength, or 0 on error.</td>
 491 </tr>
 492 </tbody>
 493 </table></div>
 494 </div>
 495 <hr>
 496 <div class="refsect2">
 497 <a name="gst-tuner-find-norm-by-name"></a><h3>gst_tuner_find_norm_by_name ()</h3>
 498 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="returnvalue">GstTunerNorm</span></a> *      gst_tuner_find_norm_by_name         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 499                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *norm</code></em>);</pre>
 500 <p>
 501 Look up a <a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a> by name.
 502 </p>
 503 <div class="variablelist"><table border="0">
 504 <col align="left" valign="top">
 505 <tbody>
 506 <tr>
 507 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 508 <td>A <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> instance</td>
 509 </tr>
 510 <tr>
 511 <td><p><span class="term"><em class="parameter"><code>norm</code></em> :</span></p></td>
 512 <td>A string containing the name of a <a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a>
 513 </td>
 514 </tr>
 515 <tr>
 516 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 517 <td>A <a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a>, or NULL if no norm with the provided name
 518 is available.</td>
 519 </tr>
 520 </tbody>
 521 </table></div>
 522 </div>
 523 <hr>
 524 <div class="refsect2">
 525 <a name="gst-tuner-find-channel-by-name"></a><h3>gst_tuner_find_channel_by_name ()</h3>
 526 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="returnvalue">GstTunerChannel</span></a> *   gst_tuner_find_channel_by_name      (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 527                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *channel</code></em>);</pre>
 528 <p>
 529 Look up a <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> by name.
 530 </p>
 531 <div class="variablelist"><table border="0">
 532 <col align="left" valign="top">
 533 <tbody>
 534 <tr>
 535 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 536 <td>A <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> instance</td>
 537 </tr>
 538 <tr>
 539 <td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 540 <td>A string containing the name of a <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a>
 541 </td>
 542 </tr>
 543 <tr>
 544 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 545 <td>A <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a>, or NULL if no channel with the provided name
 546 is available.</td>
 547 </tr>
 548 </tbody>
 549 </table></div>
 550 </div>
 551 <hr>
 552 <div class="refsect2">
 553 <a name="gst-tuner-channel-changed"></a><h3>gst_tuner_channel_changed ()</h3>
 554 <pre class="programlisting"><span class="returnvalue">void</span>                gst_tuner_channel_changed           (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 555                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>);</pre>
 556 <p>
 557 Called by elements implementing the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> interface when the
 558 current channel changes. Fires the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner-channel-changed" title='The "channel-changed" signal'><span class="type">"channel-changed"</span></a> signal.
 559 </p>
 560 <div class="variablelist"><table border="0">
 561 <col align="left" valign="top">
 562 <tbody>
 563 <tr>
 564 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 565 <td>A <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> instance</td>
 566 </tr>
 567 <tr>
 568 <td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 569 <td>A <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> instance</td>
 570 </tr>
 571 </tbody>
 572 </table></div>
 573 </div>
 574 <hr>
 575 <div class="refsect2">
 576 <a name="gst-tuner-norm-changed"></a><h3>gst_tuner_norm_changed ()</h3>
 577 <pre class="programlisting"><span class="returnvalue">void</span>                gst_tuner_norm_changed              (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 578                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a> *norm</code></em>);</pre>
 579 <p>
 580 Called by elements implementing the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> interface when the
 581 current norm changes. Fires the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner-norm-changed" title='The "norm-changed" signal'><span class="type">"norm-changed"</span></a> signal.
 582 </p>
 583 <div class="variablelist"><table border="0">
 584 <col align="left" valign="top">
 585 <tbody>
 586 <tr>
 587 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 588 <td>A <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> instance</td>
 589 </tr>
 590 <tr>
 591 <td><p><span class="term"><em class="parameter"><code>norm</code></em> :</span></p></td>
 592 <td>A <a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a> instance</td>
 593 </tr>
 594 </tbody>
 595 </table></div>
 596 </div>
 597 <hr>
 598 <div class="refsect2">
 599 <a name="gst-tuner-frequency-changed"></a><h3>gst_tuner_frequency_changed ()</h3>
 600 <pre class="programlisting"><span class="returnvalue">void</span>                gst_tuner_frequency_changed         (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 601                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>,
 602                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> frequency</code></em>);</pre>
 603 <p>
 604 Called by elements implementing the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> interface when the
 605 configured frequency changes. Fires the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner-frequency-changed" title='The "frequency-changed" signal'><span class="type">"frequency-changed"</span></a>
 606 signal on the tuner, and the <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel-frequency-changed" title='The "frequency-changed" signal'><span class="type">"frequency-changed"</span></a> signal
 607 on the channel.
 608 </p>
 609 <div class="variablelist"><table border="0">
 610 <col align="left" valign="top">
 611 <tbody>
 612 <tr>
 613 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 614 <td>A <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> instance</td>
 615 </tr>
 616 <tr>
 617 <td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 618 <td>The current <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a>
 619 </td>
 620 </tr>
 621 <tr>
 622 <td><p><span class="term"><em class="parameter"><code>frequency</code></em> :</span></p></td>
 623 <td>The new frequency setting</td>
 624 </tr>
 625 </tbody>
 626 </table></div>
 627 </div>
 628 <hr>
 629 <div class="refsect2">
 630 <a name="gst-tuner-signal-changed"></a><h3>gst_tuner_signal_changed ()</h3>
 631 <pre class="programlisting"><span class="returnvalue">void</span>                gst_tuner_signal_changed            (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> *tuner</code></em>,
 632                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel</code></em>,
 633                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> signal</code></em>);</pre>
 634 <p>
 635 Called by elements implementing the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> interface when the
 636 incoming signal strength changes. Fires the <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner-signal-changed" title='The "signal-changed" signal'><span class="type">"signal-changed"</span></a>
 637 signal on the tuner and the <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel-signal-changed" title='The "signal-changed" signal'><span class="type">"signal-changed"</span></a> signal on
 638 the channel.
 639 </p>
 640 <div class="variablelist"><table border="0">
 641 <col align="left" valign="top">
 642 <tbody>
 643 <tr>
 644 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 645 <td>A <a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a> instance</td>
 646 </tr>
 647 <tr>
 648 <td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 649 <td>The current <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a>
 650 </td>
 651 </tr>
 652 <tr>
 653 <td><p><span class="term"><em class="parameter"><code>signal</code></em> :</span></p></td>
 654 <td>The new signal strength</td>
 655 </tr>
 656 </tbody>
 657 </table></div>
 658 </div>
 659 </div>
 660 <div class="refsect1">
 661 <a name="gst-plugins-base-libs-gsttuner.signal-details"></a><h2>Signal Details</h2>
 662 <div class="refsect2">
 663 <a name="GstTuner-channel-changed"></a><h3>The <code class="literal">"channel-changed"</code> signal</h3>
 664 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a>        *tuner,
 665                                                         <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel,
 666                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 667 <p>
 668 Reports that the current <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> has changed.
 669 </p>
 670 <div class="variablelist"><table border="0">
 671 <col align="left" valign="top">
 672 <tbody>
 673 <tr>
 674 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 675 <td>The element providing the GstTuner interface</td>
 676 </tr>
 677 <tr>
 678 <td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 679 <td>The new configured channel.</td>
 680 </tr>
 681 <tr>
 682 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 683 <td>user data set when the signal handler was connected.</td>
 684 </tr>
 685 </tbody>
 686 </table></div>
 687 </div>
 688 <hr>
 689 <div class="refsect2">
 690 <a name="GstTuner-frequency-changed"></a><h3>The <code class="literal">"frequency-changed"</code> signal</h3>
 691 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a>        *tuner,
 692                                                         <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *frequency,
 693                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a>           arg2,
 694                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 695 <p>
 696 Reports that the current frequency has changed.
 697 </p>
 698 <div class="variablelist"><table border="0">
 699 <col align="left" valign="top">
 700 <tbody>
 701 <tr>
 702 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 703 <td>The element providing the GstTuner interface</td>
 704 </tr>
 705 <tr>
 706 <td><p><span class="term"><em class="parameter"><code>frequency</code></em> :</span></p></td>
 707 <td>The new frequency (an unsigned long)</td>
 708 </tr>
 709 <tr>
 710 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 711 <td>user data set when the signal handler was connected.</td>
 712 </tr>
 713 </tbody>
 714 </table></div>
 715 </div>
 716 <hr>
 717 <div class="refsect2">
 718 <a name="GstTuner-norm-changed"></a><h3>The <code class="literal">"norm-changed"</code> signal</h3>
 719 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a>     *tuner,
 720                                                         <a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a> *norm,
 721                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 722 <p>
 723 Reports that the current <a class="link" href="gst-plugins-base-libs-gsttunernorm.html#GstTunerNorm"><span class="type">GstTunerNorm</span></a> has changed.
 724 </p>
 725 <div class="variablelist"><table border="0">
 726 <col align="left" valign="top">
 727 <tbody>
 728 <tr>
 729 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 730 <td>The element providing the GstTuner interface</td>
 731 </tr>
 732 <tr>
 733 <td><p><span class="term"><em class="parameter"><code>norm</code></em> :</span></p></td>
 734 <td>The new configured norm.</td>
 735 </tr>
 736 <tr>
 737 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 738 <td>user data set when the signal handler was connected.</td>
 739 </tr>
 740 </tbody>
 741 </table></div>
 742 </div>
 743 <hr>
 744 <div class="refsect2">
 745 <a name="GstTuner-signal-changed"></a><h3>The <code class="literal">"signal-changed"</code> signal</h3>
 746 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-base-libs-gsttuner.html#GstTuner"><span class="type">GstTuner</span></a>        *tuner,
 747                                                         <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a> *channel,
 748                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>             signal,
 749                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 750 <p>
 751 Reports that the signal strength has changed.
 752 </p>
 753 <p>
 754 See Also: <a class="link" href="gst-plugins-base-libs-gsttuner.html#gst-tuner-signal-strength" title="gst_tuner_signal_strength ()"><code class="function">gst_tuner_signal_strength()</code></a>
 755 </p>
 756 <div class="variablelist"><table border="0">
 757 <col align="left" valign="top">
 758 <tbody>
 759 <tr>
 760 <td><p><span class="term"><em class="parameter"><code>tuner</code></em> :</span></p></td>
 761 <td>The element providing the GstTuner interface</td>
 762 </tr>
 763 <tr>
 764 <td><p><span class="term"><em class="parameter"><code>channel</code></em> :</span></p></td>
 765 <td>The current <a class="link" href="gst-plugins-base-libs-gsttunerchannel.html#GstTunerChannel"><span class="type">GstTunerChannel</span></a>
 766 </td>
 767 </tr>
 768 <tr>
 769 <td><p><span class="term"><em class="parameter"><code>signal</code></em> :</span></p></td>
 770 <td>The new signal strength (an integer)</td>
 771 </tr>
 772 <tr>
 773 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 774 <td>user data set when the signal handler was connected.</td>
 775 </tr>
 776 </tbody>
 777 </table></div>
 778 </div>
 779 </div>
 780 </div>
 781 <div class="footer">
 782 <hr>
 783           Generated by GTK-Doc V1.18</div>
 784 </body>
 785 </html>