# startMelodie

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `music.startMelody`. English: `startMelody`.

Start een synthesepartituur op een benoemd spoor zonder het programma te blokkeren. De partituur kan noten, rusten en akkoorden bevatten. Gebruik [startOrkest](startOrkest.md) wanneer partijen met verschillende instrumenten samen moeten beginnen.

## Aanroep

```text
startMelodie(track, score, tempo = 120, instrument = "chip", loop = onwaar, tempoChanges = [])
```

## Voorbeeld

```pliro
# language: nl
startMelodie("thema", "C4+E4+G4:2 F4+A4+C5:2", 120, "gm.acoustic-grand-piano", onwaar, [[2, 90]])
wacht(3)
```

Het tweede akkoord begint na twee tellen, wanneer het tempo van 120 naar 90 BPM gaat.

## Partituur en tempo

Een partituur gebruikt met spaties gescheiden gebeurtenissen zoals `C4:1`, `C#4:0.5`, `Bb3:2`, `R:1` of `C4+E4+G4:2`. Akkoorden hebben maximaal acht verschillende toonhoogten met één gezamenlijke duur. Elke gebeurtenis duurt 1/64–64 tellen; een partituur bevat 1–4096 gebeurtenissen en duurt maximaal 4096 tellen.

Kies `chip`, `bell`, `pluck`, `flute`, `drums` of een exact ID uit de 128 `gm.`-instrumenten in de instrumentkeuze van Blokken of de componist. Toonhoogten moeten binnen MIDI 0–127 passen; drums gebruiken B1–A5.

De optionele laatste lijst `tempoChanges` bevat maximaal 256 paren `[telpositie, BPM]`. Posities beginnen bij nul, moeten strikt oplopen en vóór het einde van de partituur liggen. Tempo moet 20–400 BPM zijn. Een lege lijst houdt het tempo gelijk; een markering op nul vervangt het begintempo. Aangehouden noten blijven over een wijziging doorklinken. Herhalen speelt de hele partituur en de tempowijzigingen opnieuw.

## Sporen en uitvoeromgeving

De aanroep geeft `None` terug. Spoornamen zijn hoofdlettergevoelige tekst van 1–64 Unicode-tekens, niet leeg of alleen witruimte en zonder besturingstekens. Starten op een bestaande naam vervangt de audio en behoudt het volume. Gebruik `zetSpoorVolume` of `stopSpoor` om het te regelen. Er zijn maximaal 16 benoemde sporen en 32 tegelijk klinkende noten.

Houd een herhalend spoor actief met gebeurtenissen, een spellus of een positieve `wacht`. Normaal programma-einde stopt herhalingen; Stoppen/Resetten ruimt het afspelen op. Synthesegeluid heeft geen bestand nodig en werkt in de IDE, speeltuin en ondersteunde native Windows/Linux/Raspberry Pi-exports. De tekst-CLI en telefoonvoorbeeldweergave spelen het niet af.

De [melodie-editor en componist](../gidsen/muziek.md) bewerken gewone broncodepartituren. Optionele MIDI-keyboardinvoer hoort bij de editor; deze functie benadert geen MIDI-apparaten of -bestanden.