HelpSource/Classes/NodeMap.schelp

   1 class:: NodeMap
   2 summary:: store control values and bus mappings
   3 categories:: Libraries>JITLib>NodeProxy
   4 related:: Classes/Bus
   5
   6 description::
   7 Object to store control values and bus mappings independant of of a specific node.
   8
   9 InstanceMethods::
  10
  11 method::set
  12 set arguments of a node
  13
  14 method::map
  15 set bus mappings of a node
  16
  17 method::unset
  18 remove settings
  19
  20 method::unmap
  21 remove mappings
  22
  23 method::setn
  24 set ranges of controls
  25
  26 method::mapn
  27 map num busses mappings to node
  28
  29 method::at
  30 return setting at that key.
  31
  32 method::sendToNode
  33 apply a setting to a node by sending a bundle
  34
  35 method::send
  36 apply a setting to a node by sending a bundle
  37
  38 method::addToBundle
  39 add all my messages to the bundle
  40
  41 Examples::
  42
  43 code::
  44
  45 s.boot;
  46
  47 (
  48 SynthDef("modsine",
  49         { arg freq=320, amp=0.2;
  50                 Out.ar(0, SinOsc.ar(freq, 0, amp));
  51         }).send(s);
  52 SynthDef("lfo",
  53         { arg rate=2, busNum=0;
  54                 Out.kr(busNum, LFPulse.kr(rate, 0, 0.1, 0.2))
  55         }).send(s);
  56 )
  57
  58 //start nodes
  59 (
  60 b = Bus.control(s,1);
  61 x = Synth("modsine");
  62 y = Synth.before(x, "lfo", [\busNum, b]);
  63 )
  64
  65 //create some node maps
  66 (
  67 h = NodeMap.new;
  68 h.set(\freq, 800);
  69 h.map(\amp, b);
  70
  71 k = NodeMap.new;
  72 k.set(\freq, 400);
  73 k.unmap(\amp);
  74 )
  75
  76 //apply the maps
  77
  78 h.sendToNode(x); //the first time a new bundle is made
  79 k.sendToNode(x);
  80
  81 h.sendToNode(x); //the second time the cache is used
  82 k.sendToNode(x);
  83
  84 h.set(\freq, 600);
  85
  86 h.sendToNode(x); //when a value was changed, a new bundle is made
  87
  88 //free all
  89 x.free; b.free; y.free;
  90 ::