HelpSource/Classes/NumChannels.schelp

   1 class:: NumChannels
   2 summary:: Ensures the number of output channels
   3 categories:: UGens>Multichannel
   4
   5 Description::
   6 Ensures the output has the stated number of channels, regardless of the number of input channels.
   7
   8 classmethods::
   9
  10 method:: ar
  11 argument:: input
  12 the audio signal
  13 argument:: numChannels
  14 an integer
  15 argument:: mixdown
  16 true/false, whether you want to mixdown or just use the first channel
  17
  18 discussion::
  19 Mono input is copied.
  20 Multi-channels clumped and if code::mixdown:: is true mixed down, else the first channel used.
  21
  22 Examples::
  23 code::
  24 (
  25 {
  26         NumChannels.ar(
  27                 SinOsc.ar(100,0,0.2), // 1 becomes 2
  28                 2)
  29 }.play
  30 )
  31
  32 (
  33 {
  34         NumChannels.ar(
  35                 SinOsc.ar([100,200,300],0,0.2), // 3 becomes 2
  36                 2)
  37 }.play
  38 )
  39
  40 (
  41 {
  42         NumChannels.ar(
  43                 SinOsc.ar([100,200,300,100],0,0.2), // 4 becomes 2
  44
  45                 2)
  46 }.play
  47 )
  48 ::
  49