# Підручник з &minuet;

Sandro S. Andrade &Sandro.Andrade.mail;
Юрій Чорноіван

    yurchor@ukr.net

Переклад українською
2016 &Sandro.Andrade;
&FDLNotice;
17 січна 2016 року
1.00.00

&minuet; — програма для навчання музиці. У ній передбачено набір вправ для розвитку слуху, зокрема вивчення інтервалів, акордів та гами.

KDE kdeedu музика освіта інтервали акорди гами minuet

## Вступ

Вітаємо у &minuet;, програмі &kde; для навчання музиці. &minuet; призначено для допомоги учням і вчителям у багатьох аспектах вивчення музики, зокрема тренуванні слуху, швидкого читання нотних записів, сольфеджіо, вивченні гами, ритму, гармонії та імпровізації. &minuet; широко використовує можливості &MIDI; для доступу до усього спектру можливостей щодо визначення гучності, ритму та тону, що робить &minuet; цінним інструментом для початківців і досвідчених музикантів.

У &minuet; передбачено широкий набір вправ із удосконалення слуху. З метою розширення функціональних можливостей програми та адаптування її до контекстів музичної освіти можна без зайвих проблем додати нові вправи.

Вправи &minuet; для тренування слуху

## Користування &minuet;

У наступних трьох розділах — Як запустити &minuet;, Майстер налаштовування &minuet; та Вправи &minuet; — наведено настанови щодо дій, за допомогою яких можна запустити та користуватися &minuet;.

### Як запустити &minuet;

Запустити &minuet; можна за допомогою меню запуску програм. Відкрийте меню програм &kde; натисканням на піктограмі запуску програм на панелі у нижньому лівому куті екрана. У відповідь буде відкрито меню. Виберіть послідовно пункти Програми Навчання Інше &minuet; (Програмне забезпечення для навчання музики).

### Майстер налаштовування &minuet;

Після першого запуску &minuet; буде відкрито діалогове вікно майстра налаштовування, програми, яка виконає пошук у системі усіх компонентів, які потрібні для роботи із файлами &MIDI;. Типовим модулем обробки &MIDI; у &minuet; є TiMidity++/Freepats. Через це майстер налаштовування виконає перевірку, чи встановлено і налаштовано ці програми відповідним чином.

Майстер налаштовування &minuet; під час першого запуску

Якщо усі перевірки майстра налаштовування буде успішно пройдено, &minuet; автоматично запускатиме TiMidity++ під час запуску програми і завершуватиме його роботу під час виходу із програми. Запустити майстер налаштовування знову можна за допомогою пункту меню Параметри Запустити майстер налаштовування .

### Вправи і робота у &minuet;

Інтерфейс користувача &minuet; складається з чотирьох основних компонентів:

Компоненти графічного інтерфейсу &minuet;

Меню навігації

  Надає змогу здійснювати навігацію категоріями вправ &minuet; і вибирати певну вправу. Меню навігації буде динамічно створено на основі файлів специфікації, які описано у розділі Створення вправ. Вправи &minuet; згруповано за класами, зокрема на основі даних щодо інтервалів, гам та акордів.

Засобів керування відтворенням MIDI

  Надає доступ до основних функціональних можливостей для керування відтворенням &MIDI;. &minuet; може відтворювати довільні файли &MIDI; у відповідь на вибір пункту меню Файл Відкрити з наступним натисканням кнопки Пуск. Відтворення можна призупинити за допомогою натискання кнопки Пауза і відновити повторним натисканням кнопки Пуск. Натисканням кнопки Стоп можна перервати відтворення &MIDI;. На панелі керування відтворенням &MIDI; також передбачено повзунки для зміни гучності, ритму та тону поточного звуку &MIDI;.

Панелі клавіш

  Показує події відтворюється нота &MIDI;, які синтезуються із файла &MIDI; або під час виконання вправи.

Панелі вправи

  Тут для вказаної користувачем вправи буде показано кнопки керування представленням вправи та набір можливих відповідей. Розпочати виконання вправи можна натисканням кнопки Нове питання. У відповідь &minuet; відтворить випадково вибраний інтервал, акорд або гаму. Студент же має вибрати правильну відповідь із показаних варіантів. &minuet; завжди показуватиме невеличким білим кружечком на панелі клавіш першу ноту вибраного інтервалу або гами чи основну ноту вибраного акорду. Якщо користувач наведе вказівник на варіант відповіді, &minuet; підсвітить візуальний відповідник на панелі клавіш. Решту нот підсвіченої відповіді буде представлено невеличкими кружечками кольору, який збігається із кольором підсвіченої кнопки відповіді. Прослухати завдання ще раз можна натисканням кнопки Відтворити питання. Відповісти на питання можна натисканням кнопки відповіді. Отримати правильну відповідь можна натисканням кнопки Здатися. Новий варіант тієї самої вправи можна отримати у відповідь на натискання кнопки Нове питання.

## Створення нових вправ &minuet;

Вправи &minuet; визначаються у файлах специфікацій вправ, записаних у форматі JSON:

    {
      "exercises": [
        {
          "name": "Intervals",
          "root": "21..104",
          "playMode": "scale",
          "children": [
            {
              "name": "Ascending Melodic Intervals",
              "children": [
                {
                  "name": "Seconds",
                  "options": [
                    {
                      "name": "Minor Second",
                      "sequenceFromRoot": "1"
                    },
                    {
                      "name": "Major Second",
                      "sequenceFromRoot": "2"
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }

У файлах специфікації вправ &minuet; має міститися один об’єкт найвищого рівня JSON, що міститиме масив exercises. Цей масив визначає ієрархічну структуру вправ, згруповану за категоріями. Кожна категорія або вправа має свою назву. Об’єкти категорій JSON мають містити властивість із назвою children, яка описуватиме підкатегорії або вправи, що містяться у категорії. Об’єкти вправ JSON мають містити властивість із назвою options, яка визначає можливі відповіді у вправі. Під час кожного виконання вправи &minuet; вибирає серед можливих відповідей одну випадковим чином. Учень має натиснути кнопку вибраної програмою відповіді.

У кожній (під)категорії може визначатися параметр root, який вказує діапазон початкової ноти інтервалу, акорду або гами, з якого буде вибрано випадковим чином вибрано цю ноту для усіх вправ у категорії. Такий діапазон відповідає стандартним номерам нот &MIDI; і визначається у форматі <мінімальне значення>..<максимальне значення>. У наведеному вище прикладі використано увесь діапазон клавіш для основних нот (21..104). Параметр playMode вказує на спосіб відтворення можливих відповідей: як scale (гама, ноти одна за одною) або як chord (акорд, усі ноти одночасно).

Кожен із варіантів у вправі визначає назву і послідовність нот, які слід відтворити на основі основної ноти, яку програма вибирає випадковим чином на початку вправи. Така послідовність нот визначається як відносна відстань від основної ноти і описує інтервал, який кожна нота формує у поєднанні із основною нотою. Наприклад, для основної гами послідовність нот така: «2 4 5 7 9 11 12», що відповідно позначає структуру основної гами «ціла ціла половинна ціла ціла ціла половинна. Параметр sequenceFromRoot може містити дані щодо тривалості кожної з нот. Крім того, у ядрі обробки даних &minuet; передбачено, що буде показано лише відповіді, усі ноти яких лежать у межах клавіатури.

Для забезпечення кращої інфраструктури для упорядковування великого набору файлів специфікацій вправ у ядрі обробки даних &minuet; передбачено використання декількох файлів специфікацій, які автоматично об’єднуються для створення остаточної ієрархії вправ, які буде показано у меню навігації. Вправи буде об’єднано належним чином, якщо у файлах специфікацій використано під час визначення вправ однакові назви категорій або підкатегорій. У поточній версії &minuet; не передбачено графічного інтерфейсу для створення специфікацій вправ, отже файли JSON вам доведеться створювати у сторонньому текстовому редакторі. Файли специфікацій вправ &minuet; можна встановити на загальносистемному рівні до каталогу `/usr/share/minuet/exercises/` або на локальному рівня (для окремого користувача) до каталогу `~/.local/share/minuet/exercises/`.

## Налаштовування &minuet;

Деякі із параметрів &minuet;, пов’язаних і обробкою &MIDI;, можна налаштувати за допомогою пункту меню Параметри Налаштувати Minuet :

Параметри роботи &minuet;

Параметр TiMidity++ містить дані щодо абсолютного шляху до програми TiMidity++. Якщо ви працюєте у стандартному комп’ютерному середовищі, цей шлях буде автоматично визначено під час роботи майстра з налаштовування &minuet;. Втім, ви можете змінити його на бажаний для вас, якщо середовище не є стандартним.

За допомогою параметра Параметри TiMidity++ можна вказати параметри, які буде використано під час запуску служби TiMidity++. Варто використовувати саме параметри, які було визначено майстром налаштовування &minuet;, якщо у вас немає якоїсь вагомої причини використати інші параметри.

Нарешті, за допомогою параметра Порт виведення MIDI можна вказати порт, за допомогою якого &minuet; має відтворювати події &MIDI;. Знову ж таки, майстер налаштовування &minuet; має визначити правильне значення цього параметра, але ви можете змінити його, якщо використовуєте інші синтезатори &MIDI;, зокрема fluidsynth.

## Авторські права та ліцензування

&minuet;

Авторські права на програму належать &Sandro.Andrade; &Sandro.Andrade.mail;, 2016

Авторські права на документацію до програми належать &Sandro.Andrade; &Sandro.Andrade.mail;, 2016

Переклад українською: Юрій Чорноіван yurchor@ukr.net

&underFDL; &underGPL;

## Встановлення

### Вимоги

Для користування &minuet; вам знадобляться деякі бібліотеки з &kf5; 5.18 (CoreAddons, I18n, XmlGui, ConfigWidgets, DocTools, KIO). Крім того, для роботи &minuet; з &MIDI; потрібна бібліотека Drumstick.

&documentation.index;