Forgotten documentation part of radio support patch

by Vladimir Voroshilov (voroshil gmail com)


git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@19578 b3059339-0415-0410-9bf9-f77b7e298cf2

2 files changed, 234 insertions, 0 deletions

diff --git a/DOCS/xml/en/radio.xml b/DOCS/xml/en/radio.xml
new file mode 100644
index 0000000000..f955368d7e
--- /dev/null
+++ b/DOCS/xml/en/radio.xml
@@ -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>
diff --git a/DOCS/xml/ru/radio.xml b/DOCS/xml/ru/radio.xml
new file mode 100644
index 0000000000..c7f93afe5e
--- /dev/null
+++ b/DOCS/xml/ru/radio.xml
@@ -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>