<para>Перед запуском &arts-builder; вам нужно запустить звуковой сервер (&artsd;). Обычно, если используется &kde; 2.1, это должно быть уже сделано. Если нет, вы можете настроить автоматический запуск звукового сервера в Центре управления в <menuchoice><guilabel>Звук</guilabel><guilabel>Звуковой сервер</guilabel></menuchoice>. </para>
<para>Когда вы запускаете &arts;, программа всегда запускает небольшие модули. &arts-builder; - это инструмент для создания новых структур из небольших связанных модулей. Вы просто выбираете модули внутри решётки. Для этого выбирайте их из меню <guimenu>Модули</guimenu> и затем укажите место на серо-зелёном фоне. </para>
<para>Модули обычно имеют порты (куда обычно аудио сигналы входят или выходят).Для связывания двух портов, укажите на первый, который становится оранжевым, и затем укажите на второй. Связывать вы можете только входные порты (верхняя часть модуля) с выходными (нижняя часть модуля). Если вы желаете установить постоянный сигнал в порт (или отключить его), тогда сделайте двойной щелчок мышью над портом. </para>
<para>Вам нужен модуль Synth_AMAN_PLAY для прослушивания результата вашего творчества. Для установки модуля Synth_AMAN_PLAY выберите <menuchoice><guimenu>Модули</guimenu> <guisubmenu>Синтез</guisubmenu> <guisubmenu>Звуковой ввод/вывод</guisubmenu> <guisubmenu>Synth_AMAN_PLAY</guisubmenu></menuchoice> и указать на свободное место для модуля. Расположите его ниже пятой линии, потому как мы добавим ещё что-нибудь выше. </para>
<para>Модуль имеет параметр <parameter>title</parameter> (крайний левый порт), и <parameter>autoRestoreID</parameter> (рядом с крайним левым портом) для поиска. Для заполнения их, сделайте двойной щелчок над этими портами, выберите значение и тип <userinput>tutorial</userinput> в поле ввода. Нажмите <guibutton>OK</guibutton> для завершения. </para>
<para>Выберите <menuchoice><guimenu>Файл</guimenu><guimenuitem>Выполнить структуру</guimenuitem> </menuchoice>. Вы абсолютно ничего не услышите.Модулю воспроизведения нужно что-нибудь ещё передать на вход. Если вы слышали некоторое время тишину, нажмите на <guibutton>Да</guibutton> и переходите ко второму шагу. </para>
<para>Создайте модуль Synth_WAVE_SIN (из меню <menuchoice> <guimenu>Модули</guimenu> <guimenuitem>Синтез</guimenuitem> <guimenuitem>Волновые</guimenuitem> </menuchoice>) и установите его выше модуля Synth_AMAN_PLAY. (Оставьте одну строку между ними). </para>
<para>Как вы видите, этот модуль что-то выдаёт, но требует <guilabel>pos</guilabel> в качестве входа. Сначала давайте установим выход на колонки.Нажмите на порт <guilabel>out</guilabel> в модуле Synth_WAVE_SIN и затем на порт <guilabel>left</guilabel> в модуле Synth_AMAN_PLAY.Теперь у нас соединены два модуля. </para>
<para>Все осцилляторы в &arts; не требуют частоту на входе, нужна позиция в волне. Позиция должна быть между 0 и 1, которые отображаются для стандартного объекта Synth_WAVE_SIN на область 0..2*пи. Для получения значений осцилляций из частоты используются модули Synth_FREQUENCY. </para>
<para>Установите модуль Synth_FREQUENCY (с помощью <menuchoice> <guimenu>Модули</guimenu> <guimenu>Синтез</guimenu> <guimenu>Oscillation & Modulation</guimenu> </menuchoice>) и соедините его вывод <quote>pos</quote> со входом <quote>pos</quote> вашего Synth_WAVE_SIN. Выставите частотному генератору значение 440. </para>
<para>Выберите <menuchoice><guimenu>Файл</guimenu><guimenuitem>Исполнить структуру</guimenuitem></menuchoice>. Вы услышите частоту 440 Гц на одной из ваших колонок. Если вы услышали, то нажимайте на кнопку <guibutton>Да</guibutton> и переходите к 3-ему шагу. </para>
<para>Было бы хорошо услышать частоту в обеих колонках. Для этого подключите правый канал Synth_PLAY к выходу Synth_WAVE_SIN. </para>
<para>Создайте объект Synth_SEQUENCE (из <menuchoice><guimenu>Модули</guimenu><guisubmenu>Синтез</guisubmenu><guisubmenu>Midi & Sequencing</guisubmenu></menuchoice>). Он должен быть сверху. Если вам нужно больше места вы можете переместить другие модули выделяя их (для выделения нескольких модулей используйте &Shift;), и перетаскивая их в сторону. </para>
<para>Снова соедините выход частоты Synth_SEQUENCE ко входу модуля Synth_FREQUENCY. Затем установите значение скорости последовательности в 0.13 (скорость крайний левый порт). </para>
<para>Сейчас перейдите крайнему правому порту (последовательности) Synth_SEQUENCE и установите последовательность, написав <userinput>A-3;C-4;E-4;C-4;</userinput>. За дополнительной информацией обращайтесь к описанию модулей. </para>
<para>Synth_SEQUENCE в действительности <emphasis>нуждается</emphasis> в установке последовательности и скорости. Без этого вы можете получить сбой программы. </para>
<para>Выберите <menuchoice><guimenu>Файл</guimenu><guimenuitem>Исполнить структуру</guimenuitem></menuchoice>. Вы услышите проигрывание последовательности. Если вам понравилось, то нажимайте <guibutton>Да</guibutton> и переходите к четвёртому шагу. </para>
<para>Создайте модуль Synth_PSCALE (из <menuchoice><guimenu>Модули</guimenu> <guisubmenu>Синтез</guisubmenu> <guisubmenu>Оболочки</guisubmenu> </menuchoice>). Отключите выход синусоидальной волны двойным щелчком и выберите <guilabel>не подключён</guilabel>. Подключите </para>
<para>Как это работает: Synth_SEQUENCE берёт дополнительную информацию о позиции ноты,которую сейчас проигрывает, пока 0 означает запущен и 1 завершён. Модуль Synth_PSCALE усиливает пропускаемый аудио поток от значения громкости 0 (тихо) до 1 (оригинальная громкость) и обратно до 0 (тихо). В соответствии с позицией. Позиция пика может быть получена как значение pos.0.1 означает, что после проигрывания 10% ноты, громкость увеличивается до максимума и потом начинает уменьшаться. </para>
<para>Выберите <menuchoice><guimenu>Файл</guimenu><guimenuitem>Выполнить Структуру</guimenuitem></menuchoice>. Вы услышите воспроизведение прекрасной последовательности.Если вам понравилось, то нажмите <guibutton>OK</guibutton> и переходите к пятому шагу. </para>
<para>Установите параметр bus модуля Synth_BUS_DOWNLINK в audio (это просто название, можно написать fred, если вам так нравится) </para>
<para>Запустите выполнение структуры. Подождав немного, вы так ничего и не услышите. </para>
<para>Вернёмся назад к структуре с Synth_WAVE_SIN, заменим Synth_AMAN_PLAY на Synth_BUS_UPLINK и настроим его название на audio (или fred, если так удобнее). Удаляем модули, выделяя их и выбирая в меню <menuchoice><guimenu>Правка</guimenu><guimenuitem>Удалить</guimenuitem></menuchoice> (или нажимая клавишу <keycap>Del</keycap>). </para>
<para>Запустим ещё раз структуру <menuchoice><guimenu>Файл</guimenu> <guilabel>выполнить структуру</guilabel></menuchoice>. Вы услышите последовательность нот, переданных через шину. </para>
<para>Если вам нужно выяснить, почему что-то подобное этому может быть действительно удобным, нажмите <guibutton>Да</guibutton> (в &arts-builder;, который выполняет Synth_SEQUENCE, вы можете всё оставить запущенным) и перейдите к 6-ому шагу. </para>
<title>6-й шаг: Обмен данными для опытных пользователей</title>
<para>Выберите <menuchoice><guimenu>Файл</guimenu><guimenuitem>Переименовать</guimenuitem></menuchoice> структуру из меню artsbuilder, который содержит Synth_SEQUENCE, и назовите её tutorial. Нажмите <guibutton>Да</guibutton>. </para>
<para>Запустите ещё один &arts-builder;, выберите <menuchoice><guimenu>Файл</guimenu><guimenuitem>Загрузить</guimenuitem> </menuchoice> и загрузите tutorial снова. </para>
<para>Сейчас вы можете выбрать <menuchoice><guimenu>Файл</guimenu><guimenuitem>Выполнить структуру</guimenuitem></menuchoice> в обеих копиях &arts-builder; с этой структурой. Вы можете услышать двойное воспроизведение одного и того же. В зависимости от времени, когда вы запускаете выполнение структуры, звук может изменяться. </para>
<para>Ещё можно сделать следующее: запустите &noatun; и начните проигрывание какого-нибудь <literal role="extension">mp3</literal>. Запустите &artscontrol;. Перейдите в <menuchoice><guimenu>Вид</guimenu><guimenuitem>Управление звуком</guimenuitem></menuchoice>.Вы увидите &noatun; и вашу <quote>tutorial</quote> структуру воспроизводящую что-то. Ещё лучше, если вы сделаете следующее: дважды нажмите на &noatun;, и вы сможете просмотреть список доступных шин. Вы также можете указать &noatun; выводить данные на шину audio, предоставляемую структурой tutorial. </para>
<para>Наконец, сейчас вы сможете сделать из вашей синусоидальной волны настоящий инструмент. Это ощутимо, только если у вас есть что-то передающее события &MIDI; в &arts;. Я хотел бы описать здесь, как вы сможете использовать некоторые внешние клавиатуры, midi-шина подобная &brahms; прекрасно подходит. </para>
<para>Во-первых, очистим рабочий стол от лишнего, вам понадобится только один &arts-builder;, выполняющий структуру с синусоидальной волной. Затем, трижды сделайте <menuchoice><guimenu>Порты</guimenu> <guisubmenu>Создать входящий сигнал</guisubmenu></menuchoice>, и три раза <menuchoice><guimenu>Порты</guimenu> <guisubmenu>Создать выходной сигнал</guisubmenu></menuchoice>. Разместите порты где-нибудь. </para>
<para>Выберите <menuchoice><guimenu>Порты</guimenu> <guilabel>Изменить позиции и имена</guilabel></menuchoice> и назовите порты frequency (частота), velocity (скорость), pressed (нажато), left (левый), right (правый), done (завершено). </para>
<para>Наконец, вы можете удалить модуль Synth_SEQUENCE и соединить входящий порт frequency структуры с портом frequence модуля Synth_FREQUENCY. Но как же позиция?</para> <para>Мы её не имеем, потому как нет алгоритма, по которому вы могли бы предсказать, когда пользователь отпустит ноту, которую он только что нажал на midi клавиатуре. Так что мы имеем параметр pressed, который показывает когда пользователь держит нажатой клавишу. (pressed = 1: клавиша остаётся нажатой, pressed = 0: клавиша отпущена) </para>
<para>Это означает, что объект Synth_PSCALE также должен замещён. Установите вместо него Synth_ENVELOPE_ADSR (из <menuchoice><guimenu>Модули</guimenu><guisubmenu>Синтез</guisubmenu> <guisubmenu>Оболочки</guisubmenu> </menuchoice>).Соедините: </para>
<para>Установите параметры attack в 0.1, decay в 0.2, sustain в 0.7, release в 0.1. </para>
<para>Ещё нам нужно обдумать, как структура должна узнать, когда нужно начать и остановить воспроизведение, потому что иначе никогда оно не остановится, если нота была отпущена. Но оболочка ADSR знает, когда уже ничего не должно быть слышно, начиная с уменьшения сигнала к нулю с момента отпускания ноты. </para>
<para>Завершение показывается установкой 1 на выходе порта done. Так что связываем это с выходом done. Структура будет удалена, как только done установится в 1. </para>
<para>Переименуем нашу структуру в instrument_tutorial (из <menuchoice><guimenu>Файл</guimenu><guimenuitem>Переименовать структуру</guimenuitem></menuchoice>. Затем сохраним его, используя сохранить как.</para><para>Запустим artscontrol, и перейдём в <menuchoice><guimenu>Вид</guimenu><guimenuitem>Управление MIDI</guimenuitem></menuchoice>, и выберем <menuchoice><guimenu>Добавить</guimenu><guimenuitem>Выход MIDI синтеза aRts</guimenuitem></menuchoice>. Наконец, вы здесь можете выбрать ваш инструмент (tutorial). </para>
<para>Откройте терминал и наберите <userinput><command>midisend</command></userinput>. Вы можете заметить, что <command>midisend</command> и инструмент присутствуют в окне управления &MIDI; &arts;. После выбора обоих элементов и нажатия <guibutton>Соединить</guibutton>, мы всё завершим. Возьмите вашу клавиатуру и начните играть (конечно же она должна быть соединена с вашим компьютером). </para>
<para>Попробуйте использовать что-нибудь другое, чем синусоидальную волну. Когда вы подключите треугольную волну, вы скорее всего предположите что звук не слишком хорош. Но попробуйте добавить фильтр SHELVE_CUTOFF сразу же после модуля треугольной волны для вырезания частот выше основной (попробуйте например 1000 Гц или лучше в два раза выше чем входная частота или входная частота + 200 Гц или что-то похожее на это). </para>
<para>Попробуйте использовать больше чем один генератор. Synth_XFADE может быть использован для смешения двух сигналов, Synth_ADD для сложения их. </para>
<para>Также попробуйте дополнительно обработать сигнал после того как он попадёт на выходную шину.Вы можете, к примеру, смешать задержанные версии сигнала с оригинальным для создания эффекта эха. </para>
<para>Попробуйте использовать настройку скорости (это сила, с которой нота будет сжата, вы можете также говорить о громкости). Специальный эффект всегда есть не только когда изменяется громкость результирующего сигнала, но также и звучание инструмента (для примера вырезание частот). </para>
<para>Если вы создали что-то замечательное, пожалуйста подумайте над возможностью предоставить это для интернет страницы &arts;. Или над включением в следующую версию. </para>
<para>&arts-builder; распространяется с несколькими примерами, которые могут быть открыты из <menuchoice><guimenu>Файл</guimenu><guimenuitem>Открыть пример...</guimenuitem> </menuchoice>. Некоторые из них есть в директории, другие, которые по каким-то причинам не работают с данной версией, находятся в директории todo. </para>
<para>Примеры разделяются на несколько категорий: </para>
<para>Независимые примеры иллюстрируют как нужно использовать каждый из встроенных модулей arts (названы <filename>example_*.arts</filename>). Обычно они выводятся что-то на звуковую карту. </para>
<para>Инструменты созданные из низкоуровневых модулей arts (названы <filename>instrument_*.arts</filename>).Они удовлетворяют соглашению о входных и выходных портах так что они могут быть использованы менеджером &MIDI; в &artscontrol;. </para>
<para>Эффекты, которые могут быть использованы для создания ваших структур. (названы <filename>effect_*.arts</filename>) [все в директории todo ] </para>
<para>Элементы для смешивания сигналов включая и графические управляющие элементы (названы <filename>mixer_element_*.arts</filename>). [ все в директории todo ] </para>
<para>Создаёт 440 Гц синусоидальную волну в левом канале и 880 Гц синусоидальную волну в правом канале, и выдаёт это на звуковую карту. Это описано в документации по &arts;. </para>
<para>Создаёт двух тоновую волну из 697 Гц и 1209 Гц синусоидальных волн, усиливая их на 0.5 и складывая их вместе. Это DTMF тон для числа "1" на клавиатуре телефона. </para>
<para>Исходящий канал из шины названной <quote>Bus</quote> и входящий канал в шину <quote>out_soundcard</quote> с зарезервированным левым и правым каналом. </para>
<para>Исходящий канал из шины названной <quote>Delay</quote> и входящий правый канал через задержку в 0.5 секунд, и левый канал не изменяется.Вы можете использовать &artscontrol; для соединения эффекта с проигрывателем и пронаблюдать результат. </para>
<para>Этот пример использует модуль Synth_CAPTURE_WAV для сохранения 400 Гц волну как wav файл. Модуль запускается на несколько секунд и затем проверяет создание файла в <filename class="directory">/tmp</filename>. Вы можете воспроизвести файл в таком проигрывателе как <application>kaiman</application>. </para>
<para>Этот пример использует модуль Data для создания постоянного потока со значением <quote>3</quote> и пересылает его в модуль Debug для периодического показа. Также есть модуль Nil, иллюстрирующий как он может быть использован для ничего не делания. </para>
<para>Данный пример соединяет эффект Freeverb исходящего канала с выходом. Вы можете использовать Artscontrol для подключения эффекта к проигрывателю и пронаблюдать результат. </para>
<para>Данная структура прогоняет данные левого канала через фильтр-смещения (pitch shift).С помощью установки различной скорости вы можете изменять эффект. </para>
<para>Данная структура пропускает белый шум через RC-фильтр и выводит сигнал на звуковую плату.На индикаторе БПФ(FFT) в artscontrol вы можете увидеть как изменяется форма сигнала из не фильтрованного шума. </para>
<para>Эта структура пропускает белый шум через фильтр Shelve-Cutoff и выводит на звуковую плату.На индикаторе БПФ(FFT) в artscontrol вы можете увидеть как изменяется форма сигнала из не фильтрованного шума. </para>
<para>В приведенном примере смешиваются частоты 440 Гц и 880 Гц синусоидальных волн с использованием cross fader. Последний может иметь значение от -1 до 1. </para>
