# startOrkest

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `music.startOrchestra`. English: `startOrchestra`.

Start maximaal 16 gesynchroniseerde muziekpartijen op één benoemd spoor zonder het programma te blokkeren.

## Aanroep

```text
startOrkest(track, parts, tempo = 120, loop = onwaar, tempoChanges = [])
```

Elke partij is een lijst `[instrument, score]` of `[instrument, score, volume]`. Volume is standaard 100 en loopt van 0 tot 100. De partijen mogen een letterlijke lijst, variabele of berekende lijst zijn.

## Voorbeeld

```pliro
# language: nl
laat partijen = [
    ["gm.acoustic-grand-piano", "C4+E4+G4:2 F4+A4+C5:2", 75],
    ["gm.cello", "C3:2 F2:2", 60],
    ["drums", "C2:1 D2:1 C2:1 D2:1", 35]
]
startOrkest("lied", partijen, 120, onwaar, [[2, 90]])
wacht(3)
```

De eerste twee tellen gebruiken 120 BPM. Daarna gaan alle partijen naar 90 BPM. Het arrangement van vier tellen duurt ongeveer 2,33 seconden.

## Partijen, volume en herhalen

Alle partijen delen één startmoment. De langste partituur bepaalt de gezamenlijke lengte; kortere partijen wachten tot dat punt. Bij `loop = waar` herhaalt het hele arrangement samen.

Het orkest gebruikt één benoemd spoor. `zetSpoorVolume(track, percentage)`, `stopSpoor(track)` en vervanging gelden voor elke partij. Partijvolume, spoorvolume en hoofdvolume worden vermenigvuldigd. Een nieuw orkest op dezelfde naam vervangt het geluid en behoudt het spoorvolume.

Kies een exact `gm.`-instrument-ID, `drums` of `chip`, `bell`, `pluck`, `flute`. De instrumentkeuze in Blokken en de componist bevat alle 128 GM-programma's. Partituren accepteren losse noten, rusten en akkoorden zoals `C4+E4+G4:2`. Bij drums kiezen B1–A5 uit de 47 slagwerkklanken.

## Tempowijzigingen en grenzen

`tempoChanges` is een lijst met maximaal 256 paren `[telpositie, BPM]`. Posities beginnen bij nul, moeten strikt oplopen en vóór het einde van de langste partituur liggen. BPM moet 20–400 zijn. Een markering op nul vervangt `tempo`; markeringen beginnen elke herhaling opnieuw. Noten over een markering blijven aangehouden.

Er zijn 1–16 partijen en samen maximaal 4096 partituurgebeurtenissen. Elke partituur duurt maximaal 4096 tellen, met gebeurtenissen van 1/64–64 tellen en maximaal acht verschillende toonhoogten per akkoord. Het afspelen deelt de grens van 32 tegelijk klinkende noten. Er zijn maximaal 16 benoemde sporen. Ongeldige argumenten laten bestaande audio ongewijzigd.

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

[Componist en MIDI-invoer](../gidsen/muziek.md) · [startMelodie](startMelodie.md) · [zetSpoorVolume](zetSpoorVolume.md)