~kulthauskante/nsynth/devel

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
nonlimitedSynth - Backend to reacTIVision

== Requirements ==

Linux:
 - Libs and Headers:
   - Qt 4.4
   - Portaudio 1.9
   - CLAM Devel
   - OpenGL

Windows:
 - Not supported yet


== Compile ==
just run 
$ scons clam_prefix=clam_prefix [-j JOBS]


== Configure ==

-- nSynth

  You can configure the Fiducial Mapping and other properties in file
  "nonlimitedSynth.xml"
  
  If you want to use LineIn, you have to set a valid input-capable device.
  Within <common>:

  <audio device="PA-Device-Number" in="2" out="2">
   - Will mean: using soundcard PA-Device-Number with stereo input and output.

  The PortAudio device numbers are listed upon startup of application.

-- TUIO Simulator

  The file tuio-sim-config.xml is preconfigured for the mapping specified in
  nonlimitedSynth.xml.
  
  It followes the usual ideals of reactable:
  - Squares: Generator ( Sine, Rectangle, 2x Sawtooth, LineIn)
  - Rounded-Squares: Filter (Band-, 2x Low-. High-Pass)
  - Circles: Controller (2x Sine, 2x Rectangle)

  The pentagons are not yet usable.

== Run ==

$ ./nSynth 
will be fine.

If you encounter sound crackle, you might have to run
 
$ sudo nice -n -10 ./nSynth

or adjust your sound config as mentioned in chapter "Configuration".

== TODO ==
- Internals need to be better integrated and well documented
- Cursor Input Management
- More Tangibles of course