# Het handboek van &minuet;

## Inleiding

Welkom bij &minuet;: de software voor muziekeducatie. Het programma is opgebouwd rond korte oefeningen waarmee u kunt luisteren, reageren en uw voortgang kunt testen, zonder de toepassing te verlaten.

De toepassing omvat momenteel melodische gehoortraining, ritmeherkenning, klapoefeningen en zangoefeningen. Dezelfde oefening kan vaak op meerdere manieren worden uitgevoerd; daarom vraagt ​​de interface eerst of u wilt luisteren en herkennen, lezen en klappen, of lezen en zingen.

&minuet; startscherm Het startscherm van &minuet;

De startpagina is bewust minimalistisch gehouden. Gebruik het navigatiemenu om naar de instellingenpagina, de pagina 'Over ons' of een categorie oefeningen te gaan.

## &minuet; gebruiken

Het normale verloop is eenvoudig: start, kies een oefening, selecteer een oefenmodus en doorloop vervolgens een vraag of een proefronde.

### Beginnen met &minuet;

Start &minuet; vanuit het toepassingenmenu of vanuit een terminal door `minuet` uit te voeren. Wanneer de toepassing opent, toont de startpagina één enkele melding: Kies een oefening.

### Bekijk en kies oefeningen

De oefeningenbrowser groepeert onderwerpen op thema. Gebruik het zijpaneel of de categorieënlijst om toegang te krijgen tot akkoorden, intervallen, ritmes of toonladders. De browser werkt zichzelf bij op basis van de geïnstalleerde specificatiebestanden voor oefeningen, zodat de zichtbare hiërarchie een weerspiegeling is van de momenteel beschikbare oefeningen.

&minuet; oefeningenoverzicht Het oefeningenoverzicht in &minuet;

Elk oefenitem heeft een titel en een korte beschrijving. Sommige categorieën leiden direct naar een oefening, terwijl andere zich vertakken in subcategorieën. De lijst is niet hard gecodeerd: nieuwe oefenbestanden worden automatisch in de hiërarchie opgenomen wanneer &minuet; wordt gestart.

### Wijze van oefenen

Wanneer u een oefening opent, vraagt ​​&minuet; hoe u deze wilt oefenen.

&minuet; keuze voor oefenmodus De keuze voor de oefenmodus in &minuet;

Er zijn twee brede praktijkrichtingen:

- Luisteren en herkennen speelt de oefening af en vraagt u om een ​​antwoord te kiezen uit de beschikbare opties. Dit is de standaardprocedure voor melodische gehoortraining.

- Lezen en klappen wordt weergegeven bij ritme-oefeningen. Lezen en zingen wordt weergegeven bij melodische oefeningen die vocale invoer accepteren, zoals intervallen en toonladders.

De keuze van de oefening verandert de invoermodus, niet de onderliggende oefencategorie. Dit betekent dat u dezelfde oefengegevens kunt gebruiken voor luister-, klap- of zangoefeningen, afhankelijk van het onderwerp.

### Melodische gehoortraining

Melodische oefeningen volgen het klassieke Minuet-verloop: de toepassing speelt een vraag af, toont antwoordopties en biedt de mogelijkheid om het fragment opnieuw af te spelen als u het nog eens wilt horen. Deze handmatige modus wordt gebruikt voor intervallen, toonladders en akkoorden wanneer u kiest voor Luisteren en herkennen.

&minuet; akkoordoefening in handmatige modus Een akkoordoefening in de handmatige modus in &minuet;.

De oefenpagina biedt de bedieningselementen die u nodig hebt voor een enkele vraag of een langere testsessie:

- Nieuwe vraag start een nieuwe vraag.

- Vraag afspelen herhaalt de huidige prompt.

- Opgeven onthult het antwoord.

- Test starten start een reeks vragen die worden beoordeeld.

- Test stoppen beëindigt de testuitvoering.

Bij melodische oefeningen blijven de antwoordknoppen en de weergave van het klavier of de notenbalk op elkaar uitgelijnd, zodat u kunt zien hoe elk alternatief overeenkomt met de gespeelde noten.

Bij akkoordoefeningen wordt dezelfde handmatige werkwijze gehanteerd, maar de opgave wordt als akkoord afgespeeld in plaats van als melodische reeks. &minuet; speelt het akkoord af, toont de grondtoon op het klavier en de notenbalk, en vraagt ​​u een akkoordtype te kiezen uit de beschikbare antwoorden. De akkoordencatalogus omvat drieklanken, omkeringen, onderdrukte-akkoorden, septiemakkoorden, none-akkoorden, undeciemakkoorden en gemengde akkoordensets zoals Veel akkoorden.

Gebruik Vraag afspelen om het akkoord nogmaals te horen voordat u antwoord geeft. In de testmodus beoordeelt &minuet; de reeks op basis van het aantal oefeningen dat op de instellingenpagina is geconfigureerd.

### Ritme en klappen

Ritmische oefeningen richten zich op timing in plaats van toonhoogte. In de klapmodus luistert &minuet; naar de input van uw microfoon en vergelijkt de aanzetten met het doelpatroon.

De categorieën Eenvoudig met rusten en Gemiddeld met rusten voegen stille momenten toe aan de bijbehorende patronen die alleen uit noten bestaan. Bij luisteroefeningen worden opties vermeden die identiek klinken, terwijl Lezen en klappen alle gecombineerde patronen van noten en rusten omvat.

Klapoefening van &minuet; Een ritmische klapoefening in &minuet;

De klapweergave toont de kaarten met ritmepatronen, een ingangsniveaumeter en een Stilte kalibreren-functie. Er vindt een aftelmoment plaats voordat de opname begint, zodat u in het juiste tempo kunt komen voordat de oefening op klappen gaat letten.

Gebruik de ritme-oefening om te werken aan:

- eenvoudige ritmische figuren op het gehoor herkennen;

- je handgeklap afstemmen op de beat;

- binnen de geconfigureerde tijdtolerantie blijven.

### Zangoefeningen

Bij zangoefeningen wordt de microfoon gebruikt om wat u zingt te vergelijken met de beoogde toonhoogte. Voor zowel interval- als toonladderoefeningen wordt hetzelfde oefenscherm gebruikt, maar de doelstelling en de terugkoppeling passen zich aan de gekozen oefening aan.

Bij intervaloefeningen speelt &minuet; de grondtoon af en vraagt u het gevraagde interval ten opzichte daarvan te zingen. Bij toonladeroefeningen toont de toepassing een toonladder of kerktoonladder en wordt van u verwacht dat u de noten op volgorde zingt, waarbij u zuiver en in de maat blijft.

&minuet; zangoefening voor intervallen Een zang- en intervaloefening in &minuet; &minuet; toonladderoefening voor zang Een zangoefening met toonladders in &minuet;

De zangweergave toont de doelnoten, terugkoppeling over toonhoogte en aanzet, een live-ingangsmeter en een actie om stilte te kalibreren (Stilte kalibreren). &minuet; telt ook af voor de eerste noot, zodat u op de juiste tel kunt beginnen. De toonladderweergave past dezelfde terugkoppeling toe op langere reeksen, waardoor deze geschikt is voor het oefenen van het melodisch geheugen, naast het zuiver zingen van toonhoogtes.

Zangoefeningen worden beïnvloed door verschillende instellingen:

- Stemtype selecteert het verwachte stembereik.

- Toonhoogtetolerantie bepaalt hoe ver een gezongen noot van de doeltoonhoogte mag afwijken.

- Timing-tolerantie bepaalt hoeveel ritmische afwijking bij handgeklap wordt toegestaan.

## Instellingen

De instellingenpagina is onderverdeeld in vier secties: Oefenen, Geluid, Microfoon en Geavanceerd. De eerste drie secties tonen de basisinstellingen. De sectie 'Geavanceerd' blijft ingeklapt totdat u deze opent.

Basisinstellingen van &minuet; De pagina met basisinstellingen in &minuet;

De zichtbare instellingen omvatten de bedieningselementen die de meeste gebruikers dagelijks nodig hebben:

- Oefensnelheid bepaalt het tempo in slagen per minuut.

- Aantal ritmepatronen bepaalt de grootte van de ritme-oefensets.

- Aantal oefeningen bepaalt de duur van een testrun.

- Volume regelt het afspeelvolume.

- Instrument selecteert het melodische geluid dat voor gehoortraining wordt gebruikt.

- Stemtype selecteert het beoogde zangbereik.

Het microfoongedeelte bevat ook korte toelichtingen bij de instellingen voor tolerantie en kalibratie. Deze beschrijvingen leggen uit wanneer de tolerantie moet worden aangescherpt en wanneer de stilte opnieuw moet worden gekalibreerd.

Geavanceerde instellingen van &minuet; Het gedeelte met geavanceerde instellingen in &minuet;

Via de geavanceerde instellingen krijgt u toegang tot detectie-algoritmen en drempelwaarden voor lastige microfoons of rumoerige ruimtes. Gebruik deze instellingen wanneer het standaarddetectiegedrag niet volstaat. Dit gedeelte is standaard ingeklapt en bevat een knop Terug naar standaardwaarden, waarmee u de fabrieksinstellingen kunt herstellen nadat u met de instellingen hebt geëxperimenteerd.

De geavanceerde sectie bevat aparte groepen voor het detecteren van klappen en zingen. Typische instellingen zijn onder andere de beginmethode, de begindrempel, de ingangspoort, de minimale beginsterkte, het stilteniveau, de toonhoogtemethode, de scoringsmodus, de toonhoogtebetrouwbaarheid en stabiele toonhoogtekaders.

## Nieuwe oefeningen voor &minuet; aanmaken

De oefeningen van &minuet; worden gedefinieerd in &JSON;-specificatiebestanden. De toepassing laadt bij het opstarten alle beschikbare bestanden en voegt deze samen tot de zichtbare oefeningenboom.

    {
      "exercises": [
        {
          "name": "Intervallen",
          "root": "29..69",
          "playMode": "toonladder",
          "userMessage": "Hoor het interval en kies uw antwoord",
          "numberOfSelectedOptions": 1,
          "_icon": "minuet-intervals-symbolic.svg",
          "children": [
            {
              "name": "Oplopende melodische intervallen",
              "and-tags": ["interval", "oplopend"],
              "children": [
                {
                  "name": "Secunden",
                  "or-tags": ["2"],
                  "description": "Oefenen met identificeren van oplopende melodische secunden op gehoor."
                }
              ]
            }
          ]
        }
      ]
    }

Het hoofdobject bevat een `oefeningen`-array. Elk element in dat array is ofwel een categorie, ofwel een oefening (als eindpunt). Categorieën gebruiken `children` om het volgende niveau van de boomstructuur te definiëren.

Bruikbare velden zijn onder andere:

- `name` geeft elk knooppunt zijn zichtbare label.

- `root` beperkt het bereik van noten dat wordt gebruikt om de prompt te genereren.

- `playMode` selecteert weergave van de toonladder, het akkoord of het ritme.

- `userMessage` past de instructie aan die aan de gebruiker wordt getoond.

- `numberOfSelectedOptions` bepaalt hoeveel antwoorden correct mogen zijn.

- `_icon` bepaalt het pictogram dat in de lade en de oefeningenbrowser wordt weergegeven.

- `and-tags` en `or-tags` helpen bij het groeperen en filteren van gerelateerde knooppunten.

- `description` geeft de browser een korte uitleg over het knooppunt.

- `options` beschrijft de antwoordopties voor een zij-oefening.

- `sequenceFromRoot` definieert de toonafwijkingen voor melodische antwoorden.

- `template` wordt door ritme-oefeningen gebruikt om de notatie weer te geven.

De toepassing voegt bestanden samen die dezelfde categorienamen delen, zodat afzonderlijke specificatiebestanden kunnen bijdragen aan één zichtbare hiërarchie. Installeer ze systeembreed of plaats ze in `minuet/exercises/` onder de algemene datalocatie die wordt geretourneerd door ``qtpaths` `--paths GenericDataLocation``.

## Dankbetuigingen en licentie

&minuet;

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

Documentatie copyright © 2026 &Sandro.Andrade; &Sandro.Andrade.mail;

&meld.fouten;&vertaling.freek; &underFDL; &underGPL;
&documentation.index;