# 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 två avsnitt, Starta 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)

### Övningar och arbetsflöde i Minuet

Användargränssnittet i Minuet består av tre 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.

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 eller lokalt i katalogen `minuet/exercises/` placerad i ``qtpaths` `--path GenericDataLocation``.

## 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;
&documentation.index;