De syntax van CAL

Allereerst wil ik ingaan op de structuur en opbouw van een CAL-programma. De syntaxis van Cakewalk lijkt sterk op de programmeertaal LISP en dat is even wennen als je hiermee geen ervaring hebt.

In CAL ziet dit er uit als: (- 2 1)

Het min-teken is een functie en de twee getallen zijn de variabelen die bij de aftrekking worden gebruikt. We geven in het volgende voorbeeld de functie (operator) aan met op en de variabelen met var. Een CAL-programma ziet er gestileerd weergegeven als volgt uit:

(do (op var var) (op var var))

Deze geneste structuur is kenmerkend voor CAL. Om de leesbaarheid van een programma te bevorderen, wordt het echter meestal niet op één lijn geschreven:

Binnen de do opdracht staat het programma. De do opdracht geeft een rij van opdrachten (statements) aan die bij elkaar horen en dus als het ware één functie vormen.

Variabelen moeten echter alvorens te worden gebruikt, worden gedefinieerd (gedeclareerd); anders worden ze niet door CAL herkend en gezien als een onbekende functie.

Alvorens dieper op de taal in te gaan, wil ik bespreken hoe CAL programma’s gebeurtenissen (Events) in een MIDI-sequence behandelt. Events kunnen zijn: Chords, ‘Channel aftertouch’, Controllers, Expressions, Hair pins, ‘Key aftertouch’, Lyrics, ‘Non-registered Parameter Numbers’, Notes, Patches, ‘Registered Parameter Numbers’, ‘System Exclusive Data Messages’, Text, Wave, Windows ‘Media Control Interface commands’ en Wheel. Het is een mengeling van MIDI, Audio en blad­muziek zaken.

Een MIDI-sequence is georganiseerd per track met Events die op een bepaalde tijd plaatsvinden. Ook is het goed om te realiseren dat als je een MIDI-Channel associeert met een track, alle Events in deze track over het betreffende channel van deze track worden uitgezonden. Een CAL-programma werkt op (een deel van) geselecteerde tracks en loopt één voor één langs deze tracks en bewerkt eventueel de Events in de betreffende track.

Om een beter gevoel te krijgen hoe dit gaat nemen we een klein programma als voorbeeld. In het voorbeeld worden alle noten die zijn geselecteerd op een velocity 100 gezet. De geselecteerde range wordt in het Cakewalk ‘user window’ aangegeven met de waarden in de vensters From en Thru.

Ik heb regelnummers ingevoerd die er normaal niet zijn, maar nu helpen bij de uitleg. Het inspringen maakt het programma leesbaarder, maar is niet strikt noodzakelijk.

Omdat er geen eigen variabelen worden gebruikt, heeft het programma geen declaraties nodig.

1. De functie forEachEvent geeft aan dat de opdrachten binnen deze functie voor alle Events die door de gebruiker geselecteerd zijn, worden uitgevoerd. Dat kan dus zijn in alle tracks, in een deel hiervan of op een aantal Events in één track. Deze functie is een heel belangrijke in CAL en wordt veelvuldig gebruikt.
2. Als (if) het Event type (Event.Kind) gelijk is (= =) [1] aan een NOTE,
3. wordt de note velocity (Note.Vel) wordt gelijkgemaakt (=) aan 100.
4. Geeft het einde van de functie if aan.
5. Geeft het einde van de functie forEachEvent aan.

In dit programma zie je verder, dat een statement meer dan één regel mag bevatten:

• forEachEvent begint op regel 1 en eindigt op regel 5.

• if begint op regel 2 en eindigt op regel 4.

Ik wil nu verder ingaan op de belangrijkste data typen, Events, variabelen en constanten.