HelpSource/Classes/Monitor.schelp

   1 class:: Monitor
   2 summary:: link between busses
   3 categories:: Libraries>JITLib>NodeProxy
   4 related:: Classes/NodeProxy
   5
   6 description::
   7 For playing contiguous channels to other contiguous busses, one uses strong::play::; for more complex routings, such as splitting, spreading etc to multiple channels, strong::playN::.
   8
   9 InstanceMethods::
  10
  11 method::play
  12 plays from a bus index with a number of channels to another index with a number of channels, within a target group, or a server.
  13
  14 argument::fromIndex
  15
  16 argument::fromNumChannels
  17
  18 argument::toIndex
  19
  20 argument::toNumChannels
  21
  22 argument::target
  23 where to play (default: server default group)
  24
  25 argument::multi
  26 keep old links and add new one
  27
  28 argument::volume
  29 volume at which to monitor
  30
  31 argument::fadeTime
  32 fade in fade out time
  33
  34 argument::addAction
  35
  36 method::playN
  37
  38 the arguments strong::out::, strong::amp:: and strong::in:: can be nested arrays. see also link::Reference/playN::
  39
  40 argument::out
  41 array of destination channels
  42
  43 argument::amp
  44 array of amplitudes for each channel
  45
  46 argument::in
  47 array of source channels
  48
  49 argument::vol
  50 global scaling for amplitudes
  51
  52 argument::fadeTime
  53 fade in and out
  54
  55 argument::target
  56 where to play (default: server default group)
  57
  58 argument::addAction
  59
  60 method::isPlaying
  61 returns true if the group is still playing
  62
  63 method::stop
  64 stops within the fadeTime
  65
  66 method::vol
  67 set the volume
  68
  69 method::out
  70 set the output index. doesn't work right now.
  71
  72 method::playToBundle
  73 adds all playing osc messages to the bundle. the bundle should support the message strong::.add::
  74
  75 Examples::
  76
  77 code::
  78 Server.default = s = Server.internal;
  79 s.boot;
  80 s.scope(16);
  81
  82 { Out.ar(87, SinOsc.ar(MouseX.kr(40, 10000, 1) * [1, 2, 3], 0, 0.2)) }.play;
  83 x = Monitor.new;
  84 x.play(87, 3, 1, 2);
  85 x.out = 0;
  86 x.stop(3.0);
  87 x.play(87, 1, 0, 1); // in > out : now mixes down (wrapping)
  88 x.play(89, 1, 0, 2); // in < out : now distributes to 2 channels
  89 x.stop;
  90
  91 // multiple play
  92 x.play(87, 1, 0, 2, multi:true);
  93 x.play(88, 1, 0, 2, multi:true);
  94 x.play(89, 1, 0, 2, multi:true);
  95 x.stop;
  96 ::
  97
  98 subsection::multichannel playing
  99
 100 code::
 101 // examples: args are // outs, amps, ins, vol, fadeTime
 102
 103
 104 (       x.playN(
 105                 [0, 1, 4],              // to these outs
 106                 [0.1, 0.4, 0.3],        // with these volumes
 107                 [87, 88, 89]            // from these ins
 108         );
 109 )
 110 (
 111         x.playN(
 112                 [0, [1, 3, 2], 4],              // outs can be nested: 87 -> 0, 88 -> [1, 3, 2], 89 -> 4
 113                 [0.1, [0.4, 0.2, 0.1], 0.3],    // with nested volumes 0.1, [0.4, 0.2, 0.1], and 0.3
 114                 [87, 88, 89]);                  // reading from these ins
 115 )
 116                 // can also set global volume and fadetime
 117         x.playN(vol: 0.0, fadeTime:4);
 118 ::