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
This commit is contained in:
reimar 2006-08-28 18:43:46 +00:00
parent c83c0bea03
commit 821a2a5656
2 changed files with 234 additions and 0 deletions

115
DOCS/xml/en/radio.xml Normal file
View File

@ -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>

119
DOCS/xml/ru/radio.xml Normal file
View File

@ -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>