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

<book lang="&language;">

<bookinfo>
<title
>Руководство &kmix;</title>

<authorgroup>
<author
><firstname
>Matt</firstname
> <surname
>Johnston</surname
> <affiliation
> <address
><email
>mattj@flashmail.com</email
></address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>Christian</firstname
> <surname
>Esken</surname
> <affiliation
><address
><email
>esken@kde.org</email
></address
></affiliation>
<contrib
>Разработчик</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Helio</firstname
> <surname
>Chissini de Castro</surname
> <affiliation
><address
><email
>helio@kde.org</email
></address
></affiliation>
<contrib
>Разработчик</contrib>
</othercredit>


<othercredit role="developer"
><firstname
>Stefan</firstname
> <surname
>Schimanski</surname
> <affiliation
><address
><email
>1Stein@gmx.de</email
></address
></affiliation>
<contrib
>Разработчик</contrib>
</othercredit>

<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
<contrib
>Редактор</contrib>
</othercredit>
<othercredit role="translator"
><firstname
>Григорий</firstname
><surname
>Мохин</surname
> <affiliation
><address
><email
>mok@kde.ru</email
></address
></affiliation
> <contrib
>Перевод на русский</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>1996</year
><year
>2003</year>
<holder
>Christian Esken &amp; Matt Johnston</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2003-04-24</date>
<releaseinfo
>1.91.00</releaseinfo>

<abstract
><para
>&kmix; - это программа, с помощью которой вы можете регулировать громкость звуковой платы.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KMix</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>sound</keyword>
<keyword
>volume</keyword>
<keyword
>mixer</keyword>
</keywordset>

</bookinfo>

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

<para
>&kmix; - это микшер для звуковых плат, входящий в состав &kde;. Это маленькая, но полнофункциональная утилита, позволяющая управлять всеми вашими звуковыми платами.</para>

<para
>&kmix; поддерживает различные платформы и драйверы. Версия 1.91 работает с:</para>

<itemizedlist>
<listitem
><para
>всеми платформами Open Sound System, что было проверено на &Linux;, FreeBSD, NetBSD и BSDI.</para
></listitem>
<listitem
><para
>&Solaris;.</para
></listitem>
<listitem
><para
>&IRIX;.</para
></listitem>
<listitem
><para
>Звуковыми драйверами ALSA.</para
></listitem>
<listitem
><para
>&HP-UX;.</para
></listitem>
</itemizedlist>

</chapter>

<chapter id="working-with-kmix">
<title
>Как работать с &kmix;</title>

<para
>Использовать &kmix; очень просто. Каждое устройство микшера, найденное на звуковой плате, представлено ползунком - регулятором громкости. Устройства моно имеют один ползунок, стерео - один или два, как вы сами пожелаете. Дополнительно к этому есть регулятор баланса внизу окна &kmix;. Если у вас несколько звуковых плат, каждая из них отображается на отдельной вкладке.</para>

<sect1 id="volume-sliders">
<title
>Регуляторы громкости.</title>

<para
>У ползунков - регуляторов громкости - есть контекстное меню, выпадающее при нажатии правой кнопкой мыши. Всего есть несколько пунктов меню, но из них показываются только те, которые можно выбрать</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Разделить каналы</guilabel
></term>
<listitem
><para
>Показать один или оба ползунка. Применимо только для стерео-устройств. Правый ползунок регулирует правый канал, левый - левый.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Звук выключен</guilabel
></term>
<listitem
><para
>Отключить или включить устройство.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Скрыть</guilabel
></term>
<listitem
><para
>Если вам не нужно данное устройство, его показ можно отключить. Снова его можно будет показать только выбрав <guilabel
>Показать все</guilabel
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Привязки клавиш</guilabel
></term>
<listitem
><para
>Чтобы управлять устройством с клавиатуры, через этот пункт можно вызвать диалог KDE <guilabel
>Быстрые клавиши</guilabel
>. Клавиши для увеличения и уменьшения громкости работают глобально, в том числе и тогда, когда &kmix; свёрнут или встроен в панель.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Показать все</guilabel
></term>
<listitem
><para
>Показать все устройства, в том числе и скрытые ранее через пунтк <guilabel
>Скрыть</guilabel
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Показать меню</guilabel
></term>
<listitem
><para
>Меню микшера можно скрыть и вернуть обратно, также и с помощью быстрой клавиши (по умолчанию CTRL-M).</para
></listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="panning-slider">
<title
>Регулятор баланса</title>

<para
>С помощью этого ползунка вы можете регулировать баланс громкости между левым и правым каналом. Этот регулятор действует на все стерео-устройства одновременно (моно-устройства игнорируются). По умолчанию ползунок располагается посередине. Перемещение ползунка влево снижает громкость правого канала, вправо - левого. Конечно, это можно изменить, если у вас перепутаны сами колонки.</para
> 

</sect1>

<sect1 id="configuration-options">
<title
>Общие настройки</title>

<para
>Если иконка &kmix; встроена в панель, нажав на ней правой кнопкой, вы можете настроить микшер. В меню есть следующие пункты:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Встроить в панель</guilabel
></term>
<listitem
><para
>запускать в виде пиктограммы, встроенной в панель</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Использовать регулятор громкости в панели задач</guilabel
></term>
<listitem
><para
>При выборе этой опции &kmix; будет встраиваться в панель при закрытии главного окна. Если она отключена, то &kmix; будет закрыт, и вы не сможете управлять громкостью с помощью клавиш, которые вы назначили для этого действия.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Показать деления шкалы</guilabel
></term>
<listitem
><para
>Показывает штрихи на шкале регулятора.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Показать названия каналов</guilabel
></term>
<listitem
><para
>Показать названия каждого из устройств звуковой платы. Включен этот флажок или нет, наведя курсор на иконку устройства, вы увидите его название.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>


</chapter>


<chapter id="working-with-kmixapplet">
<title
>Аплет панели &kmix;</title>

<para
>Аплет панели &kmix; - это его другой интерфейс. Вы можете встроить его в панель KDE (<guilabel
>Меню панели</guilabel
> -> <guilabel
>Добавить</guilabel
> -> <guilabel
>Аплет</guilabel
> -> <guilabel
>Аплет KMix</guilabel
>). </para>

<para
>С аплетом панели &kmix; можно работать также, как и с <link linkend="working-with-kmix"
>главным окном</link
>, включая и контекстное меню. Основные отличия таковы: <simplelist>
<member
>Нет главного меню.</member>
<member
>При наличии нескольких звуковых плат невозможно поменять микшер, выбрав его в начале.</member>
<member
>Нет пиктограммы встраивания в панель. Чтобы она появилась, нужно запустить &kmix; из главного меню <guilabel
>K-Menu</guilabel
> -> <guilabel
>Мультимедиа</guilabel
> -> <guilabel
>Звуковой микшер</guilabel
></member>
<member
>Пиктограммы будут показаны лишь при достаточно большом размере панели.</member>
<member
>Не будет названий устройств.</member>
<member
>Настройка осуществляется через меню панели - цвета и направление ползунков.</member>
</simplelist>

</para>
</chapter>

<chapter id="control-panel">
<title
>Настройки Центра управления</title>

<sect1 id="config-opt">
<title
>Общие настройки</title>

<para
>Параметры &kmix; можно настроить в Центре управления KDE, в модуле <guimenu
>Звук</guimenu
> - <guimenuitem
>Микшер</guimenuitem
>:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Сохранить текущие уровни громкости</guilabel
></term>
<listitem
><para
>Сохраняет текущие уровни громкости для последующего восстановления.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Загрузить уровни громкости</guilabel
></term>
<listitem
><para
>Восстанавливает ранее сохраненные уровни громкости.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Восстановить уровни громкости при запуске KDE</guilabel
></term>
<listitem
><para
>Загружает предыдущие уровни громкости при запуске &kde;.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Максимальное число опрашиваемых микшеров</guilabel
></term>
<listitem
><para
>Этот параметр определяет количество звуковых плат, которые &kmix; опрашивает при запуске. Уменьшите его значение, чтобы ускорить запуск &kmix;. Увеличьте его, если находятся не все ваши микшеры.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Максимальное число опрашиваемых устройств на один микшер</guilabel
></term>
<listitem
><para
>Этот параметр определяет, сколько устройств опрашивает &kmix; на каждой звуковой плате. Уменьшите его значение, чтобы ускорить запуск. Увеличьте его, если драйвер вашей звуковой платы предоставляет больше микшеров, чем находит &kmix;.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>



<chapter id="advanced-kmix">
<title
>Дополнительные возможности KMix</title>



<warning
><para
>В этой главе описываются возможности &kmix;, которые могут пригодиться опытным пользователям и вряд ли понадобятся в обычной работе. Поэтому вы можете её пропустить без особого вреда для себя.</para
></warning>


<sect1 id="dcop-overview">
<title
>Интерфейс DCOP</title>

<para
>Иногда вам нужно управлять микшером из другого приложения или делать что-то ещё, например, глушить звук в десять часов вечера. Интерфейс &kmix; с DCOP позволяет делать это очень легко. Наберите <guilabel
>dcop kmix</guilabel
> в командной строке и начинайте работу с DCOP. Возможности &kmix; следующие:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Mixer0</guilabel
></term>
<listitem
><para
>Управление первым микшером. Вы можете задавать уровень громкости, выключать звук, менять баланс и т.д. Наберите <guilabel
>dcop kmix Mixer0</guilabel
> и поупражняйтесь с возможностями. При наличии нескольких звуковых плат будут доступны <guilabel
>Mixer1</guilabel
> и другие.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>kmix-mainwindow#1</guilabel
></term>
<listitem
><para
>Управление главным окном микшера. Его можно скрыть и показать, изменить размер и т.д. Наберите <guilabel
>dcop kmix kmix-mainwindow#1</guilabel
> и пробуйте.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>





<sect1 id="dcop-examples">
<title
>Примеры DCOP</title>

<variablelist>
<varlistentry>
<term
><guilabel
>dcop kmix kmix-mainwindow#1 hide</guilabel
></term>
<listitem
><para
>Скрыть окно микшера. <guilabel
>dcop kmix kmix-mainwindow#1 show</guilabel
> сделает его снова видимым.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>dcop kmix kmix-mainwindow#1 resize 1 1</guilabel
></term>
<listitem
><para
>Окно микшера примет минимально доступный размер, так чтобы вместить все ползунки и другие элемента окна.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>dcop kmix Mixer0 mixerName</guilabel
></term>
<listitem
><para
>Выводит имя микшера, например: <guilabel
>Sound Fusion CS46xx</guilabel
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>dcop kmix Mixer1 setVolume 0 10</guilabel
></term>
<listitem
><para
>Задать громкость второго микшера, устройство 0 в 10 процентов. Устройство 0 часто бывает главным, но но всегда. Чтобы выключить звук на главном устройстве второй звуковой платы, наберите <guilabel
>dcop kmix Mixer1 setMasterVolume 0</guilabel
></para
></listitem>
</varlistentry>
</variablelist>

<para
>Эти команды можно выполнять непосредственно из командной строки в KDE. Чтобы выполнять команды dcop из другого места, например из скриптов crontab, нужно задать переменную среды <guilabel
>DCOPSERVER</guilabel
> (как она выглядит в первой строке вашего файла ~/.DCOPserver_hostname_:0), например: </para>
                                                                         <!-- Don't know a better way to format code - esken -->
<simplelist>
<member
>#!/bin/sh</member>
<member
>DCOPSERVER=`cat /home/yourhome/.DCOPserver_yourhostname_:0 | grep local`</member>
<member
>export DCOPSERVER</member>
<member
>dcop kmix Mixer0 setMasterVolume 0</member>
</simplelist>

</sect1>

<sect1 id="tips-and-tricks">
<title
>Полезные советы</title>

<variablelist>
<varlistentry>
<term
><guilabel
>Параллельное использование драйверов ALSA и OSS</guilabel
></term>
<listitem>
<para
>KMix на Linux работает или с драйвером ALSA, или с OSS, но не с обоими сразу. Если вам всёже нужно использовать их обоих, то поступайте так: закройте KMix и добавьте строчку в файл <guilabel
>kmixrc</guilabel
> в разделе глобальных параметров.</para>
<para
><guilabel
>MultiDriver=true</guilabel
></para>
<para
>Потом снова запустите KMix. В меню <guilabel
>Помощь->Сведения об оборудовании</guilabel
> вы увидите "<guilabel
>Используемые звуковые драйверы: ALSA0.9 + OSS</guilabel
>" и "<guilabel
>Экспериментальный режим работы со многими драйверами</guilabel
>"</para>
<warning
><para
>Скорее всего, все ваши микшеры будут показаны дважды.</para
><para
>В такой конфигурации никаких гарантий работы не существует.</para
></warning>
</listitem>
</varlistentry>
</variablelist>

</sect1>

</chapter>

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

<para
>Главный разработчик</para>

<itemizedlist>
<listitem
><para
>Copyright 1996-2000 Christian Esken</para
></listitem>
<listitem
><para
>Copyright 2000-2003 Christian Esken &amp; Stefan Schimanski</para
></listitem>
<listitem
><para
>Copyright 2003 Christian Esken &amp; Helio Chissini de Castro</para
></listitem>
</itemizedlist>

<para
>Благодарности:</para>

<itemizedlist>
<listitem
><para
>Christian Esken <email
>esken@kde.org</email
></para
></listitem>
<listitem
><para
>Stefan Schimanski <email
>1Stein@gmx.de</email
></para
></listitem>
<listitem
><para
>Paul Kendall <email
>paul@orion.co.nz</email
> - перенос на SGI</para
></listitem>
<listitem
><para
>Sebestyen Zoltan <email
>szoli@digo.inf.elte.hu</email
> - исправления для FreeBSD</para
></listitem>
<listitem
><para
>Faraut Jean-Louis <email
>jlf@essi.fr</email
> - исправления для Solaris</para
></listitem>
<listitem
><para
>Nick Lopez <email
>kimo_sabe@usa.net</email
> - перенос на ALSA</para
></listitem>
<listitem
><para
>Helge Deller <email
>deller@gmx.de</email
> - перенос на HP-UX</para
></listitem>
<listitem
><para
>Lennart Augustsson <email
>augustss@cs.chalmers.se</email
> - исправления для *BSD</para
></listitem>
</itemizedlist>

<para
>Документация: copyright 2000 Matt Johnston <email
>mattj@flashmail.com</email
></para>

<para
>Обновления для версии 1.91 - Christian Esken <email
>esken@kde.org</email
></para>

<para
>С использованием документации Christian Esken <email
>esken@kde.org</email
></para>
<para
>Перевод на русский: Григорий Мохин <email
>mok@kde.ru</email
></para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-kmix">
<title
>Где взять &kmix;</title>
&install.intro.documentation; </sect1>

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

<para
>Очевидно, что &kmix; полезен только при наличии звуковой платы. &kmix; поддерживает различные платформы и драйверы звука:</para>

<itemizedlist>
<listitem
><para
>всеми платформами Open Sound System, что было проверено на &Linux;, FreeBSD, NetBSD и BSDI.</para
></listitem>
<listitem
><para
>&Solaris;.</para
></listitem>
<listitem
><para
>&IRIX;.</para
></listitem>
<listitem
><para
>Звуковыми драйверами ALSA.</para
></listitem>
<listitem
><para
>&HP-UX;.</para
></listitem>
</itemizedlist>

</sect1>

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

</appendix>

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

