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

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

    yurchor@ukr.net

Переклад українською
2016
&Sandro.Andrade;
&FDLNotice;
9 грудня 2016 року
Програми 16.12

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

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

## Вступ

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

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

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

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

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

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

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

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

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

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

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

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

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

  Показує події `відтворюється нота` &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; можна встановити на загальносистемному рівні до каталогу `minuet/exercises/` або на локальному рівня (для окремого користувача) до підкаталогу `minuet/exercises/` у каталозі, що визначається командою ``qtpaths` `--path GenericDataLocation``.

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

&minuet;

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

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

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

&underFDL; &underGPL;

&documentation.index;