HelpSource/Classes/SplayAz.schelp

   1 class:: SplayAz
   2 summary:: Spreads an array of channels across a ring of channels
   3 categories:: UGens>Multichannel>Panners
   4 related:: Classes/Splay, Classes/SplayZ
   5
   6 description::
   7 SplayAz spreads an array of channels across a ring of channels.
   8 Optional spread and center controls, and levelComp(ensation) (equal power).
   9 numChans and orientation are as in link::Classes/PanAz::.
  10
  11 classmethods::
  12
  13 method:: ar
  14 argument:: numChans
  15 argument:: inArray
  16 argument:: spread
  17 argument:: level
  18 argument:: width
  19 argument:: center
  20 argument:: orientation
  21 argument:: levelComp
  22
  23 method:: arFill
  24 argument:: numChans
  25 argument:: n
  26 argument:: function
  27 argument:: spread
  28 argument:: level
  29 argument:: width
  30 argument:: center
  31 argument:: orientation
  32 argument:: levelComp
  33
  34 examples::
  35 code::
  36 (
  37 x = { arg spread=1, level=0.2, width=2, center=0.0;
  38  SplayAz.ar(
  39   4,
  40   SinOsc.ar( { |i| LFNoise2.kr( rrand(10, 20), 200, i + 3 * 100) } ! 10),
  41   spread,
  42   level,
  43   width,
  44   center
  45  );
  46 }.scope;
  47 )
  48
  49 x.set(\spread, 1,   \center, 0);  // full n chans
  50 x.set(\spread, 0.5, \center, -0.25); // less wide
  51 x.set(\spread, 0, \center, 0);  // mono center (depends on orientation, see PanAz)
  52 x.set(\spread, 0, \center, -0.25); //
  53 x.set(\spread, 0.0, \center, 0.5); // mono, but rotate 1 toward the higher channels
  54 x.set(\spread, 0.5, \center, 0.5); // spread over the higher channels
  55 x.set(\spread, 0,   \center, -0.25); // all on first channel
  56 x.set(\spread, 1,   \center, 0);  // full n chans
  57
  58 x.free;
  59
  60  // the same example written with arFill:
  61 (
  62 x = { arg spread=1, level=0.5, width=2, center=0.0;
  63  SplayAz.arFill(
  64   4,
  65   10,
  66   { |i| SinOsc.ar( LFNoise2.kr( rrand(10, 20), 200, i + 3 * 100) ) },
  67   spread,
  68   level,
  69   width,
  70   center
  71  );
  72 }.scope;
  73 )
  74
  75  // or with mouse control
  76 (
  77 x = { var src;
  78  src = SinOsc.ar( { |i| LFNoise2.kr( rrand(10, 20), 200, i * 100 + 400) } ! 10);
  79  SplayAz.ar(4, src, MouseY.kr(1, 0), 0.2, center: MouseX.kr(-1, 1));
  80 }.scope;
  81 )
  82
  83 // test for correct behavior:
  84         // only on chan 0
  85 { SplayAz.ar(4, SinOsc.ar * 0.2, orientation: 0) }.scope;
  86
  87         //  on chan 0, 3, i.e. equally around the ring
  88 { SplayAz.ar(6, SinOsc.ar([2, 3] * 200) * 0.2, orientation: 0) }.scope;
  89
  90         // equal spread on 0, 2, 4
  91 { SplayAz.ar(6, SinOsc.ar([2, 3, 5] * 200) * 0.2, orientation: 0) }.scope;
  92
  93
  94         // wrong behavior of SplayZ:
  95                 // plays on chan 2, but should play on 0
  96 { SplayZ.ar(4, SinOsc.ar * 0.2, orientation: 0) }.scope;
  97
  98         //  wrong: mixes both to chan 2,
  99         // because pan values [-1, 1] are the same pos on the ring
 100 { SplayZ.ar(6, SinOsc.ar([2, 3] * 200) * 0.2, orientation: 0) }.scope;
 101
 102         // wrong equal spread to pan values [-1, 0, 1], which outputs to chans 2, 0, 2
 103 { SplayZ.ar(6, SinOsc.ar([2, 3, 5] * 200) * 0.2, orientation: 0) }.scope;
 104 ::