csdosc

CSDOSC is een server gemaakt in Node.js die we gebruiken tijdens de lessen SYSBAS1A en SYSBAS1B. Het is een lokale webserver waarop je webpagina's kan draaien. Daarnaast heeft het functies voor Open Sound Control, te gebruiken in combinatie met P5.js.

Installatie MacOS

• Download of clone via de groene knop Clone or download alle bestanden van deze github naar je harde schijf en zet deze in de HKU/SYSBAS-map.

• Als je de bestanden gedownload hebt: pak de .zip-file uit en hernoem csdosc-master naar csdosc.

• Download node.js via https://nodejs.org/en/download/ en installeer dit.

• Ga in de terminal naar de map waarin je de csdosc-bestanden hebt gezet (bijvoorbeeld cd ~/HKU/SYSBAS/csdosc) en typ hier: npm install

• Typ nu npm start.

• Nu verschijnt er de volgende mededeling: De server staat aan! Je kunt deze via localhost:8001 bereiken. (verschijnt dit niet, kom dan in de les naar ons voor hulp)

• Je kunt de webserver nu gebruiken!

Installatie Windows (met gebruik van Ubuntu)

• Als je Ubuntu nog niet hebt geïnstalleerd, volg dan de stappen in de Syllabus

• Ga naar de Sysbas-folder via het commando: cd /mnt/c/Users/Jouwnaam/HKU/Sysbas (of iets vergelijkbaars, afhankelijk van waar jouw HKU-bestanden staan op je harde schijf)

• Clone de bestanden van github naar je schijf met het volgende commando: git clone https://github.com/csdhku/csdosc.git

• Ga vervolgens naar de map die binnengehaald is: cd csdosc

• Installeer node-js door de volgende commando's in te typen:
  sudo apt-get update
sudo apt-get install nodejs
sudo apt-get install npm

• Vervolgens moet je de osc-server app configureren voor jouw systeem:

• Voer daarvoor de volgende commando's in:
  npm install

• Typ nu npm start

• Nu verschijnt er de volgende mededeling: De server staat aan! Je kunt deze via localhost:8001 bereiken. (verschijnt dit niet, kom dan in de les naar ons voor hulp)

• Je kunt de webserver nu gebruiken!

Gebruik

We gebruiken deze node-js server in eerste instantie als lokale webserver voor het weergeven van html-bestanden in de browser. Hiermee kunnen we p5js projecten bekijken. Een exrtra functie: OSC-communicatie komt later aan bod.

• Zodra je in de terminal node oscServer.js intypt start de node-js server en verschijnt er de volgende mededeling: De server staat aan! Je kunt deze via localhost:8001 bereiken.
• Dit betekent dat er nu een lokale webserver draait die luistert naar de poort 8001.
• Je kunt nu in jouw favoriete webbrowser naar localhost:8001 gaat zal er een tijdelijke website verschijnen.
• Je kunt vervolgens een nieuwe project starten: maak in de p5js map een nieuwe map genaamd first_sketch en kopieer de twee bestanden index.html en sketch.js uit empty-example daarnaartoe.
• Ga nu in de browser naar localhost:8001/first_sketch en je zult hier een lege p5js sketch zien.
• Je kunt deze sketch vervolgens aanpassen naar jouw wensen.
• Maak voor elk nieuw project een nieuwe map en gebruik de voorbeelden uit empty-example als basis.

OSC

Naast dat het programma oscServer.js dient als webserver om P5js-projecten in je browser te laten zien wordt het ook gebruikt als Open Sound Control (OSC)-server. Met OSC kan je aansturingsberichten via een netwerk sturen naar andere applicaties die dit protocol ondersteunen. Voorbeelden hiervan zijn Max, Pure Data, Supercollider, Reaper, Live en Logic. Je kunt OSC enigszins vergelijken met midi. Met als groot voordeel dat je niet gelimiteerd bent tot een range van 128 waardes.
Een OSC-bericht bestaat uit twee onderdelen. Een adres en een waarde. Het adres is opgebouwd uit een of meer delen, elk gescheiden door een /. Bijvoorbeeld: /synth/oscillator1/pitch of /x. De waarde kan van alles zijn, een integer, floating point getal of een stukje tekst. Een compleet OSC-bericht kan er dus als volgt uitzien: /synth/filter/cutoff 500 of /synth/filter/mode lpf of /synth/amplitude 0.5.

In bovenstaande git-repository zijn twee voorbeeldsketches toegevoegd die de werking van OSC laten zien binnen oscServer.js. Dit zijn example_server en example_client.

server

In example_server staat een voorbeeld van een sketch die luistert naar berichten die worden verstuurd naar poort 9000. Een OSC-server staat open op één specifieke poort. Alle berichten die naar die poort worden vestuurd worden ontvangen door de server, ongeacht van welk IP-adres ze afkomstig zijn.
In het voorbeeld staat per regel code uitgelegd wat het doet in de sketch.

client

In example_client staat een voorbeeld van een sketch die berichten verstuurt naar een specifieke poort op een specifiek IP-adres. In dit geval poort 9000 op het IP-adres 127.0.0.1. Het IP-adres 127.0.0.1 is het adres op berichten binnen je eigen computer te versturen. In het voorbeeld staat per regel code uitgelegd wat het doet in de sketch.