HelpSource/Classes/PanAz.schelp

   1 class:: PanAz
   2 summary:: Azimuth panner
   3 related:: Classes/Balance2, Classes/LinPan2, Classes/Pan2, Classes/Pan4
   4 categories::  UGens>Multichannel>Panners
   5
   6
   7 Description::
   8
   9 Multichannel equal power panner.
  10
  11
  12 classmethods::
  13
  14 method::ar, kr
  15
  16 argument::numChans
  17
  18 Number of output channels.
  19
  20
  21 argument::in
  22
  23 The input signal.
  24
  25
  26 argument::pos
  27
  28 pan position. Channels are evenly spaced over a cyclic period of
  29 2.0 in pos with 0.0 equal to channel zero and 2.0/numChans equal
  30 to channel 1, 4.0/numChans equal to channel 2, etc.
  31
  32
  33 Thus all channels will be cyclically panned through if a sawtooth
  34 wave from -1 to +1 is used to modulate the pos.
  35
  36
  37 argument::level
  38
  39 A control rate level input.
  40
  41
  42 argument::width
  43
  44 The width of the panning envelope. Nominally this is 2.0 which
  45 pans between pairs of adjacent speakers. Width values greater
  46 than two will spread the pan over greater numbers of speakers.
  47 Width values less than one will leave silent gaps between
  48 speakers.
  49
  50
  51 argument::orientation
  52
  53 Should be zero if the front is a vertex of the polygon. The first
  54 speaker will be directly in front. Should be 0.5 if the front
  55 bisects a side of the polygon. Then the first speaker will be the
  56 one left of center.
  57
  58
  59 Examples::
  60
  61 code::
  62
  63 // five channel circular panning
  64 Server.internal.boot;
  65 (
  66 {
  67         PanAz.ar(
  68                 5,                              // numChans
  69                 ClipNoise.ar,   // in
  70                 LFSaw.kr(MouseX.kr(0.2, 8, 'exponential')), // pos
  71                 0.5,                    // level
  72                 3                       // width
  73         );
  74 }.play(Server.internal);
  75 Server.internal.scope;
  76 )
  77
  78 ::
  79