A UGen that replace the contents of a bus with an input signal. Other than Out , the signal is not added to the previous contents of the bus but replaces it, allowing for a simple way of an "insert" effect.

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

// insert-effect
val noise = play {
  Out.ar(0, WhiteNoise.ar(Seq(0.1, 0.1)))
}

val filter = play(target = noise, addAction = addAfter) {
  val in = In.ar(0, 2)
  val f  = Resonz.ar(in, 444, 0.1) * 20
  ReplaceOut.ar(0, f)
}

filter.run(false)  // bypass
filter.run(true )  // engage