HelpSource/Classes/SoundIn.schelp

   1 class:: SoundIn
   2 summary:: Read audio from hardware inputs
   3 categories:: UGens>InOut
   4 related:: Classes/In, Classes/ServerOptions
   5
   6 description::
   7 SoundIn is a convenience UGen to read audio from the input of your computer or soundcard. It is a wrapper link::Classes/UGen:: based on link::Classes/In::, which offsets the index such that 0 will always correspond to the first input regardless of the number of inputs present.
   8
   9 note::
  10 On Intel based Macs, reading the built-in microphone or input may require creating an aggregate device in AudioMIDI Setup.
  11
  12 code::"open -a 'Audio MIDI Setup'".unixCmd; // execute this to launch it::
  13 ::
  14
  15 classmethods::
  16 method:: ar
  17
  18 argument:: bus
  19 the channel (or array of channels) to read in. These start at 0, which will correspond to the first audio input.
  20
  21 argument:: mul
  22
  23 argument:: add
  24
  25 examples::
  26 code::
  27 // world's most expensive patchcord (use headphones to avoid feedback)
  28 { SoundIn.ar(0) }.play;
  29
  30 // stereo version
  31 { SoundIn.ar([0, 1]) }.play;
  32
  33 // scope input; silent output
  34 Server.internal.boot;
  35 { Amplitude.kr(SoundIn.ar(0)); }.scope;
  36 ::