[MPlayer-dev-eng] [PATCH] Radio support

[Vladimir Voroshilov]

Reimar D?ffinger wrote: 
> Finally applied, with minor changes:
In addition to my previous letter.
Seem like missing update of DOCS/xml/(en,ru)/radio.xml
while DOCS/xml/(en,ru)/features.xml files were updated.
Thus links to radio documentation page now is broken.

Missed files are in attached patch.


-- 
Vladimir Voroshilov mailto:voroshli at univer.omsk.su
Omsk State University
JID: voroshil at jabber.ru
ICQ: 95587719
-------------- next part --------------
Index: DOCS/xml/ru/radio.xml
===================================================================
--- DOCS/xml/ru/radio.xml	(revision 0)
+++ DOCS/xml/ru/radio.xml	(revision 0)
@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="koi8-r"?>
+<!-- $Revision: 17322 $ -->
+<chapter id="tv">
+<title>Radio</title>
+
+<sect1 id="radio" xreflabel="Radio">
+<title>Radio</title>
+
+<para>
+? ???? ?????? ??????????? ??? ???????? <emphasis role="bold">????????????? 
+????? ??? ?????? V4L ???????????? ????? ??????</emphasis>. ???????? man ???????? ??? 
+????????  ????? ? ?????? ??????????.
+</para>
+
+
+<sect2 id="radio-compilation">
+<title>??????????</title>
+
+<procedure>
+<step><para>
+  ??-??????, ??? ?????????? ????????????????? <application>MPlayer</application> ???
+  ?????? <filename>./configure</filename> ? ????????? ?????
+  --enable-radio ? (???? ?????? ???????? ????????? ??????) --enable-radio-capture.
+  </para></step>
+<step><para>
+  ?????????, ??? ??? ????? ???????? ? ??????? ???????????? ? Linux, ????????
+  <application>XawTV</application>.
+  </para></step>
+</procedure>
+</sect2>
+
+<sect2 id="radio-tips">
+<title>?????? ?? ?????????????</title>
+<para>
+?????? ?????? ????? ???????? ?? ????????? ??????????? (man).
+??? ????? ????????? ???????:
+</para>
+<itemizedlist>
+<listitem>
+<para>
+????????????? <option>channels</option> ?????. ?????:
+<screen>-radio channels=104.4-Sibir,103.9-Maximum</screen>
+??????????: ??? ???????? ???? ?????, ????? ???????? ?????? ???????????? 
+104.4 ? 103.9. ????? ????, ????? ???????? OSD ????? ??? ???????????? ????? ????????,
+???????????? ???????? ??????. ??????? ? ????????? ??????? ?????? ???? ????????
+???????? &quot;_&quot;
+</para>
+</listitem>
+
+<listitem>
+<para>
+???? ????????? ????? ??????? ?????. ?? ?????? ???????? ????, ???? ????????? ????
+???????? ????? ? ??????? ??????, ??????????? ????? ????? ? ???????? ????[line-in],
+???? ????????? ?????????? ADC ?? ? ???? saa7134. ? ???? ??????, ?? ??????
+????????? ??????? <emphasis role="bold">saa7134-alsa</emphasis> ??? 
+<emphasis role="bold">saa7134-oss</emphasis>. 
+</para>
+</listitem>
+
+<listitem>
+<para>
+<application>MEncoder</application> ?? ????? ???? ??????????? ??? ??????? ?????,
+????????? ?? ??????? ????????????? ??????? ?????-??????.????? ???????, ?? ?????? 
+?????????? ?????? ???? ????????? ????????? arecord ?? ??????? ALSA ???? ????????? 
+<option>-ao pcm:file=file.wav</option>. ?? ?????? ?????? ?? ?? ?????? ??????? ?????? ?? 
+????? ??????? (?? ?????????? ??????, ????? ?? ??????????? line-in ??????, ? ???????? 
+???? ??????????????? ? ????????? ?????.
+</para>
+</listitem>
+</itemizedlist>
+</sect2>
+
+<sect2 id="radio-examples">
+<title>???????</title>
+
+
+<informalexample>
+<para>
+???? ?? ???????????? V4L (????????? line-in ??????. ?????? ?????????.):
+<screen>
+mplayer radio://104.4<!--
+--></screen>
+</para>
+</informalexample>
+
+<informalexample>
+<para>
+???? ?? ???????????? V4L (????????? line-in ??????. ?????? ?????????. ??????????? ????????? V4Lv1):
+<screen>
+mplayer -radio driver=v4l radio://104.4<!--
+--></screen>
+</para>
+</informalexample>
+
+<informalexample>
+<para>
+????????????? ?????? ???????????? ?? ??????:
+<screen>
+mplayer -radio channels=104.4=Sibir,103.9=Maximm  radio://2<!--
+--></screen>
+</para>
+</informalexample>
+
+<informalexample>
+<para>
+????????? ????? ????? ???? pci ? ??????????? ADC ????? ??????. ? ???? ???????
+????? ???????????? ??? ??????? ???????? ????? (ALSA ?????????? hw:1,0). 
+??? ????, ?????????? ?? saa7134 ???? saa7134-alsa ????  saa7134-oss ?????? ?????? ????
+????????. ?????????: ??? ????????????? ???? ????????? ALSA, ????????? ?????????? ???????? ??
+?????????, ??????? - ?? ?????. 
+<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>
Index: DOCS/xml/en/radio.xml
===================================================================
--- DOCS/xml/en/radio.xml	(revision 0)
+++ DOCS/xml/en/radio.xml	(revision 0)
@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 17322 $ -->
+<chapter id="tv">
+<title>Radio</title>
+
+<sect1 id="radio" xreflabel="Radio">
+<title>Radio</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>