annotate DOCS/xml/en/radio.xml @ 19583:94e4ef4195d3

Fix build after radio commit, patch by Jindrich Makovicka.

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 17322 $ -->
<chapter id="radio">
<title>Radio</title>

<sect1 id="radio-input" xreflabel="Radio input">
<title>Radio input</title>

<para>
This section is about how to enable <emphasis role="bold">listening
from V4L compatible Radio tuner</emphasis>. See the man page for a description
of Radio options and keyboard controls.
</para>


<sect2 id="radio-compilation">
<title>Compilation</title>

<procedure>
<step><para>
  First, you have to recompile MPlayer using <filename>./configure</filename> with
  --enable-radio and (if you want capture support) --enable-radio-capture.
  </para></step>
<step><para>
  Make sure your tuner works with another radio software in Linux, for
  example <application>XawTV</application>.
  </para></step>
</procedure>
</sect2>

<sect2 id="radio-tips">
<title>Usage tips</title>
<para>
The full listing of the options is available on the manual page.
Here are just a few tips:
</para>
<itemizedlist>
<listitem>
<para>
Use the <option>channels</option> option. An example:
<screen>-radio channels=104.4-Sibir,103.9-Maximum</screen>
Explanation: using this option, only the 104.4 and 103.9 radio stations
will be usable, and there will be a nice OSD text upon channel switching, displaying the
channel's name. Spaces in the channel name must be replaced by the
&quot;_&quot; character.
</para>
</listitem>

<listitem>
<para>
There are several ways of capturing audio. You can grab the sound either using
your sound card via an external cable connection between video card and line-in,
or using the built-in ADC in the saa7134 chip. In the latter case, you have to
load the <emphasis role="bold">saa7134-alsa</emphasis> or 
<emphasis role="bold">saa7134-oss</emphasis> driver. 
</para>
</listitem>

<listitem>
<para>
<application>MEncoder</application> cannot be used for audio capture, because it
requires video stream to work. So your can either use arecord from ALSA project or 
use <option>-ao pcm:file=file.wav</option>. In second case you will not hear any sound
(except you using line-in cable and have switched line-in mute off)
</para>
</listitem>
</itemizedlist>
</sect2>


<sect2 id="radio-examples">
<title>Examples</title>


<informalexample>
<para>
Input from standard V4L (using line-in cable. capture switched off):
<screen>
mplayer radio://104.4<!--
--></screen>
</para>
</informalexample>

<informalexample>
<para>
Input from standard V4L (using line-in cable. capture switched off, V4Lv1 interface):
<screen>
mplayer -radio driver=v4l radio://104.4<!--
--></screen>
</para>
</informalexample>

<informalexample>
<para>
Playing second channel from channel list:
<screen>
mplayer -radio channels=104.4=Sibir,103.9=Maximm  radio://2<!--
--></screen>
</para>
</informalexample>

<informalexample>
<para>
Using sound through pci bus from radio card's internal ADC. In this example tuner used as second sound card 
(ALSA device hw:1,0). For saa7134 based cards either saa7134-alsa or saa7134-oss module must be 
loaded . NOTE: when using ALSA device names colons must be replaced with equals, commas with dots. 
<screen>
mplayer -rawaudio rate=32000 -radio adevice=hw=1.0:arate=32000:channels=104.4=Sibir,103.9=Maximm  radio://2/capture<!--
--></screen>
</para>
</informalexample>
</sect2>
</sect1>

</chapter>