# Handbok &minuet;

## Inledning

Välkommen till &minuet;, &kde;:s programvara för musikutbildning. &minuet; har som mål att hjälpa elever och lärare i många av musikutbildningens aspekter, såsom gehörsövning, första notläsning, solmisering, skalor, rytm, harmonilära och improvisation. &minuet; använder &MIDI;-funktioner i stor utsträckning för att tillhandahålla en fullfjädrad uppsättning funktioner när det gäller volym, tempo och förändringar av tonhöjd, vilket gör &minuet; ett värdefullt verktyg för både nybörjare och erfarna musiker.

&minuet; har en rik uppsättning gehörsövningar och nya kan kan smidigt läggas till för att utöka funktionaliteten och anpassa den till olika musikutbildningssammanhang.

Gehörsövningar för ackord i &minuet;

## Använda &minuet;

I följande tre avsnitt, Starta &minuet;, Inställningsguiden i &minuet; och Övningar i &minuet;, ger vi dig de nödvändiga stegen för att komma igång med &minuet;.

### Starta &minuet;

&minuet; kan startas från Starta program. Visa &kde;:s programmeny genom att klicka på ikonen för Starta program i verktygsraden längst ner till vänster på skärmen. Det visar en meny. Flytta pekaren upp i menyn till menyalternativet Program Utbildning Diverse &minuet; (Programvara för musikutbildning)

### Inställningsguiden i &minuet;

När &minuet; startas för första gången, visas en inställningsguide som verifierar att alla beroenden som krävs för att hantera &MIDI;-filer finns på plats i systemet. &minuet; använder TiMidity++ eller Freepats som standardgränssnitt för &MIDI;. Därför kontrollerar inställningsguiden att dessa teknologier är riktigt installerade och inställda.

Inställningsguiden för första användning av &minuet;

Om alla kontrollerna i inställningsguiden lyckas, startar och stoppar &minuet; automatiskt TiMidity++ när programmet startas och avslutas. Det går att visa inställningsguiden när som helst igen genom att använda Inställningar Visa inställningsguide .

### Övningar och arbetsflöde i &minuet;

Användargränssnittet i &minuet; består av fyra huvuddelar:

Delar av användargränssnittet i &minuet;

Navigeringsmeny

- Gör det möjligt att navigera bland övningskategorierna i &minuet; och välja en viss övning. Navigeringsmenyn skapas dynamiskt baserat på övningsspecifikationsfiler som beskrivs i Skapa övningar. Övningarna i &minuet; är grupperade enligt klasser som intervall, skalor och ackord.

MIDI-spelarkontroller

- Tillhandahåller grundfunktioner för att hantera uppspelning med &MIDI;. &minuet; kan spela upp godtyckliga &MIDI;-filer genom att välja Arkiv Öppna och därefter klicka på knappen `Spela`. Uppspelningen kan pausas genom att klicka på knappen `Paus` och återupptas genom att åter klicka på knappen `Spela`. Knappen `Stopp` avbryter uppspelning av &MIDI;. Spelarkontroller för &MIDI; erbjuder också skjutreglage för att ändra volym, tempo och tonhöjd för den &MIDI;-fil som för närvarande spelas.

Klaviatur

- Visar `note on` &MIDI;-händelser sekvenserade av en &MIDI;-fil eller vid ett övningsutförande.

Övningsvy

- Visar knappar för att kontrollera presentation av övningen och en uppsättning möjliga svar på övningen, för en given övning. En övning börjar genom att klicka på knappen `Ny fråga`. Ett slumpmässigt valt interval, ackord eller skala spelas upp av &minuet;, och därefter förväntas eleven välja ett svar bland de som visas i svarsfältet. &minuet; visar alltid den första tonen för det valda intervallet eller skalan, eller grundtonen för det valda ackordet, som en liten vit cirkel i svarsfältet. Genom att hålla muspekaren över ett möjligt svar, markerar &minuet; den motsvarande visuella representationen på klaviaturen. Återstående toner i svaret som hålls över visas som små cirklar vars färger är samma som knappen för svaret som hålls över. Eleven kan lyssna på övningen igen genom att klicka på knappen `Spela upp fråga`, klicka på den valda svarsknappen, eller få rätt svar genom att klicka på knappen `Ge upp`. Ett nytt försök med samma övning kan startas genom att klicka på knappen `Ny fråga` igen.

## Skapa nya övningar för &minuet;

Övningar i &minuet; är definierade i övningsspecifikationsfiler, skrivna på JSON-format:

    {
      "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"
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }

Övningsspecifikationsfilerna i &minuet; innehåller ett JSON-objekt på toppnivån, som innehåller fältet `exercises`. Ett sådant fält definierar en hierarkisk struktur av övningar, grupperade enligt kategorier. Varje kategori och övning har ett namn. JSON-objekt för kategorier innehåller en egenskap benämnd `children`, som beskriver delkategorierna eller övningarna som är förenade med en sådan kategori. JSON-objekt för övningar innehåller en egenskap benämnd `options`, som definiera möjliga svar för en sådan övning. Vid varje övningstillfälle, väljer &minuet; slumpmässigt ett svar bland de möjliga, och eleven förväntas klicka på svarsknappen som motsvarar det valda svaret.

Alla (del)kategorier kan definiera parametern `root` för att ange omfång som grundtonen i intervallet, ackordet eller skalan kommer att väljas slumpmässigt från för alla övningar i kategorin. Sådana omfång motsvarar vanliga tonnummer i &MIDI; och har formatet `<minvärde>..<maxvärde>`. Exemplet som visas ovan använder hela klaviaturens omfång som möjliga grundtoner (21..104). Parametern `playMode` anger hur möjliga svar ska spelas upp: som en skala, `scale` (en ton i taget), eller som ett ackord, `chord` (alla toner ljuder samtidigt).

Alternativet för varje övning definierar ett namn och en tonföljd som ska spelas från grundtonen som väljes slumpmässigt vid varje övningstillfälle. En sådan tonföljd definieras som relativt avstånd från grundtonen, och beskriver intervallet som varje ton utgör i förhållande till grundtonen. Exempelvis för en durskala är tonföljden "2 4 5 7 9 11 12", vilket anger durskalans struktur "hel hel halv hel hel hel halv". Parametern `sequenceFromRoot` kan innehålla vilka toner som helst i längd. Dessutom försäkrar kärnan i &minuet; att bara svar vars toner befinner sig inom klaviaturens omfång väljes slumpmässigt.

För att skapa en bättre infrastruktur för att organisera en stor mängd övningsspecifikationsfiler, stöder kärnan i &minuet; användning av flera specifikationsfiler, som automatiskt sammanfogas för att skapa den slutliga övningshierarkin som visas i Navigeringsmeny. Övningar sammanfogas på ett riktigt sätt, under förutsättning att olika specifikationsfiler använder samma (del)kategorinamn när övningar definieras. För närvarande erbjuder inte &minuet; något grafiskt gränssnitt för att skapa övningsspecifikationer, och sådana JSON-filer måste alltså skapas för hand. Övningsspecifikationsfiler i &minuet; kan installeras för hela systemet i katalogen `/usr/share/minuet/exercises/` eller lokalt i katalogen `~/.local/share/minuet/exercises/`.

## Inställning av &minuet;

Vissa av &MIDI;-inställningarna i &minuet; kan ställas in med Inställningar Anpassa Minuet :

Inställningarna i &minuet;

Parametern `TiMidity++` innehåller den absoluta sökvägen till programmet TiMidity++. En sådan sökväg ställs automatiskt in av inställningsguiden i &minuet; om miljön är rimlig, men det går att ange en egen inställning om man vill.

`TiMidity++ parametrar` anger parametrarna som ska användas när tjänsten TiMidity++ startas. Värdet som tillhandahålls av inställningsguiden i &minuet; bör användas, om det inte finns en god anledning att ändra det.

Slutligen anger parametern `MIDI-utgång` utgången som &minuet; ska använda för att spela upp &MIDI;-händelser. Återigen, ger inställningsguiden i &minuet; redan bra värden för den, men man har möjlighet att använda andra &MIDI;-sekvensenheter, exempelvis fluidsynth.

## Tack till och licens

&minuet;

Program copyright 2016 &Sandro.Andrade; &Sandro.Andrade.mail;

Dokumentation Copyright © 2016 &Sandro.Andrade; &Sandro.Andrade.mail;

Översättning Stefan Asserhäll stefan.asserhall@bredband.net

&underFDL; &underGPL;

## Installation

### Krav

För att använda &minuet; med lyckat resultat behövs några få bibliotek från KF5 5.18 (CoreAddons, I18n, XmlGui, ConfigWidgets, DocTools, KIO). Dessutom förlitar sig &minuet; på biblioteket Drumstick för &MIDI;-funktioner.

&documentation.index;