/usr/share/vmpk/help

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
    <meta HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
    <title>VMPK. Виртуальная MIDI Пианино Клавиатура</title>
</head>
<body>

<h1>Виртуальная MIDI Пианино Клавиатура</h1>

<div id="navcontainer">
<ul>
  <li><a href="#Introduction">Введение</a></li>
  <li><a href="#Getting_started">Начало работы</a>
    <ul>
      <li><a href="#MIDI_concepts">Принципы MIDI</a></li>
      <li><a href="#maps_instruments">Привязки клавиш и описания инструментов</a></li>
      <li><a href="#MIDI_Connections">Соединения MIDI и виртуальные MIDI кабели</a></li>
    </ul>
  </li>
  <li><a href="#FAQ">Часто Задаваемые Вопросы</a></li>
  <li><a href="#Download">Скачать</a></li>
  <li><a href="#Installation">Установка из исходников</a>
    <ul>
      <li><a href="#Requirements">Требования</a></li>
      <li><a href="#windows_notes">Заметки для пользователей Windows</a></li>
      <li><a href="#mac_notes">Заметки для пользователей Mac OSX</a></li>
      <li><a href="#packager_notes">Заметки для упаковщиков и продвинутых пользователей</a></li>
    </ul>
  </li>
  <li><a href="#Acknowledgements">Благодарности</a></li>
  <li><a href="#TranslatorNote">Примечание переводчика</a></li>
</ul>
</div>

<br>

<h2><a name="Introduction"></a>Введение</h2>

<p>Виртуальная MIDI Пианино Клавиатура - это генератор и приёмник событий MIDI.
Программа не производит никакого звука сама по себе, но может быть использована
для  управления  MIDI  синтезатором   (аппаратным,  программным  или  внешним).
Вы  можете  использовать  клавиатуру  компьютера,  чтобы проигрывать MIDI ноты,
и также мышь. Вы  можете  использовать  Виртуальную  MIDI  Пианино  Клавиатуру,
чтобы отображать проигранные MIDI ноты из другого инструмента или проигрывателя
MIDI файлов. Чтобы сделать это, соедините порт MIDI со входным портом VMPK.</p>

<p>VMPK  была протестирована на Linux, Windows и Mac&nbsp;OSX, но, возможно, вы
сможете собрать её и на других системах. Если вы сделаете это,  скиньте  автору
письмо.</p>

<p>Virtual  Keyboard  (vkeybd),  написанная  Takashi  Iway,  была вдохновителем
для написания этого приложения. Это замечательная программа,  хорошо  служившая
нам в течение многих лет. 
Спасибо!</p>

<p>VMPK  использует  современную  GUI  библиотеку:  Qt4,  превосходную по своим
возможностям и функциональности.
<a href="http://www.music.mcgill.ca/~gary/rtmidi/">RtMIDI</a> 
предоставляет  возможности  ввода/вывода   MIDI.   Обе   библиотеки   свободные
и платформонезависимые, доступны для Linux, Windows и Mac&nbsp;OSX.</p>

<p>Алфавитно-цифровые  привязки  клавиш могут быть настроены в самой программе,
c использованием графического интерфейса, и настройки хранятся  в  файлах  XML.
Сделаны   некоторые  схемы  привязок  для  испанских,  немецких  и  французских
клавиатур, переведённые из тех, что были предоставлены VKeybd.</p>

<p>VMPK  может посылать программные изменения и регулировки на MIDI синтезатор.
Описания для различных стандартов и устройств  могут  быть  предоставлены,  как
.INS файлы, в формате, используемом QTractor и TSE3. Он был разработан Cakewalk
и также используется в Sonar.</p>

<p>Это   программное   обеспечение   находится  на  очень  ранней  альфа-стадии
разработки.   Вы   можете   ознакомиться   с   полным  списком  нереализованных
возможностей в файле TODO. Пожалуйста, не стесняйтесь  связываться  с  автором,
чтобы  задать вопросы, сообщить об ошибках или предложить новые возможности. Вы
можете использовать систему слежения за ошибками на 
<a HREF="http://sourceforge.net/tracker2/?group_id=236429">сайте проекта
SourceForge</a>.</p>
<p>Copyright (C) 2008-2011, Pedro Lopez-Cabanillas <b>&lt;plcl AT
users.sourceforge.net&gt; </b></p>
<p>Виртуальная MIDI Пианино Клавиатура ‒ это свободное программное обеспечение,
распространяющееся по лицензии
<a href="http://www.gnu.org/copyleft/gpl.html">GPL v3 license</a>.</p>

<h2><a name="Getting_started"></a>Начало работы</h2>

<h3><a name="MIDI_concepts"></a>Принципы MIDI</h3>

<p>MIDI  ‒  это индустриальный стандарт соединения музыкальных инструментов. Он
основан на пересылке действий, производимых музыкантом, играющим на музыкальном
инструменте,  на  другой  инструмент.  Музыкальные инструменты, оснащённые MIDI
интерфейсами,  обычно  имеют  два  DIN  разъёма,  обозначенные  MIDI&nbsp;IN  и
MIDI&nbsp;OUT.  Иногда  встречается третий разъём, обозначенный MIDI&nbsp;THRU.
Чтобы соединить два MIDI  инструмента,  нужно  соединить  MIDI  кабелем  разъём
MIDI&nbsp;IN  инструмента,  посылающего  события,  и MIDI&nbsp;IN принимающего.
Вы можете найти больше информации, а также обучения, как
<a href="http://home.roadrunner.com/~jgglatt/tutr/whatmidi.htm">это</a>,
по всему Интернету.</p>

<p>Для компьютеров также существуют аппаратные MIDI интерфейсы с MIDI&nbsp;IN и
OUT портами, к которым  вы  можете  подключать  MIDI  кабели,  чтобы  соединить
комьютер  с  внешними  MIDI  инструментами. Если аппаратный интерфейс не нужен,
компьютер может использовать программное обеспечение MIDI.  Пример  тому  VMPK,
которая  предоставляет  MIDI&nbsp;IN и OUT порты. Вы можете подключать к портам
VMPK виртуальные MIDI кабели, чтобы соединить программу с  другими  программами
или  с  физическими  портами MIDI интерфейса компьютера. Больше деталей об этом
будет написано позже. Скорее всего вы захотите соединить  MIDI  выход  VMPK  со
входом  какого-нибудь  синтезатора,  который  переводит  MIDI  в  звук.  Другим 
примером для соединения может быть MIDI монитор, который переводит события MIDI
в читаемый текст.  Это  поможет  вам  понять,  что  за  информация  посылается,
используя протокол MIDI. В Linux вы можете попробовать
<a href="http://kmetronome.sourceforge.net/kmidimon/">KMidimon</a>, а в
Windows <a href="http://www.midiox.com">MIDIOX</a>.</p>

<p>VMPK  не  производит  никакого звука. Вам потребуется программный синтезатор
MIDI, чтобы услышать проигрываемые ноты. Я советую попробовать
<a href="http://qsynth.sourceforge.net">QSynth</a>,  графическую  оболочку  для
<a href="http://www.fluidsynth.org">Fluidsynth</a>.  Также  можно  использовать
"Microsoft GS Wavetable SW Synth",  который идёт с XP.  Конечно,  использование
внешнего MIDI синтезатора будет даже лучшим подходом.</p>

<h3><a name="maps_instruments"></a>Привязки клавиш и описания инструментов</h3>

<p>VMPK  может  помочь  вам  изменить звуки в вашем MIDI синтезаторе, но только
если вы сначала предоставите описание для звуков синтезатора.
Описания&nbsp;‒&nbsp;это текстовые файлы с расширением .INS, в том же формате,
что используют <a href="http://qtractor.sourceforge.net">Qtractor</a> (Linux),
и <a href="http://www.cakewalk.com">Sonar</a> (Windows).</p>

<p>Когда  вы  запускаете  VMPK  в первый раз, вам нужно открыть диалоговое окно
Параметры и выбрать файл описаний, а затем выбрать название инструмента из тех,
что  предоставляет  файл  описаний.  Вы  можете найти такой файл в директории с
данными VMPK (обычно "/usr/share/vmpk" в Linux, и  "C:\Program&nbsp;Files\VMPK"
в  Windows).  Он  называется  "gmgsxg.ins"  и  содержит описания для стандартов
General MIDI, Roland GS и Yamaha XG. У этого файла очень простой формат,  и  вы
можете  использовать  текстовый  редактор,  чтобы  просмотреть,  изменить его и
создать новый. Вы можете найти библиотеку описаний инструментов на
<a href="ftp://ftp.cakewalk.com/pub/InstrumentDefinitions/">ftp-сервере cakewalk</a>.</p>

<p>Начиная  с  релиза  0.2.5  вы  также  можете  импортировать файлы Sound Font
(в форматах  .SF2  или  DLS),  как  описания  инструментов,  используя  диалог,
доступный через меню Файл->Импортировать&nbsp;SoundFont.</p> 

<p>Другая  настройка,  которую  вы  возможно  захотите совершить ‒ это привязки
клавиш. Раскладка по умолчанию охватывает около  двух  с  половиной  октав  для
QWERTY  клавиатуры,  но в директории с данными находятся ещё несколько описаний
привязок, адаптированных для других международных  раскладок.  Вы  даже  можете
задать  собственные  схемы привязки, используя диалоговое окно, доступное через
меню Правка->Привязки&nbsp;клавиш. Также есть опции для загрузки  и  сохранения
схем  привязок,  как  XML  файлов.  Последняя  загруженная схема привязок будет
восстановлена при следующем запуске VMPK. На самом деле,  все  ваши  параметры,
выбранный  банк  MIDI  и  программа, и значения регуляторов будут сохранены при
выходе и восстановлены, когда вы в следующий раз запустите VMPK.</p>

<h3><a name="MIDI_Connections"></a>Соединения MIDI и виртуальные MIDI кабели</h3>

<p>Чтобы  соединить  два  аппаратных MIDI устройства, вам нужны физические MIDI
кабели. Чтобы соединить MIDI программы, вам нужны виртуальные  MIDI  кабели.  В
Windows вы можете использовать такие MIDI кабели, как
<a href="http://www.midiox.com/myoke.htm">MIDI Yoke</a>, Maple, 
<a href="http://www.nerds.de/en/loopbe1.html">LoopBe1</a> или
<a href="http://www.sonycreativesoftware.com/dl/dl.aspx?dwnid=77">Sony Virtual MIDI Router</a>.</p>

<p>В  процессе  установки  MIDI  Yoke будут установлены драйвер и апплет панели
управления, в котором можно изменять  доступное  количество  MIDI  портов  (вам
потребуется  перезагрузить компьютер после изменения этой установки). MIDI Yoke
работает,  посылая  каждое  событие  MIDI,   записанное   на   OUT   порт,   на
соответствующий  IN  порт.  Например, VMPK можно соединить с выходом порта 1, а
другая программа, к примеру <a href="http://qsynth.sourceforge.net">QSynth</a>,
может считывать события с порта 1.</p>

<p>Используя    <a href="http://www.midiox.com/moxdown.htm">MIDIOX</a>,   можно
добавить больше маршрутов между портами MIDI Yoke  и  другими  системными  MIDI
портами.  Эта  программа также предоставляет много интересных функций, например
проигрыватель MIDI файлов. Вы можете слушать песни, проигрываемые MIDI Synth  и
в  то  же  время  видеть  проигрываемые  ноты (только один канал) в VMPK. Чтобы
сделать это, вам нужно в окне "Маршруты" в MIDIOX соединить входной  порт  1  с
портом  Window Synth. Также настройте порт MIDI проигрывателя, чтобы он посылал
события на MIDI Yoke 1. И настройте входной порт VMPK,  чтобы  читать  из  MIDI
Yoke  1.  Проигрыватель  будет  посылать  события  на  выход  1,  который будет
перенаправлять их на входной порт 1 и порт Synth одновременно.</p>

<p>В      Linux      виртуальные     кабели     предоставляются     секвенсером
<a href="http://www.alsa-project.org">ALSA</a>.  Порты  создаются  динамически,
когда вы запускаете программу, так что их количество не фиксировано, как в MIDI
Yoke. Утилита командной строки "aconnect"  позволяет  соединять  и  разъединять
виртуальные MIDI кабели между любыми портами, будь то аппаратные интерфейсы или
приложения.  Есть  хорошая  графическая  утилита,  делающая  то  же   самое   ‒
<a href="http://qjackctl.sourceforge.net">QJackCtl</a>. Главное назначение этой
программы ‒ управление демоном Jack (запуск, остановка и мониторинг состояния).
Jack предоставляет виртуальные аудио кабели, чтобы соединять порты аудио карт с
аудио программами,  подобно  тому,  как  это  происходит  с  виртуальными  MIDI
кабелями, но для цифровых аудио данных.</p>

<h2><a name="FAQ"></a>Часто Задаваемые Вопросы</h2>

<h3>Как отобразить 88 клавиш?</h3>
<p>88   ‒   это   произвольное  число,  используемое  большинством  современных
производителей пианино, но  производители  органов  и  синтезаторов  не  всегда
следуют  этому  соглашению. VMPK может быть настроена, чтобы отображать от 1 до
10 октав. При использовании 7 октав она показывает 84 клавиши, а при 8  октавах
‒ 98 клавиш. Нет способа показать ровно 7 с 1/4 октавы.</p>

<h3>Нет звука</h3>
<p>VMPK  не  производит  никакого  звука  сама  по  себе.  Вам  необходим  MIDI
синтезатор. Пожалуйста, перечитайте документацию.</p>

<h3>Некоторые клавиши молчат</h3>
<p>Когда вы выбираете канал 10 на стандартном MIDI синтезаторе, он играет звуки
перкуссии, назначенные на многие клавиши, но не на все. На  мелодичных  каналах
(не  на  10  канале)  вы  можете  выбирать  патчи с ограниченным рядом нот. Это
известно в музыке, как <a href="http://ru.wikipedia.org/wiki/Тесситура">Тесситура</a>.</p>

<h3>Опция "Захватывать клавиатуру" не работает</h3>
<p>Это  известная проблема для пользователей Linux. Возможность хорошо работает
в окружении KDE3/4 при использовании стандартного оконного менеджера kwin;  она
также  работает  с  Enlightenment  и  Window  Maker,  но не работает с оконными
менеджерами Compiz и Metacity, обычными для сборок Gnome. Также  известно,  что
использование  этой  опции  мешает нормальному использованию контекстных меню в
приложениях GTK2. Для этой проблемы нет известного решения, кроме как  избегать
сломанных сценариев, если вам действительно нужна эта возможность.</p>

<h3>Названия патчей не совпадают с реальными звуками</h3>
<p>Вам нужно предоставить .INS файл, в точности описывающий набор звуков вашего
синтезатора или SoundFont. Включённый в программу  файл  (gmgsxg.ins)  содержит
только  описания  для  стандартных  GM,  GS  и  XG  инструментов. Если ваш MIDI
синтезатор не совпадает ни с одним из них, вам нужно достать другой  .INS  файл
либо создать его самостоятельно.</p>

<h3>Какой синтаксис у файлов Описаний Инструментов (.INS)?</h3>
<p>Одно из описаний формата INS можно найти
<a href="http://tse3.sourceforge.net/doc/InsFiles.html">здесь.</a></p>

<h3>Могу ли я перевести мои Описания Инструментов для vkeybd в .INS файл?</h3>
<p>Конечно. Используйте AWK скрипт "txt2ins.awk". Вы можете даже использовать
утилиту sftovkb из vkeybd, чтобы создать .INS файл из любого SF2 SoundFont,
но функция импорта названий инструментов из файлов SF2 и DLS есть и в VMPK.</p>

<pre>
$ sftovkb SF2NAME.sf2 | sort -n -k1,1 -k2,2 > SF2NAME.txt
$ awk -f txt2ins.awk SF2NAME.txt > SF2NAME.ins
</pre>

<p>Вы можете найти AWK скрипт "txt2ins.awk" в директории с данными VMPK.</p>

<h2><a name="Download"></a>Скачать</h2>
<p>Вы можете найти последнюю версию исходных файлов, пакеты для Windows и Mac&nbsp;OSX на
<a HREF="http://sourceforge.net/projects/vmpk/files">сайте проекта SourceForge</a>.</p>
<p>Также есть готовые Linux пакеты для:
<ul>
  <li><a href="http://software.opensuse.org/search?baseproject=ALL&amp;p=1&amp;q=vmpk">openSUSE</a>, из Службы Сборки openSUSE</li>
  <li><a href="http://packages.debian.org/vmpk">Debian</a>, официальные репозитории</li>
  <li><a href="http://ubuntufromscratch.tuxfamily.org/index.php?searchword=vmpk&amp;option=com_search">Ubuntu From Scratch</a></li>
  <li><a href="http://aur.archlinux.org/packages.php?ID=20321">Arch Linux</a></li>
  <li><a href="http://packages.pardus.org.tr/info/contrib-2008/binary/vmpk.html">Pardus</a></li>
  <li><a href="http://packages.gentoo.org/package/media-sound/vmpk">Gentoo</a></li>
  <li><a href="http://packages.zenwalk.org/?q=vmpk&amp;zversion=all">Zenwalk</a></li>
</ul>

<h2><a name="Installation"></a>Установка из исходников</h2>

<p>Скачайте исходники с <a href="http://sourceforge.net/projects/vmpk/files">http://sourceforge.net/projects/vmpk/files</a>.
Распакуйте исходники в вашу домашнюю директорию, и перейдите в распакованную директорию.</p>

<pre>
$ cd vmpk-x.y.z
</pre>

<p>Вы можете выбирать между сборочными системами CMake и Qmake, но qmake
предусматривается только для тестирования и разработки.</p>

<pre>
$ cmake .
или
$ ccmake .
или
$ qmake
</pre>

<p>После этого скомпилируйте программу:</p>

<pre>
$ make
</pre>

<p>Если программа успешно скомпилировалась, вы можете установить её:</p>

<pre>
$ sudo make install
</pre>

<h3><a name="Requirements"></a>Требования</h3>

<p>Чтобы  успешно  собрать  и  использовать  VMPK, вам потребуется Qt 4.6, либо
более новая версия. (установите -devel пакет для вашей системы или
<a href="ftp://ftp.qtsoftware.com/qt/source">скачайте open source редакцию</a>
с qtsoftware.com, бывший Trolltech.)</p>

<p><a href="http://www.music.mcgill.ca/~gary/rtmidi/">RtMIDI</a>    включён   в
пакет исходных кодов. Он использует секвенсер ALSA в Linux, WinMM в  Windows  и
CoreMIDI  в  Mac&nbsp;OSX,  которые  являются  встроенными  MIDI  системами для
каждой из поддерживаемых платформ.</p>

<p>Система сборки основана на <a href="http://www.cmake.org">CMake</a>.</p>

<p>Вам также потребуется <a href="http://gcc.gnu.org">компилятор GCC C++</a>.
MinGW ‒ это его <a href="http://www.mingw.org">Windows порт</a>.</p>

<p>Опционально, вы можете собрать установочную программу Windows, используя
<a href="http://nsis.sourceforge.net">NSIS</a>.</p>

<h3><a name="windows_notes"></a>Заметки для пользователей Windows</h3>

<p>Чтобы  скомпилировать  исходники  в Windows, вам потребуется скачать архив в
формате .bz2 или .gz и распаковать  его,  используя  любую  программу,  которая
поддерживает этот формат, например
<a href="http://www.7-zip.org">7-Zip</a>.</p>

<p>Чтобы  сконфигурировать исходники, вам потребуется qmake (из Qt4) или CMake.
Вам необходимо установить переменную среды PATH, чтобы она включала  директории
с  исполняемыми  файлами  Qt4,  MinGW  и  CMake. Программа CMakeSetup.exe ‒ это
графическая версия CMake для Windows.</p>

<h3><a name="mac_notes"></a>Заметки для пользователей Mac&nbsp;OSX</h3>

<p>Вы  можете  найти прекомпилированный пакет приложения, включающий библиотеки
Qt4, на <a href="http://sourceforge.net/projects/vmpk/files">странице    скачек
проекта</a>.  Если  вы  предпочитаете  устанавливать  из  исходников, вы можете
использовать CMake или Qmake, чтобы собрать пакет приложения, скомпонованный  с
установленными  системными  библиотеками.  Вы  можете  использовать  как Qt4 от
qtsoftware.com, так и пакет, распространяемый
<a href="http://www.finkproject.org/">Fink</a>.</p>

<p>Система сборки сконфигурирована, чтобы производить универсальный исполняемый
файл (x86+ppc) в пакете приложений. Вам  потребуются  инструменты  разработчика
Apple, а так же
<a href="http://qt.nokia.com/downloads">Qt4 SDK от Nokia</a>.</p>

<p>Чтобы скомпилировать VMPK, используя файлы сборки Makefile, сгенерированные qmake:</p>

<pre>
$ qmake vmpk.pro -spec macx-g++
$ make
опционально:
$ macdeployqt build/vmpk.app
</pre>

<p>Чтобы скомпилировать, используя файлы сборки Makefile, сгенерированные CMake:</p>

<pre>
$ cmake -G "Unix Makefiles" .
$ make
</pre>

<p>Чтобы создать файлы проекта Xcode:</p>
<pre>
$ qmake vmpk.pro -spec macx-xcode
или
$ cmake -G Xcode .
</pre>

<p>Если вам нужно что-нибудь, чтобы производить шум, возможно вы захотите
взглянуть на
<a href="http://notahat.com/simplesynth">SimpleSynth</a>, или
<a href="http://www.fluidsynth.org/">FluidSynth</a> (доступен с Fink). Для
маршрутизации MIDI, также есть
<a href="http://notahat.com/midi_patchbay">MIDI&nbsp;Patchbay</a>.</p>

<h3><a name="packager_notes"></a>Заметки для упаковщиков и продвинутых пользователей</h3>

<p>Вы  можете  попросить  компилятор  выполнять  некоторую оптимизацию во время
сборки  программы.  Есть  два  пути   сделать   это:   во   первых,   используя
предопределённый тип сборки.</p>

<pre>
$ cmake . -DCMAKE_BUILD_TYPE=Release
</pre>

<p>Тип CMake "Release" использует флаги компилятора: "-O3 -DNDEBUG". Другие
предопределённые типы сборки, это "Debug", "RelWithDebInfo", и "MinSizeRel".
Второй путь, это выбрать флаги компилятора самостоятельно.</p>

<pre>
$ export CXXFLAGS="-O2 -march=native -mtune=native -DNDEBUG"
$ cmake .
</pre>

<p>Вам следует подобрать лучшие CXXFLAGS для вашей собственной системы.</p>

<p>Если вы хотите установить программу в иное место, чем заданное по умолчанию
(/usr/local), используйте следующую опцию CMake:</p>

<pre>
$ cmake . -DCMAKE_INSTALL_PREFIX=/usr
</pre>

<p></p>

<h2><a name="Acknowledgements"></a>Благодарности</h2>

<p>В дополнение к вышеупомянутым инструментам, VMPK использует работы из следующих
open source проектов. </p>

<ul>
<li>из <a href="http://qtractor.sourceforge.net">Qtractor</a>, от Rui Nuno Capela<br>
Классы данных описаний инструментов
<li>из <a href="http://qsynth.sourceforge.net">QSynth</a>, от Rui Nuno Capela<br>
Виджет ручка
<li><a href="http://openclipart.org/media/files/TheresaKnott/346">Значок и логотип</a> от Theresa Knott
</ul>

<p>Огромное вам спасибо!</p>

<hr/>

<h2><a name="TranslatorNote"/>Примечание переводчика</h2>
<p>Этот документ был переведён на русский язык Serguey G Basalaev
&lt;<a href="mailto:s-basalaev@users.sourceforge.net">s-basalaev@users.sourceforge.net</a>&gt;.
Пожалуйста, напишите мне, если вы обнаружили в тексте ошибки или неточности перевода.</p>

<p>This document was translated into Russian by Serguey G Basalaev. Please mail
me if you find any mistakes or translation inaccuracies in the text.</p>

</body>
</html>
vmpk 0.4.0-3 / usr / share / vmpk / help_ru.html
