<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&krec;">
  <!ENTITY package "kdemultimedia">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Russian "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title
>Справочное руководство по &krec;</title>

<authorgroup>
<author
><firstname
>Arnold</firstname
> <surname
>Krille</surname
> <affiliation
> <address
><email
>arnold@arnoldarts.de</email
></address>
</affiliation>
</author>
</authorgroup>

<othercredit role="translator"
><firstname
>Руслан</firstname
><surname
>Будаев</surname
><affiliation
><address
><email
>fokses@pisem.net</email
></address
></affiliation
><contrib
>Перевод на русский</contrib
></othercredit
> 

<copyright>
<year
>2002</year>
<holder
>Arnold Krille</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-08-20</date>
<releaseinfo
>0.01.00</releaseinfo>

<abstract>
<para
>&krec; - это графическая оболочка для записи звука с помощью &arts;. Он может быть использован как для однократной записи, так и для сеансов записи. В нем реализованы динамические эффекты, а также возможно воспроизведение записываемого файла (если вы не записываете то, что воспроизводите). </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>KRec</keyword>
<keyword
>aRts</keyword>
<keyword
>запись</keyword>
<keyword
>оболочка</keyword>
</keywordset>

</bookinfo>
 
<chapter id="introduction">
<title
>Введение</title>

<sect1 id="why-krec">
<title
>Почему написан &krec;</title>

<para
>Поработав с &arts;, я обнаружил, что не существует графической оболочки для такого инструмента, как <command
>artsrec</command
>. Мне потребовалось записать несколько песен по радио для их обработки и микширования, и я хотел использовать &Linux; для этой цели. Так у меня возникла идея написать &krec;. </para>
</sect1>

<sect1 id="what-krec-does">
<title
>Что умеет &krec;</title>

<para
>Функция &krec; очень проста. Он соединяется с сервером &arts; и записывает все, что было принято последним, в файл. </para>
<para
>На данный момент &krec; записывает только "сырые файлы", которые отличаются от обычных wav-файлов отсутствием wav-заголовка (поэтому используйте <application
>sox</application
> для добавления такого заголовка). </para>
</sect1>

</chapter>

<chapter id="using-krec">
<title
>Использование &krec;</title>

<para
>Эта глава описывает возможности &krec;. Есть несколько путей использования &krec;, так что я создал несколько разделов, подобных <quote
>HOWTO</quote
>, которые освещают возможности программы. Просто прочитайте первый абзац каждого раздела и решите, что вам нужно читать дальше. Или читайте всё подряд и осваивайте все возможности &krec;.</para>

<screenshot>
<screeninfo
>Скриншот &krec;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="krec-hicolor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Это скриншот &krec;.</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect1 id="simple-usage">
<title
>Запись в файл</title>

<para
>Если вы слушаете трансляцию по радио и хотели бы её записать (а ваше радио подсоединено к звуковой карте), вот что вам нужно сделать. </para>

<orderedlist>
<listitem>
<para
>Прежде всего, выберите источник записи на вашей звуковой карте. Вам будет необходим микшер (&kmix;), где вы должны указать источник для записи. Также может понадобиться запустить &arts;-сервер в полнодуплексном режиме (если ваша звуковая карта и драйвер поддерживают его). Если вам надо перезагрузить &arts;, следует также перезагрузить и &krec; </para>
</listitem>
<listitem>
<para
>Затем откройте в модуле управления &arts; панель "Менеджер аудио". Там вы увидите два новых элемента: krec::In и krec::Out. Последний предназначен для воспроизведения и не рассматривается здесь. Первый требует вашего внимания: источник звука должен быть подключен к порту <emphasis
>in_soundcard</emphasis
>. Если вы не можете его активизировать, то что-то неправильно настроено (например, отключена поддержка полнодуплексного режима и т. д.).</para>
</listitem>
<listitem>
<para
>Если всё работает правильно, вы увидите движущийся индикатор внутри &krec; - VU-Meter - он показывает уровень громкости записи. Для хорошего качества без зашкаливания он должен быть желтым или оранжевым, но не красным. Регулятор справа от индикатора VU позволяет управлять уровнем записи.</para>
</listitem>
<listitem>
<para
>Можно приступать к записи файла. Выберите <menuchoice
><guimenu
>Файл</guimenu
><guimenuitem
>Новый файл</guimenuitem
></menuchoice
> или просто щёлкните по соответствующей иконке на панели инструментов. После этого вам необходимо указать имя файла для записи в контекстном меню.</para>
</listitem>
<listitem>
<para
>Теперь можно начинать запись. Нажмите большую красную кнопку в панели инструментов, выберите <guimenu
>Воспроизведение</guimenu
> <guimenuitem
>Запись</guimenuitem
>, или просто нажмите клавишу <keycap
>R</keycap
>. Для останова используйте кнопку на панели инструментов, пункт в меню <guimenu
>Воспроизведение</guimenu
>, или клавишу <keycap
>S</keycap
>.</para>
</listitem>
</orderedlist>

<para
>Бесспорно, это не столь же просто, как нажать на кнопку записи на магнитофоне, но, поверьте, &krec; имеет больше возможностей, чем ваш магнитофон.</para>

<tip>
<para
>Вы можете записывать и из других источников. Для теста возьмите исходящий сигнал &noatun;. Соедините порт &krec;::In с <emphasis
>out_soundcard</emphasis
> (или любым другим портом по выбору). Это будет работать, даже если вы не активизировали полнодуплексный режим в &arts;.</para>
</tip>
</sect1>

<sect1 id="advanced-usage">
<title
>Запись нескольких файлов</title>

<para
>Этот раздел для тех, кто хотел бы записать несколько маленьких или больших отрывков в несколько файлов. К примеру, вы хотите записать несколько песен с радио или что-либо подобное (что и было причиной написания &krec;). </para>

<para
>Я предполагаю, что вы уже умеете работать с &arts; и обладаете некоторыми начальными знаниями в области <quote
>аудиозаписи</quote
>. Ваш микрофон (или любое другое входное устройство) должен быть подсоединен к компьютеру и сконфигурирован (отдельно от &krec;), чтобы было что записывать - присутствовал входящий сигнал. </para>

<para
>Давайте возьмем в качестве примера запись передачи по радио. Вам надо решить, как называть все записи: все по-разному или же с одним именем, но с различными номерами. О первом способе можно прочитать в разделе <xref linkend="simple-usage"/>. Отметьте, что можно открывать несколько файлов одновременно и выбирать, в какой из них вести запись. Второй способ описан далее... </para>

<orderedlist>
<listitem
><para
>Прежде всего убедитесь, что все правильно настроено, в особенности, что вы действительно подключили нужный источник звука. Вы можете удостовериться, что всё в порядке, если индикатор VU в &krec; находится в движении. Если вы не записываете с порта <emphasis
>out_soundcard</emphasis
> звуковой карты, выберите <guimenu
>Воспроизведение</guimenu
> <guimenuitem
>Прослушивание</guimenuitem
> для того, чтобы записываемый сигнал был соединен с исходящим цифровым потоком звуковой карты. Я предпочитаю этот способ, а не использование микшера звуковой карты, поскольку при этом можно слышать, не слишком ли громко или тихо идет запись.</para
></listitem>
<listitem
><para
>Для нескольких файлов с одним именем вам нужно открыть сеанс: <guimenu
>Файл</guimenu
> <guimenuitem
>Новый сеанс</guimenuitem
>. Введите путь и имя файла, которое будет дополнено номером записи.</para
></listitem>
<listitem
><para
>Необходимо создать файлы для записи: <guimenuitem
>Новый файл</guimenuitem
> из контекстного меню. Вы можете создавать столько файлов, сколько понадобится.</para
></listitem>
<listitem
><para
>Оставшиеся шаги не сложны. Выбираете файл для записи и начинаете...</para
></listitem>
</orderedlist>

<note
><para
>Сеанс - это не файл известного типа mime, и даже вовсе не файл. Это просто возможность организовать нумерацию. Поэтому вы не сможете в дальнейшем заново открыть сеанс и продолжить запись в новые файлы. </para
></note>
</sect1>

<sect1 id="more-usage">
<title
>Полезные советы и замечания по использованию</title>

<para
>Есть и другие возможности, которые нужно объяснить.</para>

<sect2 id="usage-play-through">
<title
>Использование прослушивания</title>

<para
>Для тех, кто хочет слышать, что они записывают, существует очень полезная возможность <quote
>прослушивания</quote
>. Ее можно найти в меню <guimenu
>Воспроизведение</guimenu
>. Я советую использовать ее всякий раз, когда это возможно, особенно если вы используете компрессор звука или другие эффекты. Подробнее об этом смотрите <xref linkend="internals"/>.</para>

<caution>
<para
>Убедитесь, что вы не запустили петлю обратной связи при записи с <emphasis
>out_soundcard</emphasis
> и активизации прослушивания. Это будет чересчур сильным испытанием для бедного &arts;, который будет тормозить систему или повиснет...</para>
</caution>

</sect2>

<sect2 id="using-compressor">
<title
>Использование компрессора</title>

<para
>При записи с микрофона, особенно при записи речи, вы можете заметить, что уровень иногда зашкаливает, а иногда очень низок. Для корректировки этого можно использовать компрессор. Он уменьшает весь звуковой поток, превышающий заданный порог громкости, умножая его на заданное значение, соответственно записанный звук будет громче или тише. Параметры Attack и Release задают временную задержку, когда будет включаться и отключаться компрессор после превышения порога или возвращения уровня к допороговому значению. </para>
<tip
><para
>Протестируйте эту возможность. Если вы говорите в микрофон и прослушивание включено, вы должны услышать различия.</para
></tip>
</sect2>

<sect2 id="usage-switching-file">
<title
>Переключение между несколькими файлами</title>

<para
>Вы не только имеете возможность открывать несколько файлов одновременно, но и можете переключаться между ними. Причем вовсе не обязательно после остановки записи, но и во время ее. Учтите, что при этом некоторые пакеты могут быть утеряны. Сколько именно, зависит от размера аудиобуфера для &arts;, указанного в &kcontrol;. Конечно, это не будет очень много, но если вы будете проигрывать файлы подряд (например, командой <command
>artscat file*.raw</command
>), вы можете услышать небольшие <quote
>провалы</quote
>.</para>
</sect2>

</sect1>
 
<sect1 id="internals">
<title
>Включения</title>

<para
>Несколько слов про связи аудиообъектов в &krec;. </para>
<para
>Есть несколько объектов, участвующих в записи с помощью &arts;: это synth_AMAN_RECORD, конвертер AudioToByteStream и ByteStreamReceiver. Первый и второй из них встроены в &arts;-сервер, а последний - в программу. Но это только базовый набор. Если вы хотите прослушивать файлы, вам также понадобятся ByteStreamSender в программе и конвертер ByteStreamToAudio и synth_AMAN_PLAY в сервере. </para>
<para
>Что такое эффекты? Между AMAN_RECORD и AudioToByteStream я вставил StereoEffectStack, к которому подсоединил компрессор (synth_STEREO_COMPRESSOR) и регулятор громкости (StereoVolumeControl). </para>
<para
>При включении прослушивания набор эффектов также подключается к AMAN_PLAY. Все это происходит внутри &arts;-сервера. </para>
</sect1>

</chapter>

<chapter id="commands">
<title
>Справочник по командам</title>

<sect1 id="krec-mainwindow">
<title
>Главное окно &krec;</title>

<sect2>
<title
>Меню <guimenu
>Файл</guimenu
></title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Файл</guimenu
> <guimenuitem
>Новый файл</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Создание нового файла для записи в один файл</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Файл</guimenu
> <guimenuitem
>Новый сеанс</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Создание нового сеанса для нескольких записей</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Файл</guimenu
> <guimenuitem
>Выход</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Выход из &krec;</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2>
<title
>Меню <guimenu
>Воспроизведение</guimenu
></title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Воспроизведение</guimenu
> <guimenuitem
>Воспроизвести</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Воспроизведение выбранных файлов.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Воспроизведение</guimenu
> <guimenuitem
>Запись</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Запись в выбранный файл.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Воспроизведение</guimenu
> <guimenuitem
>Стоп</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Остановить запись.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Воспроизведение</guimenu
> <guimenuitem
>Прослушивание</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Перенаправление входящего потока в исходящий для того, чтобы вы могли слушать то, что записываете.</action
> (krec::In и krec::Out в разделе Менеджер аудио модуля управления &arts;).</para>
<caution
><para
>Никогда не используйте это во время записи с выхода звуковой платы (с out_soundcard). Это создает звуковой поток, который &arts; не в состоянии обработать.</para
></caution>
</listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

<sect2>
<title
>Меню <guimenu
>Параметры</guimenu
> </title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Параметры</guimenu
> <guimenuitem
>Показывать заставку</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Включить показ заставки с кратким руководством при запуске программы.</action
></para
></listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

<sect2>
<title
>Меню <guimenu
>Справка</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="startupwindow">
<title
>Заставка</title>

<para
>Заставка - это те же самые полезные советы при запуске. </para>
</sect1>

</chapter>

<chapter id="faq">
<title
>Вопросы и ответы</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist"
> <qandaentry>
<question>
<para
>Я записал несколько файлов с помощью &krec;, но не могу воспроизвести эти файлы с помощью моего любимого плеера?</para>
</question>
<answer>
<para
>&krec; пока может записывать только "сырые" файлы, а не wav-файлы. Для конвертации вы можете, к примеру, использовать sox.</para>
<example id="converting-with-sox">
<title
>Конвертация "сырых" файлов в wav-файл с помощью sox</title>
<para
>Для преобразования "сырого" файла, полученного с помощью &krec;, используйте следующую команду в консоли (&konsole;). Предполагается, что <command
>sox</command
> установлен. В этом примере "сырой" файл test.raw конвертируется в аудио-файл test.wav. </para>
<para
><screen
><prompt
>&percnt;</prompt
><command
>sox -r 44100 -c 2 -s -w test.raw 
test.wav</command
>
</screen
></para>
<para
>Параметры <option
>-r 44100 -c 2 -s -w</option
> сообщают команде <command
>sox</command
>, что вы записали файл с 44100 кГц, стерео (2 канала), 16 бит и линейным кодированием со знаком. Можете также использовать и другие аргументы - смотрите man-страницу для <command
>sox</command
>. </para>
</example>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">
<title
>Разработчики и лицензирование</title>

<para
>&krec; </para>
<para
>Program copyright 2002 Arnold Krille<email
>arnold@arnoldarts.de</email
> </para>


<para
>Documentation copyright 2002 Arnold Krille <email
>arnold@arnoldarts.de</email
> </para>

<para
>Перевод на русский: Руслан Будаев <email
>fokses@pisem.net</email
></para
><para
>Редакция русского перевода: Григорий Мохин <email
>mok@kde.ru</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Установка</title>

<sect1 id="getting-krec">
<title
>Как получить &krec;</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Требования</title>

<para
>Для использования &krec; вам необходим &kde; 3.1. </para>

<para
>&krec; входит в состав пакета kdemultimedia. Как и остальным программам этого пакета, ему требуется запущенный &kde; и &arts;. Если это так, то всё должно работать без проблем. </para>


</sect1>

<sect1 id="compilation">
<title
>Сборка и установка</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
End:
-->