# Справочное руководство по &noatun;

Charles Samuels

    charles@kde.org

Григорий Мохин

    mok@kde.ru

Перевод на русский
2001 2002 Charles Samuels
&FDLNotice;
2002-03-01
2.00.00

&noatun; - это полнофункциональный модульный медиаплеер для &kde;.

KDE Noatun kdemultimedia mp3 music media

## Введение

&noatun; - это полнофункциональный модульный медиаплеер для &kde;.

### Особенности

&noatun; - это медиаплеер и интерфейс к &arts; — аналоговому синтезатору реального времени. Добавить дополнительные объекты для воспроизведения можно, зайдя на страницу http://noatun.kde.org/plugins.phtml или http://mpeglib.sf.net. По умолчанию &arts; поддерживает MP3 и MPEG-1. Vorbis также поддерживается в том случае, если библиотеки Vorbis были доступны при сборке &kde;.

## Использование &noatun;

По умолчанию &noatun;, запускается в облике модуля Excellent. Этот модуль был выбран потому, что он более всех прочих похож на другие приложения &kde;.

&noatun; уникален в том смысле, что он никогда не бывает одним и тем же в разных ситуациях и для него не существует раз и навсегда заданного интерфейса, а есть лишь интерфейс по умолчанию.

### Формат заголовка

В диалоге настройки &noatun; есть текстовое поле Формат заголовка. В нём вы можете задать формат, в котором будет выводиться строка заголовка.

- Текст будет выводиться как обычно, если он не заключен в `$( )`.

- Текст внутри `$( )` - это шаблон, для которого будет подставляться соответствующее значение.

- Если в тексте внутри `$( )` попадаются кавычки, то текст в кавычках будет выводиться обычным образом, если только такой шаблон в названии существует.

- Кавычки можно ставить в любом месте: в начале `$( )`,в конце его или по обеим сторонам.

Например, `$(bitrate)` будет заменен значением битового потока, подгружаемого модулем метатегов. Однако текст при наличии кавычек будет показан так: `$(bitrate"kbps")` выведет значение битового потока и `"kbps"`. Ни то, ни другое не будет показано, если шаблон bitrate не существует.

## Использование модулей &noatun;

Вы можете добавить модули через пункт меню Настройка Настроить &noatun;.... Перейдите на вкладку Модули и выберите элемент. Затем подключите модуль, отметив флажок рядом с его именем. Нужно подключить хотя бы один из модулей пользовательского интерфейса и в точности один модуль списка песен.

### Молочный шоколад

Молочный шоколад - это простейший стиль пользовательского интерфейса. Кнопки его ведут себя так, как на CD-плеере, а кнопка Извлечь открывает список песен. Кнопка с крестиком удаляет текущий элемент из списка, но не с диска, а кнопка стрелка задает повтор воспроизведения. При щелчке правой кнопки мыши в любом месте окна открывается контекстное меню.

### Ветка гикори

Ветка гикори - это модуль для системного лотка &kde;, области панели возле часов.

При нажатии правой кнопкой на иконке выводится меню, левой кнопкой включаются или выключатся пользовательские окна &noatun;. Кстати говоря, списки песен к таковым не относятся.

### Экспорт списка в HTML

Этот модуль сохраняет список в виде симпатичной HTML-таблицы. В её настройках вы можете задать цвета, фоновый рисунок, включить изменение цветов ссылок при наведении мышью.

Когда вы зададите параметры, через меню Действия Экспорт списка... будет открываться диалог, и вы сможете выбрать, куда сохранять файл.

### Образы K-Jöfol

K-Jöfol, загрузчик образов для &noatun; - это подобие программы для &Windows; с тем же названием.

Однако её версия для &noatun;, к сожалению, имеет ограничения . Образы должны храниться в несжатом виде на диске.

Чтобы установить новый образ (в zip-формате для &Windows;), вы можете запустить установочную утилиту для образов через диалог настройки &noatun;.

Так как некоторые образы упакованы некорректно, а установщик образов не может предугадать всё, то если установка образа прошла неудачно, вы можете следовать этим инструкциям:

    % cd $KDEHOME/share/apps/noatun
    % mkdir kjskins (если это нужно)
    % cd kjskins
    % mkdir %новый_образ ; cd новы_образ
    % unzip /путь/до/нового_образа.zip

Также вы можете создавать свои образы, следуя руководству на http://www.angelfire.com/mo/nequiem/tutorial.html.

### Список Split

Интерфейс списка Split ничем особенным не отличается. Вы можете начать воспроизведение, дважды щёлкнув по записи или выделив её и нажав Enter. Можно также перетаскивать мышью файлы и ссылки.

Начиная с версии &kde; 3.0, список Split (SPL) сохраняет данные в формате &XML;, не если XML-файл не существует, то автоматически будет создан файл m3u. Это означает, что вы можете удалять XML-файлы и записывать в m3u-файлы, чтобы автоматически создавать такие списки.

Само имя "Split" ничего не означает, поскольку уже давно ничего не разделяется (англ. - split). Оно осталось со времен молодости &noatun;, когда такое разделение на самом деле существовало.

### Стили Winamp

Если вы когда-либо запускали Winamp, этот стиль будет вам знаком. Щелчок по таймеру переключает направление отсчёта времени с прямого на обратное и наоборот. Выбор области эквалайзера включает или отключает его. Двойной щелчок по заголовку сворачивает окно, а щелчок правой кнопкой или щелчок по левой верхней кнопке окна приведет к показу панели инструментов &noatun;.

Новый стиль можно устанавливать в каталог `$KDEHOME/share/apps/noatun/skins/winamp`, если создать для него подкаталог и распаковать туда архив. Файлы стилей Winamp имеют расширение `.wsz` - это обычные zip-архивы. Может потребоваться переименовать файл, если архиватор не понимает такое расширение.

### Метатег

Это модуль, загружающий сведения о файле посредством механизма KFile, точно так же как &konqueror; выводит подсказки о файле при наведении мышью. Помимо вывода сведений он позволяет редактировать теги через меню Действия Редактор тегов. Можно редактировать теги ID3 и OggVorbis. Он также читает значение битового потока.

### Keyz

Карстен Пфайффер решил покончить с устоявшейся привычкой называть модули &noatun; не поймёшь как - вспомните хотя бы "молочный шоколад" и "ветку гикори". В чём смысл замены S на Z? Так уж принято говорить на хакерском новоязе!

Каким бы простым не было название модуля, сам модуль может поспорить с ним в своей простоте. Так и есть, вы можете назначать клавиши различным действиям в &noatun;. Прелесть его в том, что эти клавиши будут работать везде, а не только в &noatun;. Что может наконец оправдать существование мультимедийных клавиатур в глазах их обладателей.

### Инфракрасный пульт

Если у вас есть инфракрасный пульт, например, поставляемый с телевизионными тюнерами Brooktree, а сам пульт поддерживается LIRC, то вы сможете им воспользоваться. Как и Keyz, название не впечатляет, но функции модуля могут быть полезны.

Чтобы назначить действие какой-либо клавишу, откройте страницу Инфракрасный пульт в окне настройки &noatun;. Выберите клавишу и соответствующее действие из выпадающего списка. Если вы хотите, чтобы действие повторялось, как, например, регулировка громкости, то отметьте флажок и укажите интервал повтора.

Если у вас ТВ плата, то удобно будет соотнести с кнопкой Отключить звук действие Пауза. При этом ваш телевизор будет замолкать, а &noatun; - включаться, и наоборот. Очень удобно при показе рекламы.

## Вопросы, ответы, полезные советы

Часто задаваемые вопросы

При воспроизведении случаются заметные паузы, когда перемещаются окна.

Настройте размер буфера &arts; так:

- Запустите Центр управления

- Откройте группу Звук

- Найдите раздел Звуковой сервер

- Увеличьте время отклика. Для большинства компьютеров значение 384 мс будет вполне достаточным.

Вы можете также попробовать запускать звуковой сервер с приоритетом реального времени. Учтите, что это иногда может подвесить систему.

Не удаётся удалить список песен или пользовательский интерфейс из списка модулей.

Поскольку для работы &noatun; требуется как минимум один пользовательский интерфейс и ровно один список песен, вам следует добавить новый модуль пользовательского интерфейса, прежде чем удалять старый. Добавление нового списка песен автоматически заменяет старый список.

Где взять другие модули?

Свободные программисты могут предоставлять модули собственной разработки на сайт &noatun;, откуда их и скачивают себе пользователи.

Как самому написать модуль &noatun;?

Документацию, справочник по API и пример исходного кода можно взять на сайте &noatun;. Разумеется, в духе свободного программного обеспечения, &noatun; и его модули имеют открытый исходный код.

## Авторские права и лицензирование

Программирование - copyright 2000-2002 Charles Samuels charles@kde.org

Документация - copyright 2002 Charles Samuels charles@kde.org

&noatun; обрел жизнь благодаря усилиям следующих людей:

- Charles Samuels charles@kde.org

- Neil Stevens multivac@fcmail.com

- Stefan Westerfeld stefan@space.twc.de

- Martin Vogt mvogt@rhrk.uni-kl.de

- Malte Starostik malte.starostik@t-online.de

- Nikolas Zimmermann wildfox@kde.org

- Stefan Schimanski 1Stein@gmx.de

Перевод на русский: Григорий Мохин mok@kde.ru

&underFDL; &underBSDLicense;

## Установка

### Где взять &noatun;

&install.intro.documentation;

### Требования

&noatun; работает на Pentium 200 под &Linux;, на PowerPC под &Linux; 2.4.1 или позднее, а также на других платформах. С каждой новой версией расширяется список поддерживаемых платформ.

Чтобы программа легко переносилась на какую-либо платформу, на ней должны поддерживаться потоки (pthread) и звук OSS, однако под &Linux; поддерживается и ALSA.

### Сборка и установка

&install.compile.documentation;

Если же что-то у вас не получилось, сообщите о проблемах автору: charles@kde.org.

Если вы читаете этот документ, то скорее всего &noatun; у вас уже собран.

## Словарь

Молочный шоколад

  Молочный шоколад - незатейливый модуль пользовательского интерфейса

&arts;

  &arts; - аналоговый синтезатор реального времени. Мощная мультимедийная программная система, используемая &noatun;

K-Jöfol

  Модуль загружает стили, подобно тому как это делает программа под &Windows; с похожим названием.

Keyz

  Keyz - горячие клавиши для &noatun;

Ветка гикори

  Ветка гикори - модуль встраивания в системный лоток.

Noatun

  Kaiman - модуль подключения стилей плеера GQMPEG. Kaiman - это также предшественник &noatun;, входивший в состав &kde; 2.0. &noatun; впервые был включен в &kde; 2.1, и загрузчик стилей Kaiman стал модулем &noatun;.

&documentation.index;