startMelodie

Ingebouwde functies

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 wanneer partijen met verschillende instrumenten samen moeten beginnen.

Aanroep

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

Voorbeeld

# 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 bewerken gewone broncodepartituren. Optionele MIDI-keyboardinvoer hoort bij de editor; deze functie benadert geen MIDI-apparaten of -bestanden.