HelpSource/Tutorials/Mark_Polishook_tutorial/09_Buses.schelp

   1 title:: 09_Buses
   2 summary:: Mark Polishook tutorial
   3 categories:: Tutorials>Mark_Polishook_tutorial
   4 related:: Tutorials/Mark_Polishook_tutorial/00_Introductory_tutorial
   5
   6
   7 By default, SuperCollider has 128 buses for audio signals and 4096 for control signals. The buses, which are items in an array, are what SuperCollider uses to represent audio and control rate data.
   8
   9 ////////////////////////////////////////////////////////////////////////////////////////////////////
  10
  11 code::
  12 // the array of audio buses (channels)
  13 [ channel0, channel1, channel2, channel3, channel4, ... , ..., ..., etc., ... channel127 ]
  14
  15 // the array of control buses (channels)
  16 [ channel0, channel1, channel2, channel3, channel4, ... , ..., ..., etc., ... channel4095 ]
  17 ::
  18
  19 section::Placing audio into a bus
  20
  21 Use an Out ugen at the audio rate to put data into an audio bus.
  22
  23 code::
  24 (
  25 SynthDef("dataForABus", {
  26         Out.ar(
  27                 0,              // write 1 channel of audio into bus 0
  28                 Saw.ar(100, 0.1)
  29         )
  30 }).add;
  31 )
  32
  33 Synth("dataForABus");
  34 ::
  35
  36 A SynthDef browser
  37
  38 code::
  39 (
  40 SynthDescLib.global.read;
  41 SynthDescLib.global.browse;
  42 )
  43 ::
  44
  45 shows 1 channel of output on channel 0.
  46
  47 section::Getting audio from a bus
  48
  49 Send an .ar message to an In ugen to get data from an audio bus.
  50
  51 code::
  52 (
  53 SynthDef("dataFromABus", {
  54         Out.ar(
  55                 0,
  56                 [       // the left channel gets input from an audio bus
  57                         In.ar(0, 1),
  58                         SinOsc.ar(440, 0.2)
  59                 ]
  60         )
  61 }).add;
  62 )
  63
  64 (
  65 Synth("dataForABus");   // synthesize a sawtooth wave on channel 0
  66 Synth("dataFromABus");  // pair it with a sine wave on channel 1
  67 )
  68 ::
  69
  70 section::Control rate buses
  71
  72 Use code::In.kr:: and code::Out.kr:: to read from or write to control buses.
  73
  74 ////////////////////////////////////////////////////////////////////////////////////////////////////
  75
  76 For additional information, see the link::Classes/Out::, link::Classes/In::, and link::Classes/Bus:: files in the SuperCollider help system.
  77
  78 ////////////////////////////////////////////////////////////////////////////////////////////////////
  79
  80 go to link::Tutorials/Mark_Polishook_tutorial/10_Controls::