A UGen that writes a signal onto a bus. It adds ("mixes") the input-signal to the existing contents of the bus.

Multi-channel input signals, for example a PanAz , are written as such to the bus without expansion. That is, the bus index argument is used for the first channel, the second channel will appear on bus + 1 , etc.

If you have an expanding multi-channel input, however, you have to be careful. For example, if you have PanAz.ar(2, SinOsc.ar(Seq(444, 555, 666)) * 0.2, Seq(-1, 0, 1)) , this results in one output UGen carrying one channel, and another one carrying two channels. (The way this works is consistent with SCLang). In order to get the correct behaviour (left outputs of the PanAz summed, and right output of the PanAz summed), wrap this expression in a Mix(...) before passing it to the output UGen.

Examples

// cross-synth routing
// allocate an internal stereo audio-bus
val bus = Bus.audio(s, 2)

// writes to internal bus (initially inaudible)
val x = play {
  Out.ar(bus.index, Dust.ar(Seq(345, 345)))
}

// reads internal bus and makes it audible.
// must be after `x` to be able to read the bus signal
val y = play(target = x, addAction = addAfter) {
  val in = In.ar(bus.index, 2)
  Resonz.ar(in, 555, 0.1) * 10
}

// when done, do not forget to free the bus
y.free(); x.free(); bus.free()