IF3Si/doc/README.md

92 lines
2.3 KiB
Markdown
Raw Normal View History

2016-01-05 15:46:12 +01:00
Structure of code
-----------------
Main components of this project are three:
* Processing code taking care of visuals (in folder pde/)
* SuperCollider code - generative and live sound, GUI interface for touchscreen (in folder scd/)
* Renoise module - composition (sound) and midi triggers for Processing/visuals (in foder rnx/)
Helper folders:
* dat/ contains some data for SuperCollider (for now)
* smp/ contains samples for SuperCollider
* doc/ contains some simple documentation (this file!)
* dev/ is some development code (may not be in git)
* textures for Processing are in pde/IF3Si/images and may not be in git)
How is this run?
================
Hardware setup contains of a computer running a capable OpenGL card (Nvidia?) with two displays. One is a multitouch display device (1920x1080 but not necessary), the other is either a simple display monitor or a projector capable of 60fps at FullHD (1080p). Underlaying OS is Linux.
## Software
2016-01-05 15:56:11 +01:00
Edit `~/.processing/preferences.txt` and change `run.display=1` accordingly. I have it on 1, since 0 is my 'primary' display, which is the touchscreen. See also an example xorg.conf. I personally do the following - I access everything through a remote laptop, loging in through ssh. Processing applet is run remotely by using two small bash scripts:
2016-01-05 15:46:12 +01:00
2016-01-05 15:56:11 +01:00
*processing-runsketch.sh* (this one needs to be on the executable path):
2016-01-05 15:51:17 +01:00
```bash
2016-01-05 15:46:12 +01:00
#!/bin/bash
if [[ -z $1 ]]; then
echo "error. no argument."
echo "need the sketch path"
else
export DISPLAY=":0"
~/src/processing-2.2.1/processing-java \
--force \
--sketch=$1 \
--run \
--output=$1/output
2016-01-05 15:51:17 +01:00
fi
```
2016-01-05 15:46:12 +01:00
and
2016-01-05 15:51:17 +01:00
*processing-runsketch_IF3.sh*:
```bash
#!/bin/bash
2016-01-05 15:46:12 +01:00
while (true)
do
# clear
processing-runsketch.sh ~/PROJECTS/IF3Si/pde/IF3Si/
echo
echo "~~~ Program has quit. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - "
echo
2016-01-05 15:51:17 +01:00
done
```
2016-01-05 15:46:12 +01:00
### SuperCollider
2016-01-05 15:46:12 +01:00
*IF3supercollider.sh*:
```bash
#!/bin/bash
export DISPLAY=":0.0"
/usr/local/bin/sclang ~/PROJECTS/IF3Si/scd/IF3Si.scd
```
2016-01-05 15:46:12 +01:00
2016-01-05 16:41:11 +01:00
## notes
Monitor files while developing to restart Processing sketch on save with `entr`. After running the sketch in one terminal with `processing-runsketch_IF3.sh`, in another terminal run something like
```
ls PROJECTS/IF3Si/pde/IF3Si/*.pde | entr killall /home/random/src/processing-2.2.1/java/bin/java
```
2016-01-05 15:46:12 +01:00
.