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.
-
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
naarcsdosc
. -
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
node oscServer.js
. -
Je kunt de webserver nu gebruiken!
-
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
node oscServer.js
-
Je kunt de webserver nu gebruiken!
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 bestandenindex.html
ensketch.js
uitempty-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.
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
.
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.
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.